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