python - sphinx - 一章中有几个文件，并且可以使用 rtd 主题进行干净的 html 导航？

Question

我正在使用 sphinx 1.3.4¹ 来编写我的文档，make html使用“阅读文档”主题²。

当我在 index.rst 中包含标题从 Lv 1 到 Lv3 的文件 chaper1.rst 时，我会在生成的导航侧边栏中看到标题 lv 1。单击此标题后，它会折叠并显示标题 lv2 -lv3。好吧，没关系。

当我将第 1 章拆分为多个文件时，我可以chaper1/*在 index.rst 和生成的 html 文档中使用每个文件。但是每个文件标题 - 也包括那些以 lv2 开头的文件 - 在中央导航侧边栏中显示为单独的章节。不再折叠章节标题。：-/

如何为每章使用多个文件并在左侧实现干净的导航？

蒂亚！

编辑我做了 rtd-theme 版本 0.1.9 的反向移植 - 没有变化。所以这似乎是一个狮身人面像的问题。如何正确地将多个文件包含到一章中？

score 0 · Accepted Answer

找到了解决方案。我必须先写一个标题，.. toctree:: 这样 sphinx 才知道如何排列以下文件和标题……</p>

1 回答 1