atelier.sphinxconf

Sphinx extensions and a configure() function used to build the documentation trees maintained by us.

base	Basic extension
dirtables	Defines the directory, tickets_table and entry_intro directives.
refstothis	A Sphinx extension which adds the refstothis directive.
insert_input	Defines the InsertInputDirective class and some subclasses, installing the py2rst directive.
sigal_image	Defines the sigal_image directive.
complex_tables	Defines the textimage and complextable directives.
blog	This Sphinx extension defines the blogger_year and blogger_index directives.
interproject	Defines the atelier.sphinxconf.interproject.configure() function.

(This module’s source code is available here.)

Functions

configure(globals_dict)	Adds to your conf.py an arbitrary series of things that all my Sphinx docs configuration files have in common.
version2rst(self, m)	used in docs/released/index.rst

atelier.sphinxconf.configure(globals_dict)

Adds to your conf.py an arbitrary series of things that all my Sphinx docs configuration files have in common.

To be called from inside the Sphinx conf.py as follows:

from atelier.sphinxconf import configure
configure(globals())

Incomplete list of conf.py settings that will be set:

• extensions

• templates_path

• html_static_path

• master_doc=’index’

• source_suffix=’.rst’

• primary_domain=’py’

• pygments_style=’sphinx’

atelier.sphinxconf.version2rst(self, m)

used in docs/released/index.rst