生成rst和html的Sphinx目录结构

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

例如，我的python文件的相对路径是：python/common/element.py; 生成的第一个文件是：python.common.element.rst; 和html相同。我希望它形成相同的目录结构对于P的文件，如：斯芬克斯/ _build/RST /蟒蛇/普通/ element.rst &斯芬克斯/ _build/HTML /蟒蛇/普通/ element.html

PS：我正在使用ubuntu-14.04和Sphinx-1.6.3

来源

2017-09-15 Akshay Shah

否。源和目录必须是分开的。请参阅options to sphinx-build。

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

来源

2017-09-15 06:27:11

很明显，源代码和编译目录会有所不同。但我的问题是在构建目录本身内部执行它。无论如何，我会为此编写一个脚本，在sphinx-build之后移动和排列文件。 –

答案仍然是否定的，因为每个输出格式在构建目录中都有自己的子目录。后处理脚本是您唯一的选择。 –

生成rst和html的Sphinx目录结构

回答

相关问题