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