据我所了解,新的Read the Docs主题从toctree生成侧边栏,默认显示2级目录。我的文档比较深入,2级目录不够有用。怎么能增加这个限制,或者最好是完全删除它?
如果不太可能实现,如何使用本地ToC代替全局toctree?
据我所了解,新的Read the Docs主题从toctree生成侧边栏,默认显示2级目录。我的文档比较深入,2级目录不够有用。怎么能增加这个限制,或者最好是完全删除它?
如果不太可能实现,如何使用本地ToC代替全局toctree?
html_theme_options = {
'navigation_depth': 4,
}
看起来,从Github上的主题源代码来看,目录深度在sphinx_rtd_theme/layout.html的第93行上是硬编码的。因此,您无法通过对主题进行配置来覆盖它。
由于这行代码是硬编码的,您将始终获得toctree
返回的全局目录树,而不是以下行“支持”的本地目录树。
maxdepth=3
,看起来像这样,因此可能需要一些额外的 CSS。toctree
模板函数的文档 指定了,要想实现无限深度,只需传递 maxdepth=-1
即可。请注意,这不会为 TOC 的子级添加展开/折叠功能。这可能是一个提交请求的好目标吗?
在ReadTheDocs中,没有办法自定义此行为。但是,您仍然可以阅读页面中的附加详细信息 - 它们只是不会显示在导航中。