配置构建器¶

通过切入点发现构建器¶

Added in version 1.6.

builder 可以通过以下方式发现扩展 entry points 这样他们就不必在 extensions 配置值。

生成器扩展应在 "sphinx.builders" 组入口点的名称需要与您的构建器的名称相匹配 name 属性，这是传递给 sphinx-build --builder 选项.入口点值应该等于扩展模块的虚线名称。以下是如何在扩展中定义“mybuilder”的入口点的示例 pyproject.toml

[project.entry-points."sphinx.builders"]
mybuilder = "my.extension.module"

请注意，仍然需要使用注册构建器 add_builder() 在扩展中 setup() 功能