合并来自多个子项目的Sphinx文档:处理索引,同步配置等

问题描述

| 我们有一个(出色的)Sphinx文档记录的多模块项目。我们的设置与邮件列表中描述的设置没有什么不同。总的来说,这很好!但是我们对此有一些疑问: 子模块目录将包含索引链接。这些充其量只能链接到错误的索引。 (在最坏的情况下,这似乎会触发Sphinx中的错误,但是我使用的是devel版本,因此是合理的)。有没有一种方法只为最顶层的toctree生成索引链接? 是否有使Sphinx配置在多个项目之间保持同步的最佳实践?我可以想象在ѭ0周围一起砍东西,但对其他方法感到好奇。 在讨论过程中,在邮件列表中提出的问题(替代子项目文档的符号链接?)从未得到解答。这对我来说并不重要,但对其他读者来说可能很重要。     

解决方法

暂无找到可以解决该程序问题的有效方法,小编努力寻找整理中!

如果你已经找到好的解决方法,欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@)