From: Peter M. <pe...@mo...> - 2009-12-22 22:56:38
|
When you have created a custom role as per http://docutils.sourceforge.net/docs/howto/rst-roles.html how do you persuade docutils to use it? I can add the role code to the docutils/roles.py (where ir works fine). But I assume that is not the correct way. Thanks, Peter |
From: David G. <go...@py...> - 2009-12-23 01:51:25
|
On Tue, Dec 22, 2009 at 17:56, Peter Mott <pe...@mo...> wrote: > When you have created a custom role as per > http://docutils.sourceforge.net/docs/howto/rst-roles.html how do you > persuade docutils to use it? I can add the role code to the > docutils/roles.py (where ir works fine). But I assume that is not the > correct way. There is no place to put a custom role. You should write a custom front-end tool that defines and registers the role. For example, copy and modify tools/rst2html.py. BTW, are you certain you need to write a custom role? The "role" directive combined with a CSS style is enough for many applications (http://docutils.sourceforge.net/docs/ref/rst/directives.html#custom-interpreted-text-roles). -- David Goodger <http://python.net/~goodger> |
From: Peter M. <pe...@mo...> - 2009-12-23 10:54:04
|
David Goodger wrote: > On Tue, Dec 22, 2009 at 17:56, Peter Mott <pe...@mo...> wrote: > >> When you have created a custom role as per >> http://docutils.sourceforge.net/docs/howto/rst-roles.html how do you >> persuade docutils to use it? I can add the role code to the >> docutils/roles.py (where ir works fine). But I assume that is not the >> correct way. >> > > There is no place to put a custom role. You should write a custom > front-end tool that defines and registers the role. For example, copy > and modify tools/rst2html.py. > > BTW, are you certain you need to write a custom role? The "role" > directive combined with a CSS style is enough for many applications > (http://docutils.sourceforge.net/docs/ref/rst/directives.html#custom-interpreted-text-roles). > > Thanks David. Often when learning a new system I find that I mis-locate errors. I had in fact used my custom role correctly. My mistake was to call the role "dots 10" . Of course "A role name is a single word ... no whitespace ... " . However above that sentence is the expression " ... implicitly (as above; the "default role" is used) ... " and I misdirected myself to :default role:`my title` . As to your second point, I really don't know. My custom role puts 10 '.' after the interpeted text. But actually I am semi-retired and using ReST and docutils for fun. I hope it is still legitimate to ask questions :-). -- Peter |
From: David G. <go...@py...> - 2009-12-23 17:27:48
|
> David Goodger wrote: >> BTW, are you certain you need to write a custom role? The "role" >> directive combined with a CSS style is enough for many applications >> (http://docutils.sourceforge.net/docs/ref/rst/directives.html#custom-interpreted-text-roles). On Wed, Dec 23, 2009 at 05:53, Peter Mott <pe...@mo...> wrote: > As to your second point, I really don't know. My custom role puts 10 '.' > after the interpeted text. I believe that is possible with CSS2 generated content: http://www.w3.org/TR/CSS21/generate.html. Not sure what the state of browser support for CSS2 is though. > But actually I am semi-retired and using ReST and > docutils for fun. I hope it is still legitimate to ask questions :-). Of course! I built it for fun. -- David Goodger <http://python.net/~goodger> |