自動採番脚注を含む po ファイルの sphinx-build に失敗する問題の対応

[syucream]

[#]_ で記述される、自動採番する脚注を含む po ファイルを翻訳し sphinx-build すると失敗する。
そのため、この記述を含む cache-arch.en.rst の翻訳は、一旦訳文から "[#]_" を除去している。
この問題が解決した、もしくは回避策を発見した際、#3 の訳文も修正する。

issue 報告済み。
https://bitbucket.org/birkenfeld/sphinx/issue/902/exttodo-launches-exception-keyerror-refid

[syucream]

当問題、既に fix されていたようです。
sphinx 1.2b でビルドが通ることも確認できました。
https://bitbucket.org/birkenfeld/sphinx/issue/955/cant-build-html-with-footnotes-when-using

可能であれば脚注を省かない訳文を用意したいですが、しかし現在多くの環境で sphinx 1.1.3 以下が使用されているものと思われます。
ReadTheDocs も、ちゃんとした資料は見当たらないのですが sphinx 1.1.3 でビルドしている可能性が高そうです。
つきましては、特に問題が無ければ、当 issue を開いたまま、脚注を省いた訳文を書こうと思います。

[maskit]

RTD は 1.1.3 を使ってます。
https://github.com/maskit/readthedocs.org/blob/master/readthedocs/projects/tasks.py#L410

試してないですが、doc/pip_requirements.txt に sphinx==1.2b3 を書けば使える気がします。

[maskit]

1.2 がリリースされたようです。
https://groups.google.com/d/msg/sphinx-users/J8yIS-j41aA/jPlSYMQiihwJ

[maskit]

早く 1.2 にしてもらえるように readthedocs/readthedocs.org#573 で課題として投げておきました。

[masaori335]

👍

[syucream]

RTD がデフォルトで Sphinx 1.2 でビルドしてくれるようになったので、当 issue を close します。
readthedocs/readthedocs.org@9d18c18