配置生成器¶
按入口点发现构建器¶
Added in version 1.6.
builder 扩展可以通过以下方式发现 entry points 这样就不必在 extensions
配置值。
生成器扩展应该在 "sphinx.builders"
一群人。入口点的名称需要与构建器的名称匹配 name
属性,该属性是传递给 sphinx-build -b
选择。入口点值应等于扩展模块的虚线名称。下面是一个如何在扩展的 pyproject.toml
[project.entry-points."sphinx.builders"]
mybuilder = "my.extension.module"
请注意,仍然需要使用 add_builder()
在分机里 setup()
功能。