È a mia conoscenza il nuovo tema Leggi il documento generates the sidebar from the toctree con una profondità di 2. La mia documentazione è relativamente profonda e una profondità di 2 non è sufficiente per essere utile. Come posso aumentare questo limite o preferibilmente rimuoverlo interamente?Mostra tutto toctree nella barra laterale di Read The Docs
Se ciò non è ragionevolmente possibile, come posso utilizzare i ToC locali anziché il toctree globale?
Nota: La risposta precedente non era aggiornata. Come osserva @Ariel in un commento, lo maxdepth è ora configurabile impostando navigation_depth in html_theme_options. Come per la README, cambiare questo nel conf.py del progetto:
html_theme_options = {
'navigation_depth': 4,
}
Guardando il source for the theme on Github, sembra che la profondità ToC è hard-coded su line 93 in sphinx_rtd_theme/layout.html. In quanto tale, non è possibile configurare il tema per sovrascriverlo.
Poiché la linea è codificata, verrà sempre restituito il toctree globale da toctree, anziché quello locale "supportato" dalle seguenti righe.
È possibile, ovviamente, inserire il tema e modificare quella linea per l'utilizzo locale (e è possibile utilizzare temi personalizzati su RTD, quindi dovrebbe funzionare anche lì). Ho provato a farlo con il tema della demo. Assomiglia a questo con maxdepth=3, quindi potrebbe essere necessario un po 'di CSS aggiuntivo. Lo documentation for the toctree template function specifica che per profondità illimitata, è sufficiente passare maxdepth=-1. Si noti che questo non aggiunge collasso/espandi ai sottolivelli del sommario.
Potrebbe essere un buon obiettivo per una richiesta pull?
Non c'è modo di personalizzare questo comportamento, almeno in ReadTheDocs. Tuttavia, è ancora possibile leggere gli ulteriori livelli di dettaglio nelle pagine: semplicemente non vengono visualizzati nella navigazione.
questa non è una barra laterale con più di 2 livelli? http://read-the-docs.readthedocs.org/en/latest/getting_started.html Come posso simulare questo comportamento? Mostra solo più livelli quando ho un oggetto con sottotitoli, ma è abbastanza buono per me. – Ariel
Ok, ero sulla versione 0.1.6, apparentemente hanno aggiunto il supporto per profondità 3 e 4 nella versione 0.1.8: https://github.com/snide/sphinx_rtd_theme#v0-1-8 – Ariel
Funziona su Internet versione di RTD? Sembra funzionare solo localmente per me, vedi il [corrispondente problema su Github] (https://github.com/rtfd/readthedocs.org/issues/2718) –