Configurando construtores¶
Descubra construtores por ponto de entrada¶
Adicionado na versão 1.6.
As extensões de construtores podem ser descobertas por meio de pontos de entrada de modo que não tenham que ser listadas no valor de configuração extensions
.
Builder extensions should define an entry point in the "sphinx.builders"
group. The name of the entry point needs to match your builder’s
name
attribute, which is the name passed to the
sphinx-build -b
option. The entry point value should equal the
dotted name of the extension module. Here is an example of how an entry point
for ‘mybuilder’ can be defined in the extension’s pyproject.toml
[project.entry-points."sphinx.builders"]
mybuilder = "my.extension.module"
Observe que ainda é necessário registrar o construtor usando add_builder()
na função setup()
da extensão.