build_package_configs

documenteer.sphinxconfig.stackconf.build_package_configs(project_name, version=None, copyright=None, doxygen_xml_dirname=None)

Builds a dict of Sphinx configurations useful for the doc/conf.py files of individual LSST Stack packages.

The doc/conf.py of packages can ingest these configurations via:

from documenteer.sphinxconfig.stackconf import build_package_configs

_g = globals()
_g.update(build_package_configs(
    project_name='afw',
    version=lsst.afw.version.__version__))

You can subsequently customize the Sphinx configuration by directly assigning global variables, as usual in a Sphinx config.py, e.g.:

copyright = '2016 Association of Universities for '
            'Research in Astronomy, Inc.'
Parameters:
project_name : str

Name of the package.

copyright : str, optional

Copyright statement. Do not include the ‘Copyright (c)’ string; it’ll be added automatically.

version : str

Version string. Use the __version__ member in a package’s version module.

doxygen_xml_dirname : str

Path to doxygen-generated XML, allowing C++ APIs to be documented through breathe. If not set, the breathe sphinx extension will not be enabled.

Returns:
c : dict

Dictionary of configurations that should be added to the conf.py global namespace via:

_g = global()
_g.update(c)