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

Question

我希望我的工具树在狮身人面像包括主(index.rst)页面。文档建议包括'self‘可以做到这一点，但正如其他人在stackoverflow上所指出的那样，这只包括主页的标题，因此如果深度>1，则主页的行为与链接的页面不同。

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

Answer 1

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

.. toctree::
    :maxdepth: 2

    index

将产生您想要的结果。我不确定为什么文档中没有明确列出这一点。