狮身人面像中toctree的明确标题

Question

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

.. toctree::

    All about strings <string>

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

有人有想法吗？

Answer 1

根据Lukas Graf的回答，狮身人面像1.1.2存在您的确切问题。我用1.1.3进行了测试：没问题。 （在python 2.7，osx上。）>

我没有看到Sphinx' 1.1.3 changelog中的任何特定内容，尽管提到了“恢复与docutils主干的兼容性”。这表明另一个docutils版本可以

对您有所帮助。我正在使用版本0.9。

所以：狮身人面像1.1.3和docutils 0.9，您可以尝试那些版本吗？

Answer 2

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