python - Sphinx の toctree の明示的なタイトル

Question

で要素のタイトルを明示的に設定しようとしていtoctreeます。ドキュメントには、次のようにする必要があると記載されています。

.. toctree::

    All about strings <string>

ただし、「文字列に関するすべて」ではなく、string.rst ドキュメントにあるもののタイトルを出力するだけです。

誰にもアイデアがありますか？

score 1 · Accepted Answer

これは Sphinx 1.1.2 で確認できます。これはバグのようで、問題 #86の回帰である可能性があります。この問題は明らかに0.5.2で修正されましたが、元に戻ったようです。

score 1 · Accepted Answer

Lukas Graf の回答によると、sphinx 1.1.2 には正確な問題があります。1.1.3 で試してみました。問題ありません。(python 2.7、osx)。

「docutils トランクとの互換性を復元する」という言及がありますが、Sphinx の 1.1.3 changelogには具体的なものは何もありません。これは、別の docutils バージョンが役立つ可能性があることを示唆しています。バージョンを使用して0.9います。

そう: sphinx1.1.3と docutils 0.9、それらのバージョンを試してみませんか?

2 に答える 2