斯芬克斯中toctree的显式标题

Question

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

.. toctree::

    All about strings <string>

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

有人有主意吗

Answer 1

我可以用狮身人面像1.1.2来证实这一点。这似乎是一个bug，可能是issue #86的回归。这个问题显然是在0.5.2中解决的，但似乎又回到了过去

Answer 2

根据卢卡斯·格拉夫的回答，斯芬克斯1.1.2有你的问题。我试过1.1.3：没问题。（在Python2.7、osx上）

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

那么：sphinx1.1.3和docutils0.9，你能试试这些版本吗