在阅读文档侧栏中显示整个目录树
问题描述
我的理解是新的阅读文档主题generates the sidebar from the toctree,深度为2。我的文档相对深入,深度2是不够的。如何增加或最好完全删除此限制?
如果这不可能,我如何使用本地目录而不是全局目录树?
解决方案
注意:上一个答案已过时。正如@Ariel在一条评论中指出的那样,现在可以通过在html_theme_options
中设置navigation_depth
来配置maxdepth
。根据README,在您的项目的conf.py:
html_theme_options = {
'navigation_depth': 4,
}
查看source for the theme on Github,似乎TOC深度在line 93 in sphinx_rtd_theme/layout.html上是硬编码的。因此,您无法对主题进行配置来覆盖它。
由于该行是硬编码的,因此您将始终获得由toctree
返回的全局toctree,而不是由以下行"支持"的本地toctree。
当然,您可以派生主题并更改该行以供本地使用(您还可以在RTD上使用定制主题,因此也可以在那里工作)。我试着用演示主题来这样做。它看起来像maxdepth=3
,所以可能需要一些额外的css。documentation for the toctree
template function指定对于无限深度,只需传递maxdepth=-1
即可。请注意,这不会将折叠/展开添加到目录的子级别。
可能是拉入请求的好目标?
相关文章