Sphinx:子软件包的模块列表

问题描述

构建文档时,html文档的左侧菜单类似于:

main_package
 |
 |-- Subpackages
 |    |-- subpackage_1
 |    |-- subpackage_2
 |
 |-- Submodules
 |
 |-- Module contents

如何在此菜单添加子模块列表?示例:

main_package
 |
 |-- Subpackages
 |    |-- subpackage_1
 |    |    |-- submodule_1a
 |    |    |-- submodule_1b
 |    |-- subpackage_2
 |         |-- submodule_2a
 |         |-- submodule_2b 
 |-- Submodules
 |
 |-- Module contents

解决方法

我正在使用sphinx_rtd_theme,感谢Steve Piercy的提示,答案是它与主题相关。对于此主题,应在conf.py文件中添加html_theme_options = {'navigation_depth': value}