sphinx生成html页面时,如何去掉页面的“index”条目?

软件和网站开发以及相关技术探讨
回复
头像
驿窗project
帖子: 226
注册时间: 2019-01-17 12:17
系统: Arch/Debian
联系:

sphinx生成html页面时,如何去掉页面的“index”条目?

#1

帖子 驿窗project » 2020-10-11 14:11

我在用reST+sphinx制作html文档,使用bizstyle theme,生成的html页面上有一个"index"条目,我想让页面不显示这个条目,有什么办法?

例如:
https://pypubsub.readthedocs.io/en/v4.0.3/
在页面的右下角和右上角都有"index"条目,如果去掉它?

我在conf.py和index.rst里面都没有找到可以配置的地方~
头像
astolia
论坛版主
帖子: 6542
注册时间: 2008-09-18 13:11

Re: sphinx生成html页面时,如何去掉页面的“index”条目?

#2

帖子 astolia » 2020-10-12 9:50

头像
驿窗project
帖子: 226
注册时间: 2019-01-17 12:17
系统: Arch/Debian
联系:

Re: sphinx生成html页面时,如何去掉页面的“index”条目?

#3

帖子 驿窗project » 2020-10-13 16:12

好像还真是,我摸索下,回头反馈结果~
头像
驿窗project
帖子: 226
注册时间: 2019-01-17 12:17
系统: Arch/Debian
联系:

Re: sphinx生成html页面时,如何去掉页面的“index”条目?

#4

帖子 驿窗project » 2020-10-15 16:45

我在home目录里找到了layout.html文件(~/.local/lib/python3.5/site-packages/sphinx/themes/basic/),里面有rellink,但完全不清楚怎么改能删除index条目:)

basic/目录下的所有文件我都打开看了,只有layout.html这一个文件里面有rellink这个关键词~
附件
relink, layout.html
relink, layout.html
头像
astolia
论坛版主
帖子: 6542
注册时间: 2008-09-18 13:11

Re: sphinx生成html页面时,如何去掉页面的“index”条目?

#5

帖子 astolia » 2020-10-16 10:19

rellinks中的index项是在这里加上的,受use_index控制
https://github.com/sphinx-doc/sphinx/bl ... __.py#L458
而use_index又是来自于配置中的html_use_index
https://github.com/sphinx-doc/sphinx/bl ... __.py#L234
https://www.sphinx-doc.org/en/master/us ... _use_index
头像
驿窗project
帖子: 226
注册时间: 2019-01-17 12:17
系统: Arch/Debian
联系:

Re: sphinx生成html页面时,如何去掉页面的“index”条目?

#6

帖子 驿窗project » 2020-10-16 19:46

果然可以~
html_use_index这个参数是可以直接在source目录中的conf.py文件中修改的;conf.py文件可能会经常使用,比如换HTML Theme。
我在conf.py文件添加了一行:
html_use_index = False
然后重新 make html,重新生成的HTML页面,已经没有“Index”条目了~

你有收款码没?我小额感谢表示一下~
回复