每页内容需要一个文件.Sphinx不会将文件分成多个页面.
对我有用的是创建toctree
引用包含子toctree
指令的文件的指令.我喜欢在目录中创建子组,但您可以在一个目录中执行此操作.
index.rst
:
MyProject ========= Contents: .. toctree:: group1/index
group1/index.rst
:
Group1 ====== .. toctree:: subgroup1 subgroup2
group1/subgroup1.rst
:
Subgroup1 ========= Subgroup1 contents
group1/subgroup2.rst
:
Subgroup2 ========= Subgroup2 contents