doc8-custom-ignores 2026.7.29

Configure additional doc8 D000 ignores.

Configure additional doc8 D000 ignores in pyproject.toml.

Install

$ pip install doc8-custom-ignores

The plugin is discovered automatically by doc8.

Configure

Prefer exact messages:

[tool.doc8]
ignore-messages = [
    """Error in "include" directive:
unknown option: "path-substitutions".""",
]

Regular expressions are available when an exact message is not suitable:

[tool.doc8]
ignore-regex = [
    '''^Error in "include" directive:\nunknown option: "path-substitutions"\.$''',
]

Patterns use Python’s regular-expression syntax. Both settings follow doc8’s default behavior and are disabled by doc8 --no-sphinx.