如何正确使用Sphinx侧边栏选项“ globaltoc.html”来生成可折叠的菜单树

问题描述

我求助于使用选项html_sidebars模板 globaltoc.html 来获得多级菜单树，如下所示：

1. Execution
    1.1. Activities
        1.1.1. Report
        1.1.2. Follow up

通过创建源文件（ .rst ），我可以构建上述情况。单击父节点执行时，所有下面的子节点将同时展开。后来我又添加了两个文件，这些文件旨在添加到最后一个节点的末尾。因此，新的菜单树如下所示：

1. Execution
    1.1. Activities
        1.1.1. Report
        1.1.2. Follow up
        1.1.3. Escalation
        1.1.4. Final Submission

现在正在发生一些奇怪的事情。单击顶部节点 Execution （执行）后，所有子节点（包括新添加的子节点（ 1.1.3 和 1.1.4 ））都将展开同时（我认为他们应该这样做）。但是，当其中一个较旧的节点时，说 1.1.1。单击报告，新节点 1.1.3 和 1.1.4 折叠。并打开新页面，我必须单击顶部节点 1。执行以使较新的节点再次可见（以便可以单击它们以导航到文档）。

我已经跑过make clean html，但情况依旧。

我的问题是：我是否正确使用侧边栏中的 globaltoc.html 构建可折叠菜单树。如果是的话，应该采取什么措施才能使行为（折叠/展开）正确。

解决方法

请参见-a sphinx-build option。

如果给出，请始终写入所有输出文件。默认设置是仅为新的和更改的源文件写入输出文件。 （这可能不适用于所有构建器。）

或者make clean，然后make html将具有相同的结果。