mitsuhiko/rstblog — Issue #19: Add the ability to add custom directives
Author: espeed
Created: 2012-01-27 11:19:03+00:00
State: open

With Sphinx you can use custom directives, which allow you to do things like include social buttons under the page heading (something that's not directly editable in templates).

To use a custom directive in Sphinx, you include it in your conf.py extensions list (https://bitbucket.org/birkenfeld/sphinx/src/52ee02818d19/doc/conf.py).

You put the custom directives in a module in your _ext directory (next to the_template dir), and then the Sphinx Config class complies conf.py (https://bitbucket.org/birkenfeld/sphinx/src/52ee02818d19/sphinx/config.py#cl-184).

This simple change would make rstblog extendable without having to fork the code.