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