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.

extend_excludes_for_non_index_source(...[, ...])

Extend the exclude_patterns configuration to include files with a specific extension that aren't the index file.

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

The root model for a documenteer.toml configuration file.

ProjectModel

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

PythonPackageModel

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

OpenApiDocsModel

Model for OpenAPI documentation configurations in documenteer.toml.

OpenApiGeneratorModel

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

SphinxModel

Model for Sphinx configurations in documenteer.toml.

IntersphinxModel

Model for Intersphinx configurations in documenteer.toml.

LinkCheckModel

Model for linkcheck builder configurations in documenteer.toml.

ThemeModel

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