包括索引toctree中子目录中的toctree

Question

我要记录的项目结构如下：

/top
Index.rst
     /a
     toctree_a.rst (contains doc and doc2)
     doc.rst
     doc2.rst
     /b
     toctree_b.rst (contains doc4 and doc3)
     doc3.rst
     doc4.rst

我想引用子目录(a和b)中的toctree，以便项目toctree可以看到项目树中的4个文档。

当文档位于一个目录中时，我知道如何执行此操作，但如果将文档放在子目录中，则不知道如何执行此操作。我正在尝试保持项目结构的完整性，而不必将所有文件移动到一个目录中。我做了一些研究，发现.. include:: directive可能是可行的方法，但我不知道如何正确使用它。

Answer 1

您可以告诉index.rst中的toctree从子目录中获取文件，如下所示：

内容：

.. toctree::
   :maxdepth: 2

    a/doc
    a/doc2
    b/doc3
    b/doc4

该方法的工作方式就像它们在同一目录中一样