設定建構器¶

透過進入點探索建構器¶

在版本 1.6 中新增。

建構器擴展可以透過進入點的方式探索，因此它們不必列在 extensions 設定值中。

建構器擴展應在 "sphinx.builders" 群組中定義一個進入點。進入點的名稱需要與您的建構器的 name 屬性相符，該屬性是傳遞給 sphinx-build --builder 選項的名稱。進入點值應等於擴展模組的點狀名稱。以下是如何在擴展的 pyproject.toml 中定義 'mybuilder' 的進入點範例

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

請注意，仍然需要使用 add_builder() 在擴展的 setup() 函數中註冊建構器。