控制 sphinx 生成的 .rst 文件的保存位置

Mat*_*ieu 5 python python-sphinx autodoc

假设 sphinx 的文档结构如下:

doc
 |_ _static
 |_ _templates
 |_ api
     |_ index.rst
     |_ classes.rst
     |_ functions.rst
 |_ index.rst
 |_ more_functions.rst
 |_ conf.py
Run Code Online (Sandbox Code Playgroud)

并且classes.rstfunctions.rst并且more_functions.rst具有可以使用 来自动记录的类和函数autodoc/autosummary。构建将为.rst这些类和函数生成文件:

  • doc/generated为了more_functions.rst
  • doc/api/generated对于classes.rstfunctions.rst

有没有办法控制这些generated文件夹的创建位置?


我试图generated最终获得一个独特的文件夹。在这种情况下,采用以下结构:

doc
 |_ generated
     |_ generated-from-more-functions.rst
     |_ api
         |_ generated-from-api/classes.rst
         |_ generated-from-api/functions-rst
Run Code Online (Sandbox Code Playgroud)

Sys*_*ma_ 1

我不认为sphinx.

实现这一目标的最快方法是创建一个 shell 脚本来运行构建,然后根据您的需要移动(使用mvrm如果您使用的是 gnu/linux)文件。