Как сложить все разделы второго уровня в сфинксе?

Question

Я использую тему readthedocs для личного проекта документации sphinx. Все работает нормально, кроме отображения левого фрейма списка содержимого: он отображает все уровни заголовков разделов, не показывая никакой иерархии. Как позволить этому показывать уровни как в большинстве проектов документации readthedocs?

После нажатия на знак "+" это выглядит правильно:

Вот как я отмечаю заголовок раздела:

Apache
======
How to restart
--------------

Answer 1

Это стандартное поведение сфинкса. Выбранный вами раздел раскрывается на левой боковой панели. Иначе, оно остается разрушенным. https://docs.readthedocs.io/en/latest/versions.html эта ссылка также демонстрирует похожий тип поведения. Чтобы сделать его разборным при нажатии, вам потребуется обновить тему.

Answer 2

Это звучит так: ошибка не расширяется.

Если нет, укажите свою версию Sphinx, где вы создаете документы и соответствует ли то, что вы делаете для создания документов, условиям этой проблемы.

В противном случае нет настраиваемой опции для расширения всех опций в теме RTD Sphinx. См. https://sphinx-rtd-theme.readthedocs.io/en/latest/configuring.html вам придется написать собственный JavaScript-код и включить статический ресурс в тему. Это домашнее задание оставлено спрашивающему или любезному ответчику.

Вы также можете отправить запрос на добавление функции по адресу https://github.com/rtfd/sphinx_rtd_theme/issues/new