documenteer.conf#

documenteer.conf Package#

Functions#

get_asset_path(name)

Get the absolute path for a static asset contained in Documenteer's assets directory, for use with Sphinx's html_static_path.

extend_static_paths_with_asset_extension(...)

Extend a Sphinx html_static_path configuration list with the files of a given extension in Documenteer's assets directory.

get_template_dir(root)

Get the absolute path for a Documenteer template directory, for use with Sphinx's templates_path.

Classes#

DocumenteerConfig(conf)

Configuration from a documenteer.toml file.

Class Inheritance Diagram#

Inheritance diagram of documenteer.conf._toml.DocumenteerConfig

documenteer.conf._toml Module#

Parses a documenteer.toml configuration file to support documenteer’s configuration preset modules.

Classes#

ConfigRoot(**data)

The root model for a documenteer.toml configuration file.

ProjectModel(**data)

Model for the project table in the documenteer.toml file.

PythonPackageModel(**data)

Model for a Python package (i.e. built with pyproject.toml-compatible build system.

OpenApiDocsModel(**data)

Model for OpenAPI documentation configurations in documenteer.toml.

OpenApiGeneratorModel(**data)

Specification for the OpenAPI generator function used by the documenteer.ext.openapi Sphinx extension.

SphinxModel(**data)

Model for Sphinx configurations in documenteer.toml.

IntersphinxModel(**data)

Model for Intersphinx configurations in documenteer.toml.

LinkCheckModel(**data)

Model for linkcheck builder configurations in documenteer.toml.

ThemeModel(**data)

Model for theme configurations in documenteer.toml.

Class Inheritance Diagram#

Inheritance diagram of documenteer.conf._toml.ConfigRoot, documenteer.conf._toml.ProjectModel, documenteer.conf._toml.PythonPackageModel, documenteer.conf._toml.OpenApiDocsModel, documenteer.conf._toml.OpenApiGeneratorModel, documenteer.conf._toml.SphinxModel, documenteer.conf._toml.IntersphinxModel, documenteer.conf._toml.LinkCheckModel, documenteer.conf._toml.ThemeModel