python - 在 toctree 中使用 self 不包括子部分

Question

我希望我在 sphinx 中的目录树包含主（index.rst）页面。文件建议包含'self'会这样做，但正如其他人在stackoverflow上指出的那样，这仅包括主页的标题，因此如果深度> 1，则主页的行为与链接页面不同。

我还看到了针对这个问题建议的内容指令，对我来说，这只是创建了一个单独的本地内容列表，对目录树没有帮助。我真的在寻找一种在目录树中产生一致行为的解决方案。有吗？

Answer 1

正如您提到的，包括文字self只是添加当前文档的标题。但是，包含当前文档的标题实际上会将其添加到树中。例如，

.. toctree::
    :maxdepth: 2

    index

会产生你想要的结果。我不确定为什么这没有在文档中明确列出。