据我所知,新的阅读文档主题generates the sidebar from the toctree的深度为2。我的文档比较深,深度为2还不足以使它有用。如何增加这个限制,或者最好完全取消它?
如果这不太可能,我如何使用本地目录而不是全局目录树?

最佳答案

注意:之前的答案已过时。正如@ariel在注释中指出的那样,maxdepth现在可以通过在navigation_depth中设置html_theme_options来配置。根据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返回的全局目录树,而不是由以下行“支持”的本地目录树。
当然,您可以分叉主题并更改该行以供本地使用(并且您可以在RTD上使用自定义主题,因此也应该在那里工作)。我试着用演示主题。看起来像这样,所以可能需要一些额外的CSS。documentation for the maxdepth=3 template function指定对于无限深度,只需通过toctree。请注意,这不会向TOC的子级添加折叠/展开。
可能是拉请求的好目标?

08-19 21:40