我希望我在 sphinx 中的 toctree 包含主(index.rst)页面。文档建议包含“self”会执行此操作,但正如其他人在 stackoverflow 上指出的那样,这仅包含主页的标题,因此如果深度 > 1,则主页的行为与链接页面不同。
我还看到了针对此问题建议的内容指令,对我来说,这只是创建了一个单独的本地内容列表,对目录树没有帮助。我真的在寻找一种在 toctree 中产生一致行为的解决方案。有吗?
最佳答案
包括文字 self
只是添加您提到的当前文档的标题。但是,包括当前文档的标题实际上会将其添加到树中。例如,
.. toctree::
:maxdepth: 2
index
将产生您想要的结果。我不确定为什么没有在某处的文档中明确列出这一点。
关于python - 在 toctree 中使用 self 不包括子部分,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/27338257/