Flaskドキュメント日本語版のFlask最新版(v2.0.1)への対応
結構前になりますが、PyPIのFlaskのページによると、2021/5/22にメジャー・アップデート後のマイナーアップデートまでされ、v2.0.1がリリースされていました。v2.0.0はもっと前にされてたということですね。
公式ではない個人翻訳なので最新版を追いかける義務みたいなのはないんですが、引き続きできる範囲で追いかけようと思います。
取り急ぎ、Sphinxでの国際化対応のページで示されている「sphinx-intl update
」を利用して、作業環境で原文の方を2.0.1に更新。実行結果は以下のような感じで、全く変更のないファイルは少ない感じ。
Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\advanced_foreword.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\api.po +335, -219 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\appcontext.po Create: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\async-await.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\becomingbig.po +3, -3 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\blueprints.po +7, -3 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\changelog.po Create: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\changes.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\cli.po +9, -7 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\config.po +17, -14 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\contributing.po +30, -32 Create: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\debugging.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\design.po +7, -3 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\errorhandling.po +50, -34 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\extensiondev.po +3, -3 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\extensions.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\foreword.po +2, -3 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\htmlfaq.po +4, -2 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\index.po +3, -2 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\installation.po +5, -15 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\license.po +2, -2 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\logging.po +1, -0 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\quickstart.po +43, -44 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\reqcontext.po +1, -1 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\security.po +5, -0 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\server.po +16, -9 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\shell.po +2, -2 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\signals.po +1, -1 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\styleguide.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\templating.po +2, -7 WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 113: '.. _pytestのfixture:: pytest fixture' WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 570: '.. _テストするためのユーティリティ:: utilities for testing' WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 113: '.. _pytestのfixture:: pytest fixture' WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 570: '.. _テストするためのユーティリティ:: utilities for testing' Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\testing.po +4, -3 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\unicode.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\upgrading.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\views.po Create: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\deploying\asgi.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\deploying\cgi.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\deploying\fastcgi.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\deploying\index.po +1, -0 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\deploying\mod_wsgi.po +0, -1 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\appdispatch.po +4, -4 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\appfactories.po +6, -3 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\caching.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\celery.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\deferredcallbacks.po +1, -1 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\distribute.po +3, -4 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\errorpages.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\fabric.po +4, -4 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\favicon.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\fileuploads.po +6, -7 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\flashing.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\index.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\jquery.po +0, -4 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\lazyloading.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\methodoverrides.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\mongoengine.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\mongokit.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\packages.po +9, -6 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\requestchecksum.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\singlepageapplications.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\sqlalchemy.po +1, -1 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\sqlite3.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\streaming.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\subclassing.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\templateinheritance.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\urlprocessors.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\viewdecorators.po +2, -2 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\patterns\wtforms.po +3, -3 WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 169: '.. _Jinjaのforループ: Jinja for loops"' WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 169: '.. _Jinjaのforループ: Jinja for loops"' Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\blog.po WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 62: '.. _SQL言語: language"' WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 62: '.. _SQL言語: language"' Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\database.po +2, -2 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\deploy.po +4, -1 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\factory.po +3, -3 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\index.po +3, -1 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\install.po Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\layout.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\next.po +1, -1 Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\static.po +1, -0 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\templates.po Update: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\tests.po +2, -2 Not Changed: ...\flask-docs-ja-rtd\_locales\ja\LC_MESSAGES\tutorial\views.po
「sphinx-intl
」では翻訳状況の目安になる指標を出してくれる機能があって、「sphinx-intl stat
」を使うと、翻訳済みの段落数、未翻訳の段落数などを出してくれます。作業環境でFlaskドキュメントの原文をv2.0.1に更新した後、「sphinx-intl stat
」を実行した結果は、以下のような感じ。
_locales\ja\LC_MESSAGES\advanced_foreword.po: 9 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\api.po: 0 translated, 0 fuzzy, 1076 untranslated. _locales\ja\LC_MESSAGES\appcontext.po: 29 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\async-await.po: 0 translated, 0 fuzzy, 20 untranslated. _locales\ja\LC_MESSAGES\becomingbig.po: 19 translated, 2 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\blueprints.po: 50 translated, 3 fuzzy, 4 untranslated. _locales\ja\LC_MESSAGES\changelog.po: 0 translated, 0 fuzzy, 390 untranslated. _locales\ja\LC_MESSAGES\changes.po: 0 translated, 0 fuzzy, 444 untranslated. _locales\ja\LC_MESSAGES\cli.po: 82 translated, 4 fuzzy, 10 untranslated. _locales\ja\LC_MESSAGES\config.po: 111 translated, 10 fuzzy, 15 untranslated. _locales\ja\LC_MESSAGES\contributing.po: 0 translated, 0 fuzzy, 50 untranslated. _locales\ja\LC_MESSAGES\debugging.po: 0 translated, 0 fuzzy, 21 untranslated. _locales\ja\LC_MESSAGES\design.po: 0 translated, 0 fuzzy, 36 untranslated. _locales\ja\LC_MESSAGES\errorhandling.po: 43 translated, 21 fuzzy, 29 untranslated. _locales\ja\LC_MESSAGES\extensiondev.po: 59 translated, 2 fuzzy, 4 untranslated. _locales\ja\LC_MESSAGES\extensions.po: 8 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\foreword.po: 11 translated, 2 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\htmlfaq.po: 0 translated, 0 fuzzy, 62 untranslated. _locales\ja\LC_MESSAGES\index.po: 11 translated, 2 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\installation.po: 29 translated, 4 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\license.po: 0 translated, 0 fuzzy, 15 untranslated. _locales\ja\LC_MESSAGES\logging.po: 20 translated, 0 fuzzy, 3 untranslated. _locales\ja\LC_MESSAGES\quickstart.po: 139 translated, 22 fuzzy, 26 untranslated. _locales\ja\LC_MESSAGES\reqcontext.po: 49 translated, 1 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\security.po: 44 translated, 0 fuzzy, 17 untranslated. _locales\ja\LC_MESSAGES\server.po: 5 translated, 2 fuzzy, 14 untranslated. _locales\ja\LC_MESSAGES\shell.po: 21 translated, 2 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\signals.po: 32 translated, 0 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\styleguide.po: 49 translated, 0 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\templating.po: 43 translated, 2 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\testing.po: 56 translated, 3 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\unicode.po: 28 translated, 0 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\upgrading.po: 0 translated, 0 fuzzy, 94 untranslated. _locales\ja\LC_MESSAGES\views.po: 28 translated, 0 fuzzy, 9 untranslated. _locales\ja\LC_MESSAGES\deploying\index.po: 11 translated, 1 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\deploying\mod_wsgi.po: 41 translated, 0 fuzzy, 2 untranslated. _locales\ja\LC_MESSAGES\deploying\uwsgi.po: 12 translated, 0 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\deploying\wsgi-standalone.po: 19 translated, 0 fuzzy, 4 untranslated. _locales\ja\LC_MESSAGES\patterns\apierrors.po: 0 translated, 0 fuzzy, 11 untranslated. _locales\ja\LC_MESSAGES\patterns\appdispatch.po: 18 translated, 4 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\appfactories.po: 25 translated, 3 fuzzy, 3 untranslated. _locales\ja\LC_MESSAGES\patterns\caching.po: 3 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\celery.po: 0 translated, 0 fuzzy, 17 untranslated. _locales\ja\LC_MESSAGES\patterns\deferredcallbacks.po: 0 translated, 0 fuzzy, 6 untranslated. _locales\ja\LC_MESSAGES\patterns\distribute.po: 28 translated, 2 fuzzy, 1 untranslated. _locales\ja\LC_MESSAGES\patterns\errorpages.po: 0 translated, 0 fuzzy, 23 untranslated. _locales\ja\LC_MESSAGES\patterns\fabric.po: 0 translated, 0 fuzzy, 36 untranslated. _locales\ja\LC_MESSAGES\patterns\favicon.po: 0 translated, 0 fuzzy, 10 untranslated. _locales\ja\LC_MESSAGES\patterns\fileuploads.po: 26 translated, 4 fuzzy, 2 untranslated. _locales\ja\LC_MESSAGES\patterns\flashing.po: 14 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\index.po: 3 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\jquery.po: 0 translated, 0 fuzzy, 22 untranslated. _locales\ja\LC_MESSAGES\patterns\lazyloading.po: 0 translated, 0 fuzzy, 14 untranslated. _locales\ja\LC_MESSAGES\patterns\methodoverrides.po: 0 translated, 0 fuzzy, 5 untranslated. _locales\ja\LC_MESSAGES\patterns\mongoengine.po: 0 translated, 0 fuzzy, 16 untranslated. _locales\ja\LC_MESSAGES\patterns\mongokit.po: 0 translated, 0 fuzzy, 2 untranslated. _locales\ja\LC_MESSAGES\patterns\packages.po: 19 translated, 5 fuzzy, 4 untranslated. _locales\ja\LC_MESSAGES\patterns\requestchecksum.po: 0 translated, 0 fuzzy, 6 untranslated. _locales\ja\LC_MESSAGES\patterns\singlepageapplications.po: 0 translated, 0 fuzzy, 3 untranslated. _locales\ja\LC_MESSAGES\patterns\sqlalchemy.po: 30 translated, 1 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\sqlite3.po: 21 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\streaming.po: 0 translated, 0 fuzzy, 12 untranslated. _locales\ja\LC_MESSAGES\patterns\subclassing.po: 4 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\templateinheritance.po: 9 translated, 0 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\patterns\urlprocessors.po: 0 translated, 0 fuzzy, 12 untranslated. _locales\ja\LC_MESSAGES\patterns\viewdecorators.po: 0 translated, 0 fuzzy, 22 untranslated. _locales\ja\LC_MESSAGES\patterns\wtforms.po: 19 translated, 3 fuzzy, 1 untranslated. WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 169: '.. _Jinjaのforループ: Jinja for loops"' WARNING: Start of line didn't match any expected keyword. WARNING: Problem on line 169: '.. _Jinjaのforループ: Jinja for loops"' _locales\ja\LC_MESSAGES\tutorial\blog.po: 27 translated, 0 fuzzy, 5 untranslated. _locales\ja\LC_MESSAGES\tutorial\database.po: 28 translated, 2 fuzzy, 3 untranslated. _locales\ja\LC_MESSAGES\tutorial\deploy.po: 21 translated, 1 fuzzy, 4 untranslated. _locales\ja\LC_MESSAGES\tutorial\factory.po: 23 translated, 0 fuzzy, 4 untranslated. _locales\ja\LC_MESSAGES\tutorial\index.po: 7 translated, 1 fuzzy, 3 untranslated. _locales\ja\LC_MESSAGES\tutorial\install.po: 18 translated, 0 fuzzy, 2 untranslated. _locales\ja\LC_MESSAGES\tutorial\layout.po: 16 translated, 0 fuzzy, 2 untranslated. _locales\ja\LC_MESSAGES\tutorial\next.po: 14 translated, 1 fuzzy, 0 untranslated. _locales\ja\LC_MESSAGES\tutorial\static.po: 9 translated, 0 fuzzy, 2 untranslated. _locales\ja\LC_MESSAGES\tutorial\templates.po: 25 translated, 0 fuzzy, 3 untranslated. _locales\ja\LC_MESSAGES\tutorial\tests.po: 51 translated, 2 fuzzy, 7 untranslated. _locales\ja\LC_MESSAGES\tutorial\views.po: 40 translated, 0 fuzzy, 2 untranslated.
ここで「translated」は翻訳済みの段落数、「untranslated」は未翻訳の段落数になります。「fuzzy」は、先ほどの「sphinx-intl update
」によって原文が更新された段落数です。
「fuzzy」の段落は変更がほとんどない場合もあるので、まずはそこを更新させることから着手しようと思います。