Global toctree поделился между страницами - PullRequest
0 голосов
/ 09 марта 2020

Допустим, у меня есть два .rst файла, страница приветствия (индекс) и страница API. Я бы хотел, чтобы у них обоих были одинаковые деревья, поэтому легко переходить с одной страницы на другую.

index.rst :

Welcome!
========

Welcome to these awesome docs!

api.rst :

API
===

Here is some API stuff...

Я пытался добавить toctree в index.rst, что-то вроде этого:

.. toctree::
   :hidden:

   index
   api

Однако тогда моё дерево становится вложенным:

enter image description here

Я не только хочу добавить

.. toctree::
   :hidden:

   api

в index.rst и

.. toctree::
   :hidden:

   index

в api.rst , поскольку это означает, что боковая панель отличается между страницами.

Как добавить глобальный индекс в мой проект? Один и тот же, независимо от того, на какой странице я нахожусь?

...