rstgen.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 that 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 rstgen.sphinxconf.interproject.configure() function.

Functions

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

rstgen.sphinxconf.configure(globals_dict, project=None, conffiles=['default_conf.py'])

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

Usage: add the following two lines at the beginning of your conf.py:

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

Incomplete list of settings that will be set:

• templates_path

• extensions and extlinks are initialized but empty

• master_doc = ‘index’

• source_suffix = ‘.rst’

• primary_domain = ‘py’

• pygments_style = ‘sphinx’

• version and release from SETUP_INFO

• exclude_trees = [‘old’, ‘include’, ‘.build’]

• Fill the Synodalsoft doctrees into intersphinx_mapping

rstgen.sphinxconf.version2rst(self, m)

used in docs/released/index.rst