[Python-doc-jp 2309] sphinxへの移行に関して

[INADA Naoki]

稲田です。

ご存知の方も多いと思いますが、Python 2.6 からはドキュメントが
Latexからsphinxへと移行しています。

Python 2.5 の cvs を svn へと import し、オリジナルのドキュメントが
移行する際に利用したコンバーターを利用して、reStructuredText への
変換を行いました。これからsphinxの環境整備してsvnにコミットします。

で、問題は、2.5 と 2.6 の翻訳文をどう diff をとろうかということなのですが・・・
どこかで、2.5のドキュメントをsphinxで出していたところがあった気がするのですが、
今さがしても見つかりません。reStructuredText版の2.5ドキュメントがあれば、その原文から
2.6とのドキュメントのdiffをとれるのですが、どなたか私の他にも覚えのある方は
居られないでしょうか?

見つからなかった場合、愚直な方法としては、2.5のtex -> tex最終版　のｄｉｆｆと、
reST初期版 -> 2.6 のdiffの両方を見ながら差分翻訳することになります。
その他の方法として、コンバーターを改変し、Python 2.5 のドキュメントの変換で
エラーになる部分をごまかしつつreSTを作り、reST同士でdiffをとれるかなと
考えています。
日本語ドキュメントのreST化で一番キツかったのは、Latex で \methoddesc{関数名} を
\methoddesc[オブジェクト名]{関数名} に書き直さないといけない部分が大量にあった
ことです。逆に言えば、この部分さえテキトウに誤魔化せたら、2.5のSphinx版も最小限の
労力で用意できそうです。