Явное название токтрия в Сфинксе

Я пытаюсь явно указать заголовок элемента в моем toctree. В документации сказано, что это должно быть так:

.. toctree::

    All about strings <string>

Но он просто печатает заголовок того, что находится в документе string.rst, а не «Все о строках».

У кого-нибудь есть идея?


python python-sphinx toctree
person dvreed77    schedule 16.11.2012    source источник

Ответы (2)


arrow_upward
1
arrow_downward

Согласно ответу Лукаса Графа, у sphinx 1.1.2 есть ваша точная проблема. Пробовал с 1.1.3: нет проблем. (На python 2.7, osx).

Я не вижу ничего особенного в Sphinx '1.1 .3 changelog, хотя есть упоминание о «восстановлении совместимости со стволом документации». Это говорит о том, что вам может помочь другая версия Docutils . Пользуюсь версией 0.9.

Итак: sphinx 1.1.3 и Docutils 0.9, не могли бы вы попробовать эти версии?

person Reinout van Rees    schedule 18.11.2012

arrow_upward
1
arrow_downward

Я могу подтвердить это с помощью Sphinx 1.1.2. Похоже, это ошибка, возможно, регресс № 86. Эта проблема, по-видимому, исправлена ​​в 0.5.2, но, похоже, вернулись внутрь.

person Lukas Graf    schedule 16.11.2012