Dołącz TOC innej strony w Sfinksa

Question

Mam następującą stronę w plugins/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` 

plugin/Podstawy/index.html i plugins/zaawansowany/index.html zawierają własne toctree, który linku na te same podstrony wymienione w pluginach/index.html. Zastanawiam się, czy istnieje sposób na włączenie tych subtoctree, zamiast ręcznego wymieniania podstron, tak jak ja?

Zdaję sobie sprawę, że może po prostu usunąć: Ukryte: flagę z toctree, ale chodzi o to, chcę zachować podstawowy/zaawansowany tematów na oddzielnych listach, z własnymi pozycjami, pkt intro itp

Answer 1

można wymienić całą zawartość katalogów tak (lub różne kombinacje tych dyrektyw):

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

    ** 

lub myślę też tak (niesprawdzone):

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

    * 
    basics/* 
    advanced/* 

Ho Wever, znalazłem tylko ręcznie listę rzeczy jest często najlepszym sposobem, aby przejść. Chociaż wygenerowane automatycznie TOC-y są ładne, nie pozwalają na wiele miejsca pod względem formatowania (na przykład tworzenie pod-nagłówków i zmiana kolejności stron itp.).

W naszej dokumentacji zrobiłem prawie to samo, co w początkowym pytaniu.