包含另一个页面的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很好，但它们不允许您在格式方面有太多空间（例如，创建子标题，以及更改页面顺序等）。

在我们的文档中，我已经完成了与您在最初的问题中所做的几乎相同的事情。