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