獅身人面像 - 從指數子目錄包含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 

我想引用在子目錄的toctrees（A和B），因此該項目toctree可以看到項目樹中的4個文件。我知道當文檔位於一個目錄中時如何做到這一點，但如果我將它們放在子目錄中，我不知道該如何做到這一點。我試圖保持我的項目結構完整無需將所有文件移動到一個目錄中。我做了一些研究，發現include include指令可能是要走的路線，但我無法弄清楚如何正確使用它。謝謝你的幫助！

Answer 1

你可以告訴你toctree在index.rst從子目錄中獲取文件像這樣：

內容：

.. toctree:: 
    :maxdepth: 2 

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

這種方法的工作原理就像他們會在同目錄