用于rst和html的Sphinx目录结构生成

python-sphinx autodoc

277 观看

1回复

62 作者的声誉

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

例如,我的python文件的相对路径为:python / common / element.py; 生成的第一个文件是:python.common.element.rst; 与html相同。我希望它形成与py文件相同的目录结构,例如:sphinx / _build / rst / python / common / element.rst&sphinx / _build / html / python / common / element.html

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

作者: Akshay Shah 的来源 发布者: 2017 年 9 月 15 日

回应 1


0

6851 作者的声誉

决定

否。源目录和构建目录必须分开。请参阅的选项sphinx-build

您可以编写脚本以对输出进行后处理,将文件从构建目录移动到另一个目录。

作者: Steve Piercy 发布者: 2017 年 9 月 15 日
32x32