我用一个索引文件和另外两个名为firstdoc.rst和seconddoc.rst的rst文件制作了一个Sphinx项目。我的index.rst有以下toctree:
.. toctree::
:maxdepth: 2
:caption: Contents:
firstdoc
seconddoc
我在添加了firstdoc.rst之后运行了make html，然后在添加seconddoc.rst之后再次运行。
现在，当我将_build/html目录传输到服务器时，我发现索引页面有一个侧栏，其中列出了firstdoc和seconddoc页面。firstdoc页面没有在侧栏中列出任何页面。第二个文档页面在侧栏中列出了第一个文档页面，但没有列出第二个页面。
我希望所有页面都能在侧边栏中列出所有页面。我该怎么做？
编辑：如果我编辑firstdoc.rst和seconddoc.rst文件，然后运行make html，然后将firstdoc.html和seconddoc.html传输到服务器，那么我就得到了我想要的。这就是所有页面都显示在所有页面的侧边栏中。这似乎非常不令人满意，因为这意味着每次我向项目添加新页面时，我都必须编辑项目中的所有现有页面，以便他们将新页面包含在侧栏中。有更方便的方法吗？
一般规则是，索引页面上的.. toctree::(在conf.py中设置为master_doc的页面(将控制所有文档上边栏的结构，因此在那里设置的:maxdepth:选项将控制边栏在所有页面上显示的深度。
确保运行make clean并仔细检查所有构建文件是否已删除，它应该可以工作。您注意到，在生成解决问题之前编辑文件暗示了正在缓存中间生成文件。