Re: [Docutils-users] Best way to install docutils extensions

[David G. <go...@py...>]

On Thu, Oct 1, 2009 at 15:12, Ulrik Sverdrup <ulr...@gm...> wrote:
> What is the best way to install extensions to docutils, where
> extensions are custom directives and roles (for example, the pygments
> source code highlighting directive)?

I recommend writing a wrapper script, a custom version of the tool
you're using (rst2html.py etc.), which does the importing and
registering of your custom code. See the sandbox for some examples.

> It does not seem like the docutils configuration files allow pointing
> to any python script to be read for customizations.

Docutils doesn't have a plugin mechanism, because once you allow
user-specific extensions to the reST markup, those documents are
suddenly non-portable. This is unlike the Firefox/Emacs/etc.
applications that accept plugins: their underlying documents aren't
affected by plugins, it's only the interface and application
functionality that changes.

I would rather encourage extension developers to work toward getting
their code into the Docutils core.

Sphinx may have a plugin mechanism (don't know).

-- 
David Goodger <http://python.net/~goodger>