"python setup.py build_sphinx“和"sphinx-apidoc -隐式命名空间”

Question

sphinx支持选项-隐式名称空间来根据PEP420处理命名空间包。当我用"python setup.py build_sphinx“创建狮身人面像文档时，默认情况下，这并不适用于命名空间包。"python setup.py build_sphinx“和sphinx之间是否有关系(例如，在运行"python setup.py build_sphinx”时，sphinx是否在某个地方隐式调用？)如果是这样的话，我是否可以专门说明"python setup.py build_sphinx“应该考虑斯芬克斯-apidoc的隐式名称空间选项？

Answer 1

通过查看“sphinx”的输出，我了解了生成文档的三个步骤：

1. 使用conf.py和index.rst创建初始目录结构的“sphinx-快速启动”
2. "sphinx-apidoc“生成*.rst文件，这些文件也可以进一步修改。
3. "make html“或"sphinx-build”或"python setup.py build_sphinx“或"devpi上载-with-docs”，以从*.rst文件生成HTML。

因此，“sphinx”并不是由"python setup.py build_sphinx“隐式调用的，但两者都必须一个接一个地调用。