我试图用Sphinx记录多个“层次”文档,例如:
- API参考
- 手册
- 教程
- 等等
这个想法是在侧边栏中相对于你所在的部分显示目录。因此,当你在主索引上时,它只显示上述部分。当您进入例如“手册”时,它会显示特定于该部分的不同目录,以及返回主目录的方法。
我一直在尝试找出如何在Sphinx中获取此功能,而不需要修改代码,但到目前为止仍然无法完全理解。文件夹结构已经反映了不同的部分(即所有“手册”文档都存储在_source/manual下),并且我已经尝试在每个目录中放置单独的索引文件,但似乎toctree功能仅查看主索引文件。
我正在使用“readthedocs”主题,我特别查看的代码是https://github.com/snide/sphinx_rtd_theme/blob/master/sphinx_rtd_theme/layout.html#L93
有人可以告诉我如何使用Sphinx添加此类目录吗?
谢谢