Python 如何在Sphinx的主目录中隐藏章节标题?

Python 如何在Sphinx的主目录中隐藏章节标题?,python,python-sphinx,Python,Python Sphinx,我正在为一个使用Sphinx的Python项目编写文档。主页有一个目录,默认情况下,Sphinx中的toctree指令包括页面标题下方的部分标题。我觉得这太过分了,在可用性方面。直觉上,我希望每页有一个链接。所有章节都有子链接,这使得文档看起来比实际情况更复杂、更令人难以理解 :titlesonly:选项解决了这一问题,但当它实际位于页面上时,也会从侧边栏中删除部分标题。我不想丢失它们,因为它们是有用的“当前页面”目录 有没有办法将章节标题从首页的目录中排除,同时将其保留在侧栏中 不带的示例:仅

我正在为一个使用Sphinx的Python项目编写文档。主页有一个目录,默认情况下,Sphinx中的
toctree
指令包括页面标题下方的部分标题。我觉得这太过分了,在可用性方面。直觉上,我希望每页有一个链接。所有章节都有子链接,这使得文档看起来比实际情况更复杂、更令人难以理解

:titlesonly:
选项解决了这一问题,但当它实际位于页面上时,也会从侧边栏中删除部分标题。我不想丢失它们,因为它们是有用的“当前页面”目录

有没有办法将章节标题从首页的目录中排除,同时将其保留在侧栏中

不带
的示例:仅标题:
索引。rst:

Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2

   installation
   api
   support
Installation
============

From PyPI
---------

Lorem ipsum dolor sit amet...

From Source
-----------

Lorem ipsum dolor sit amet...
Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2
   :titlesonly:

   installation
   api
   support
安装。rst:

Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2

   installation
   api
   support
Installation
============

From PyPI
---------

Lorem ipsum dolor sit amet...

From Source
-----------

Lorem ipsum dolor sit amet...
Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2
   :titlesonly:

   installation
   api
   support
(对于其他.rst文件,依此类推)

index.html:

Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2

   installation
   api
   support
Installation
============

From PyPI
---------

Lorem ipsum dolor sit amet...

From Source
-----------

Lorem ipsum dolor sit amet...
Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2
   :titlesonly:

   installation
   api
   support

installation.html:

Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2

   installation
   api
   support
Installation
============

From PyPI
---------

Lorem ipsum dolor sit amet...

From Source
-----------

Lorem ipsum dolor sit amet...
Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2
   :titlesonly:

   installation
   api
   support

带有
的示例:仅标题:
索引。rst:

Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2

   installation
   api
   support
Installation
============

From PyPI
---------

Lorem ipsum dolor sit amet...

From Source
-----------

Lorem ipsum dolor sit amet...
Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2
   :titlesonly:

   installation
   api
   support
(其他.rst文件未更改)

index.html:

Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2

   installation
   api
   support
Installation
============

From PyPI
---------

Lorem ipsum dolor sit amet...

From Source
-----------

Lorem ipsum dolor sit amet...
Example Documentation
=====================

Table of Contents
-----------------

.. toctree::
   :maxdepth: 2
   :titlesonly:

   installation
   api
   support

installation.html


在toctree指令上设置maxdepth选项1是否达到了您想要的效果?您可以自定义主题的CSS以隐藏元素。@morric我也试过了。不幸的是,结果是一样的。@StevePiercy如果是这样,那就很好了。不过,你对如何进行这项工作有什么建议吗?我看到头版TOC中的2级列表项有类“toctree-l2”,但侧边栏中的2级列表项也有类“toctree-l2”,因此我不确定如何区分它们。您可以使用DOM中更高的类来分隔左侧项目符号和正文项目符号。主文本的bodywrapper和sphinxsidebarwrapper可以使用,不过如果您愿意,也可以使用其他的。