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

Question

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

Answer 1

不幸的是，这是不可能的。

该toctree指令有一个glob选项，您可以像这样使用它：

.. toctree::
   :glob:

   generated/*

但该选项在指令中不可用include。

也许为此提出一个问题？