"python setup.py build_sphinx" и "sphinx-apidoc --implicit-namespaces"

Question

sphinx-apidoc поддерживает опцию --implicit-namespaces для обработки пакетов пространства имен в соответствии с PEP420. Когда я создаю документацию Sphinx с помощью "python setup.py build_sphinx", это не работает с пакетами пространства имен по умолчанию. Есть ли связь между "python setup.py build_sphinx" и sphinx-apidoc (например, sphinx-apidoc неявно вызывается где-то, когда запускается "python setup.py build_sphinx"?)? Если да, могу ли я как-то указать, что "python setup.py build_sphinx" должен учитывать параметр --implicit-namespaces в 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" для генерации HTML из файлов *.rst

Таким образом, "sphinx-apidoc" неявно вызывается "python setup.py build_sphinx", но оба должны вызываться один за другим.