[Doc-SIG] "role" directive added to reStructuredText

David Goodger goodger at python.org
Sat Apr 17 21:42:07 EDT 2004


Just added to the Docutils codebase: a "role" directive that creates
a custom interpreted text role and registers it with the parser.
This input:

     .. role:: custom

     some :custom:`text`

parses to this (internal pseudo-XML):

     <paragraph>
         some
         <inline class="custom">
             text

It produces the following HTML:

     some <span class="custom">text</span>

The directive is a simple initial implementation that may be expanded
in the future, as requirements become known/clear.

Details here: http://docutils.sf.net/spec/rst/directives.html#role
CVS snapshot: http://docutils.sf.net/docutils-snapshot.tgz

-- 
David Goodger                               http://python.net/~goodger
For hire: http://python.net/~goodger/cv



More information about the Doc-SIG mailing list