如何使用RST和Sphinx包含文件目录

Question

我正在尝试编写文档，并希望并拥有多个toc树使用的多个文件。以前我使用.. include:: <isonum.txt>的空文件，但这对于子目录的目录中的多个文件不起作用。我使用的另一个解决方案是使用我链接到的索引文件的相对文件路径。然而，这会扰乱狮身人面像导航树。所以我的问题是如何使用RST和Sphinx包含文件目录？

Answer 1

不幸的是，它无法完成。

toctree指令有.. toctree:: :glob: generated/* 选项，您可以这样使用：

if (y + 1 <= (Width / TileWidth) && !Ar[x, y + 1].HasBeenVisited)

但include指令中没有此选项。

也许为它开始一个问题？

Answer 2

也许用注释（.. START_GLOB_INCLUDE 等）指示文件应该去的部分的开始和结束，然后有一个构建预处理步骤，找到您想要的文件并重写该部分主文件。