On 2011-03-28, Viktoras wrote:
> Hello,

> I want to make a couple template todos and use them throughout 
> unfinished documentation, something like:

> .. |incomplete| todo:: Unfinished documentation.

> .. |pending| todo:: Documentation below is covering  a broken or incomplete 
> feature.

> ..and use them throughout documentation to mark places that need 
> attention later in the development process. However, sphinx won't allow 
> such markup (or is it a docutils issue?):

The allowed substitutions are limited. See
http://docutils.sourceforge.net/docs/ref/rst/directives.html#directives-for-substitution-definitions

You might try

.. |incomplete| replace:: .. todo:: Unfinished documentation.

(assuming todo is a valid directive). But I am not sure directives are
allowed in the replacement part, so the save bet is something like

.. |incomplete| replace:: **TODO:** Unfinished documentation.


Günter

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to