python - Sphinx 中 toctree 的显式标题

Question

我试图在我的 toctree 中显式设置元素的标题。文档说应该是这样的:

.. toctree::

    All about strings <string>

但它只打印 string.rst 文档中内容的标题，而不是“All about strings”。

有人有想法吗？

Answer 1

我可以通过 Sphinx 1.1.2 确认这一点。这似乎是一个错误，可能是 issue #86 的回归。这个问题显然已在 0.5.2 中修复。 ，但似乎又找到了回来的路。