配置构建器¶

通过入口点发现构建器¶

添加于 1.6 版本。

构建器扩展可以通过入口点发现，这样它们就不必列在 extensions 配置值中。

构建器扩展应在 "sphinx.builders" 组中定义一个入口点。入口点的名称需要与构建器的 name 属性匹配，该属性是传递给 sphinx-build --builder 选项的名称。入口点值应等于扩展模块的点分名称。以下是如何在扩展的 pyproject.toml 中定义 ‘mybuilder’ 的入口点的示例

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

请注意，仍然需要使用 add_builder() 在扩展的 setup() 函数中注册构建器。