Sphinx中toctree的显式标题

Question

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

.. toctree::

    All about strings <string>

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

有谁有主意吗？

Answer 1

根据Lukas Graf的回答，sphinx 1.1.2有您确切的问题。我在1.1.3中尝试过:没有问题。(在python 2.7、osx上)。

我没有在Sphinx' 1.1.3 changelog中看到任何特定的东西，尽管有提到“恢复与docutils主干的兼容性”。这表明另一个docutils版本可能会对您有所帮助。我使用的是0.9版本。

那么: sphinx 1.1.3和docutils 0.9，你能试试这两个版本吗？

Answer 2

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