微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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

如何解决如何正确使用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将具有相同的结果。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。