配置构建器¶
通过入口点发现构建器¶
在 1.6 版本加入.
可以通过 entry points 来找到 builder 扩展,因此不必在 extensions 配置值中列出它们。
构建器扩展应在 "sphinx.builders" 组中定义一个入口点函数。入口点的名称需要与 构建器的 name 属性匹配,该属性是传递给 sphinx-build --builder 选项的名称。入口点的值应等于扩展模块的点分名称。以下是如何在 pyproject.toml 中定义'mybuilder'扩展的入口点的示例
[project.entry-points."sphinx.builders"]
mybuilder = "my.extension.module"
注意,仍然需要在扩展程序的 setup() 函数中使用 add_builder() 注册构建器。