Sphinx中toctree的显式标题

【问题标题】：Explicit Title for toctree in SphinxSphinx中toctree的显式标题
【发布时间】：2012-11-16 18:59:00
【问题描述】：

我正在尝试在toctree 中明确设置元素的标题。文档说应该是这样的：

.. toctree::

    All about strings <string>

但它只是打印 string.rst 文档中内容的标题，而不是“关于字符串的全部内容”。

有人有想法吗？

【问题讨论】：

【解决方案1】：

根据 Lukas Graf 的回答，sphinx 1.1.2 有您的确切问题。我用 1.1.3 试了一下：没问题。（在 python 2.7、osx 上）。

我在Sphinx' 1.1.3 changelog 中没有看到任何具体内容，尽管其中提到了“恢复与 docutils trunk 的兼容性”。这表明另一个 docutils 版本可以帮助您。我正在使用版本0.9。

那么：sphinx 1.1.3 和 docutils 0.9，你能试试这些版本吗？

【讨论】：

【解决方案2】：

我可以用 Sphinx 1.1.2 确认这一点。这似乎是一个错误，可能是issue #86 的回归。这个问题显然在0.5.2 中得到了解决，但似乎又找到了解决办法。

【讨论】：