[Docutils-users] roles

[Jeffrey C. J. <tim...@py...>]

Hello and thanks to David,

Question: how do I use custom roles.  I noticed canonically I need to 
subclass Inliner but in a product like ZReST this could be a lot of hassle 
that I'd like to avoid.  Instead, is there a way to define custom roles 
within a document.  For instance, in my novel I use:

``She wore ribbons in her hair and it lay with streaks of grey``:rewrite:

The idea here being that I have contributed a sentence but I am not happy 
with the phraseology at the moment and have left a not to myself to 
rewrite it.  It would then be nice to have a directive like:

.. :rewrite: font-color:: red

Or something like that, which as you might guess means: for any text with 
a role of "rewrite", render it in the colour red.  A substitution would 
not work for me because I sometimes have entire paragraphs I want to mark 
for rewrite and typing substitution references out of context would make 
the ReST doc hard to read.  So what's the deal on roles?  I know :sub: and 
:sup: are proposed, but could we allow document-defined roles?  This 
seemed to be implied in the current specification.  TIA!

Jeffrey.