＆＃34; python setup.py build_sphinx＆＃34;和＆＃34; sphinx-apidoc - 隐藏命名空间＆＃34;

Question

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

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

因此，“python setup.py build_sphinx”不会隐式调用“sphinx-apidoc”，但必须一个接一个地调用它们。