Sphinx toctree指令：如何隐藏标题不被显示？

Question

如果我有以下内容index.rst：

This Section
------------

.. toctree::
   :caption: This Section
   :maxdepth: 1

   this_section/intro
   this_section/body
   this_section/outro

然后“This Section”将在生成的 HTML 文件中显示两次：一次作为<h1>，一次作为<p class="caption">. 我怎样才能摆脱后者，或者生成:caption:一个<h1>？我不能简单地删除:caption:，因为侧边栏（我正在使用 ReadTheDoc 主题）依赖于此选项来正确生成目录树。

Answer 1

我的解决方法是隐藏原始目录树并再次链接到内容......

This section
------------

* :doc:`intro <this_section/intro>`
* :doc:`body <this_section/body>`

.. toctree::
   :caption: This Section
   :hidden:

   this_section/intro
   this_section/body
   this_section/outro