python-3.x - “python setup.py build_sphinx”和“sphinx-apidoc --implicit-namespaces”

Question

sphinx-apidoc 支持选项 --implicit-namespaces 来根据 PEP420 处理命名空间包。当我使用“python setup.py build_sphinx”创建 Sphinx 文档时，默认情况下这不适用于命名空间包。“python setup.py build_sphinx”和 sphinx-apidoc 之间是否存在关系（例如，当“python setup.py build_sphinx”运行时，sp​​hinx-apidoc 是否在某处隐式调用？）？如果是这样，我能否以某种方式指定“python setup.py build_sphinx”应考虑 sphinx-apidoc 的 --implicit-namespaces 选项？

Answer 1

查看“sphinx-quickstart”的输出向我展示了生成文档的 3 个步骤：

1. "sphinx-quickstart" 使用 conf.py 和 index.rst 创建初始目录结构
2. "sphinx-apidoc" 生成 *.rst 文件，也可以进一步调整
3. “make html”或“sphinx-build”或“python setup.py build_sphinx”或“devpi upload --with-docs”从 *.rst 文件生成 HTML

所以“sphinx-apidoc”不会被“python setup.py build_sphinx”隐式调用，而是必须一个接一个地调用。