Différents :maxdepth : pour des entrées spécifiques dans toctree (Sphinx)

Question

J'ai une documentation basée sur Sphinx pour une bibliothèque que j'ai construite et j'aimerais afficher la table des matières étendue pour toutes mes pages sauf pour le journal des modifications. J'ai trouvé le moyen de le faire en déplaçant le journal des modifications dans un second fichier :toctree:: mais il a des comportements étranges. Principalement, le journal des modifications s'affiche dans une liste à puces différente lorsque je visite la page, et lorsque j'utilise la barre de navigation latérale, je ne peux naviguer que dans chaque arbre à puces (si je clique sur le journal des modifications, les autres sections ne s'affichent pas dans la barre latérale). Existe-t-il une meilleure façon de procéder ?

Voici ce que j'ai en ce moment :

.. toctree::
   :maxdepth: 5

   getting_started
   examples
   modules

.. toctree::
   :maxdepth: 1

   changelog

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

Answer 1

Avec le Lire les docs vous pouvez y parvenir. Vous devez en outre manipuler le style.css dans le fichier _statique répertoire. Il suffit d'ajouter

.rst-content .toctree-wrapper:not(:last-child) ul {
   margin-bottom: 0;
}

et les deux arbres toc séparés ressembleront à un seul et ils seront affichés dans la barre latérale.

Pour d'autres modèles Sphinx, une inspection de l'html rendu pourrait vous conduire dans la bonne direction pour trouver le sélecteur css correct. Mais je ne sais pas comment ces modèles gèrent la barre latérale.