包含另一個頁面的ToC的獅身人面像中

Question

我在插件/ index.html的以下頁面：

Plugin Development 
================== 

.. toctree:: 
    :hidden: 

    basics/index 
    advanced/index 


The Basics 
---------- 

- :doc:`basics/gettingstarted` 
- :doc:`basics/resources` 
- :doc:`basics/i18n` 


Advanced Topics 
--------------- 

- :doc:`advanced/models` 
- :doc:`advanced/controllers` 
- :doc:`advanced/services` 

插件/基礎/ index.html，然後插件/高級/ index.html中包含自己toctree的，哪個環節到plugins/index.html中列出的相同子頁面。所以我想知道的是，有沒有辦法只包含這些子控件，而不是像我在做的那樣手動列出子頁面？

我意識到，我可能只是刪除：隱藏：從toctree標誌，但問題是我要保持在單獨的列表基礎/進階的主題，用自己的標題，介紹段落等

Answer 1

您可以列出這樣整個目錄內容（或這些指令的各種組合）：

.. toctree:: 
    :glob: 
    :titlesonly: 
    :maxdepth: 2 

    ** 

或我想也是這樣（未經）：

.. toctree:: 
    :glob: 
    :titlesonly: 
    :maxdepth: 2 

    * 
    basics/* 
    advanced/* 

何無論如何，我發現只是手動列出東西往往是最好的辦法。雖然自動生成的TOC很好，但它們不允許您在格式方面有太多空間（例如，創建子標題，以及更改頁面順序等）。

在我們的文檔中，我已經完成了與您在最初的問題中所做的幾乎相同的事情。