Разное:maxdepth: для определенных записей в toctree (Sphinx)

Question

У меня есть некоторая документация на основе Sphinx для библиотеки, которую я построил, и я хотел бы показать расширенное оглавление для всех моих страниц, кроме журнала изменений. Я разобрался, как это сделать, переместив журнал изменений на секунду. :toctree::, но это странное поведение. В основном, журнал изменений отображается в другом списке при посещении страницы, и когда я использую навигацию по боковой панели, я могу перемещаться только по каждому дереву (если я нажму на журнал изменений, другие разделы не будут отображаться на боковой панели).). Есть лучший способ сделать это?

Вот что у меня сейчас:

.. toctree::
   :maxdepth: 5

   getting_started
   examples
   modules

.. toctree::
   :maxdepth: 1

   changelog


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

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

Answer 1

С шаблоном Read the Docs вы можете этого добиться. Кроме того, вам необходимо изменить файл style.css в каталоге _static. Просто добавьте

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

и два отдельных дерева токенов будут выглядеть как одно и отображаться на боковой панели.

Для других шаблонов Sphinx проверка визуализированного HTML может привести вас в правильное направление в поиске правильного css-селектора. Но я не знаю, как эти шаблоны обрабатывают боковую панель.