Как отображать только заголовки .rst в боковой панели Sphinx? - PullRequest
Новая
       10

Как отображать только заголовки .rst в боковой панели Sphinx?

0 голосов
/ 09 апреля 2020

Я создаю документацию в Sphinx, используя эту тему: https://github.com/romnnn/sphinx_press_theme

У меня проблемы с достижением предполагаемой боковой панели навигации, которая в идеале должна отражать заголовки каждого из мои .rst файлы - например: 

Contents:
 Introduction
  About

Чтобы попытаться добиться этого, я настроил следующую структуру:

index.rst 

===========================
Contents:
===========================

.. toctree::
   :maxdepth: 2

   introduction/introduction

введение / введение.rst: 

=======================
Introduction
=======================

.. toctree::
   :maxdepth: 2

   about/about

Introduction Sub Header 1
__________________________

введение / о / о.rst: 

=======================
About
=======================

Когда я не использую тему, это приводит к следующему (это почти то, что я ищу, но я бы не хотел показывать подзаголовки страницы). 

Contents:
 Introduction
  About
  Introduction Sub Header 1

Когда я использую вышеупомянутую тему , Я получаю следующий результат, где отображается только подзаголовок - вместо этого я хотел бы показать заголовок страницы About. 

Contents:
 Introduction
  Introduction Sub Header 1

Есть ли способ изменить это поведение, чтобы добиться того, что я ищу

...