我正在使用狮身人面像 1.3.4¹ 来编写我的文档,make html
使用"阅读文档"主题²。
当我在本文档中的 index.rst 中包含从 Lv 1 到 Lv3 的标题的文件 chaper1.rst 时,我看到 我生成的导航侧栏中的标题 LV 1。单击此标题后, 它折叠并显示标题 lv2 -lv3。很好,没关系。
当我将我的 Chapter 1 拆分为多个文件时,chaper1/*
我可以在 index.rst 和我的生成的 HTML 文档包括每个文件。但是每个文件标题- 还有那些以LV2开头的 - 显示在中央导航侧边栏中折叠为单独的章节。不再有折叠的章节标题。:-/
如何为每章使用多个文件并在左侧实现干净的导航?
蒂亚!
编辑我做了 rtd 主题版本 0.1.9 的向后移植 - 没有变化。所以这似乎是一个狮身人面像的问题。如何在一章中正确包含多个文件?
[1] https://packages.debian.org/jessie-backports/python3-sphinx
[2] https://packages.debian.org/jessie/python3-sphinx-rtd-theme
找到了解决方案。我必须在.. toctree::
之前写一个标题,以便狮身人面像知道如何排列以下文件和标题......