Come espandere tutte le sottosezioni nel toctree della barra laterale in Sfinge

Question

Mi chiedevo se esiste un modo per espandere tutte le sottosezioni sotto le intestazioni incluse nel file index.rst?

Come esempio, ecco come è:

Section 1 
Section 2 
Section 3 

Ed ecco come vorrei che fosse:

Section 1 
    Subsection 1.1 
    Subsection 1.2 
    Subsection 1.3 
Section 2 
    Subsection 2.1 
    Subsection 2.2 
    Subsection 2.3 
Section 3 
    Subsection 3.1 
    Subsection 3.2 
    Subsection 3.3 

Se clicco sulla sezione 1, si vede quello che c'è sotto ma, se clicco su Sezione 2, i contenuti della sezione 1 sono nascosti e viene mostrato solo 2. Vorrei che tutte e 2 le sezioni fossero espanse ogni volta che sono nella pagina indice. Ho provato ad aggiungere toctree e maxdepth, non funziona nulla.

Answer 1

Bene, ho perso circa 3,4 milioni di neuroni che cercavano di leggere il codice sorgente della Sfinge (era scritto da un gruppo di procioni spericolati e rabbiosi?! Tanti livelli di astrazione).

Quindi:

• rendere il proprio tema sfinge (utilizzare un tema 3a parte come base, molto facile utilizzo tema 'leggibile' per questo.)
• nella directory in cui si ha a tema. conf, aggiungere un modello "fulltoc.html", che contiene una sola riga:

fulltoc.html:

{{ toctree(collapse=False) }} 

(Eh, nota l'argomento "collasso"?)

• in conf.py sphinx, modificare l'opzione html_sidebars per aggiungere il modello; e dichiarare il vostro tema

conf.py:

html_theme_path = [customized_readable_theme.get_html_theme_path()] 
html_theme = 'customized_readable' 
html_sidebars = {'**': ['fulltoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html']} 

• ricostruzione documentazione