Сфинкс (RTD Theme) раздел навигации не соответствует

Question

Мой вопрос трудно передать словами. Я буду стараться изо всех сил.

Используя Sphinx 2.0.0, у меня есть проект со следующим "корневым" тектрием. Это индекс toctree:

Welcome to FIRST Robotics Documentation
========================================================

.. toctree::
   :maxdepth: 2
   :caption: WPILib Software

   software

.. toctree::
   :maxdepth: 2
   :caption: WPILib Hardware

   hardware

.. toctree::
   :maxdepth: 2
   :caption: Robot Networking

   networking

Это прекрасно работает.

Теперь у меня есть структура, которая выглядит примерно так:

Теперь давайте использовать страницу программного обеспечения toctree

.. toctree:: 
   :maxdepth: 1

   quick urls here

Getting Started
===============

.. toctree::
   :maxdepth: 1

   docs here

WPILib Overview
===============

.. toctree::
   :maxdepth: 1

   docs here

Это дает мне страницу, которая выглядит так:

Однако проблема заключается в том, что вы начинаете переходить к дочерним поддеревьям. Когда вы переходите в раздел "Обзор WPILib", верхняя навигационная панель отображается как "Начало работы", это воспроизводится и во всех других разделах.

На изображении выше должно отображаться "Обзор WPILib" вместо "Начало работы". К сожалению это не так.

Исходный код доступен для общего доступа по адресу: https://github.com/daltz333/frc-docs Исходный веб-сайт и проблемный URL-адрес по адресу: https://frc-docs.rtfd.io/en/develop

Я не могу придумать никакого решения, кроме разбиения каждого отдельного раздела на отдельный файл, что не вариант.

Answer 1

Вам нужно установить navigation_depth как собственность html_theme_options в conf.py, то есть:

# Theme options are theme-specific and customize the look and feel of a theme
# further.  For a list of options available for each theme, see the
# documentation.
html_theme_options = {
    'navigation_depth': 2
}

Для получения дополнительной информации см. Их документацию по настройке параметров темы.