python - Sphinx中toctree的显式标题

Question

我试图在我的toctree. 文档说应该是这样的：

.. toctree::

    All about strings <string>

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

有人有想法吗？

Answer 1

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

Answer 2

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

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

所以： sphinx1.1.3和 docutils 0.9，你能试试这些版本吗？