在阅读文档侧栏中显示整个目录树

问题描述

我的理解是新的阅读文档主题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即可。请注意,这不会将折叠/展开添加到目录的子级别。

可能是拉入请求的好目标?

相关文章