生成的第一个和 html 的 Sphinx 目录结构

Question

我一直致力于为我的 Python 文件设置自动文档，这些文件位于大型目录结构层次结构中。我能够使用我的脚本和使用 autodoc 模块为所有这些文件生成 rst 和 html 文件。我想知道是否可以在与我的 Python 文件相同的目录 structure/hierarchy 中生成 rst 和 html 文件。

例如，我的python文件的相对路径是：python/common/element.py； 生成的第一个文件是：python.common.element.rst； html 也一样。 我希望它形成与 py 文件相同的目录结构，例如： 狮身人面像/_build/rst/python/common/element.rst & sphinx/_build/html/python/common/element.html

PS：我正在研究 ubuntu-14.04 和 Sphinx-1.6.3

Answer 1

没有。源目录和构建目录必须分开。见 options to sphinx-build.

您可以编写一个脚本来 post 处理输出，将文件从构建目录移动到另一个目录。