配置生成器

按入口点发现构建器

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() 功能。