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

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

0 голосов
/ 22 апреля 2019

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

Используя 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

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

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

What the Toctree Looks Like

Теперь давайте воспользуемся "software" страница индекса toctree 

.. toctree:: 
   :maxdepth: 1

   quick urls here

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

.. toctree::
   :maxdepth: 1

   docs here

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

.. toctree::
   :maxdepth: 1

   docs here

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

screenshot 2

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

Example of an article listed under the wrong section

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

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

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

...