sphinx - 章节中的几个文件和带有rtd-theme的干净html导航可能吗?

时间:2016-02-24 19:25:28

标签: python navigation python-sphinx read-the-docs

我正在使用sphinx1.3.4¹编写我的文档,make html使用“阅读文档”主题²。

当我在index.rst中包含一个文件chaper1.rst时,在本文档中标题为Lv 1到Lv3,我看到了  在我生成的导航侧栏中标题lv 1。单击此标题后,  它折叠并显示标题lv2 -lv3。 很好,没关系。

当我将chapter1分成几个文件时,我可以在index.rst和my中使用chaper1/* 生成的html文档包含每个文件。 每个文件标题 - 也有那些以lv2开头的人 - 在中央导航栏中显示 崩溃作为单独的章节。没有崩溃的章节标题了。 : - /

如何为每章使用多个文件,并在左侧创建一个干净的导航?

TIA!

修改的 我做了rtd-theme Version 0.1.9的后退 - 没有变化。所以它似乎是一个狮身人面像的问题。 如何在一章中正确包含多个文件?

[1] https://packages.debian.org/jessie-backports/python3-sphinx
[2] https://packages.debian.org/jessie/python3-sphinx-rtd-theme

1 个答案:

答案 0 :(得分:0)

找到解决方案。我必须在.. toctree::之前写一个标题,以便sphinx知道如何安排以下文件和标题......