编辑:这篇帖子 似乎相关
我正在使用fulltoc 扩展在侧边栏中显示目录。
全局目录是在全局 index.rst 文件中定义的。它实际上是由一系列基本的 toctree
组成的:
.. toctree::
:caption: Getting Started
gettingStarted/overview
gettingStarted/section1
gettingStarted/section2
.. toctree::
:caption: Next Large section
group2/overview
group2/section1
group2/etc
overview.rst
文件包含每个部分的描述以及接下来部分的toctree。在gettingStarted
文件夹中,此文件如下:
Overview
========
This is a description of the section.
.. toctree::
section1
section2
问题在于查看页面
gettingStarted/overview
时,侧边栏会显示子目录,这会导致冗余的条目:
而我更希望有以下内容:入门指南
- 概述
- 第一部分
- 第二部分
- 第一部分
- 第二部分
一个解决方法是降低入门指南
- 概述
- 第一部分
- 第二部分
:maxdepth:
,但这样侧边栏就不会展开子部分,例如从某个部分(如gettingStarted/section1)阅读。我还发现
rubric
指令,但无法弄清楚如何在toctree
上使用它。如何防止子目录被索引到全局目录中?