Includere ToC di un'altra pagina nella Sfinge

Question

ho la seguente pagina in 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/basi/index.html e plugins/avanzate/index.html contengono del proprio toctree, che collegano alle stesse sottopagine elencate in plugins/index.html. Quindi, quello che mi chiedo è, c'è un modo per includere solo quei sotto-quadri, piuttosto che elencare manualmente le pagine secondarie come sto facendo?

mi rendo conto che ho potuto solo rimuovere il: nascosto: la bandiera dal toctree, ma il punto è che voglio continuare a base/argomenti avanzati in liste separate, con le loro intestazioni, paragrafi intro, ecc

Answer 1

si possono elencare l'intero contenuto della directory come questo (o varie combinazioni di queste direttive):

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

    ** 

o credo anche come questo (non testato):

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

    * 
    basics/* 
    advanced/* 

ho Tuttavia, ho trovato solo elencare manualmente le cose è spesso il modo migliore per andare. Mentre i TOC generati automaticamente sono belli, non ti lasciano molto spazio in termini di formattazione (ad esempio, creando sottotitoli e cambiando l'ordine delle pagine, ecc.).

Nella nostra documentazione ho praticamente fatto la stessa cosa che hai fatto nella domanda iniziale.