2021-08-22

Flaskドキュメント日本語版のFlask最新版（v2.0.1）への対応（２）

前の記事でFlaskドキュメント日本語版作成用のローカル作業環境を更新したことを書きました。 msiz07.hatenablog.jp

その記事の中で「sphinx-intl stat」で翻訳状況の指標を確認できること、原文側のバージョンアップで更新された段落数（「sphinx-intl stat」で「fuzzy」として示される）が分かることも書きました。

このたびFlask最新版（v2.0.1）対応への手始めとして、取り急ぎ「fuzzy」と計上されていた段落を一通り更新しました。

以下のページで反映されているはずなので、よければ見てみてください。

msiz07-flask-docs-ja.readthedocs.io

※2021/8/31追記１週間も気付かずお恥ずかしいですが、Read the Docsの設定更新を忘れていて、サイト上の最新版（latest）が1.1系のままになっていました。先ほど設定を更新しました。

2021-08-21

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」の段落は変更がほとんどない場合もあるので、まずはそこを更新させることから着手しようと思います。

2020-07-23

Flaskドキュメント日本語訳をFlask最新版（1.1.2）に対応させました

しばらく手を付けられなかったFlask日本語訳ですが、2020/4/3に約9か月ぶりに安定板がリリースされていたので、現時点でのFlask最新版（1.1.2）に対応させました。

とはいっても、取り急ぎ今まで翻訳済みだった個所を更新させただけで、未翻訳だったところは、そのままです。リリースもマイナーバージョンの更新なので、ドキュメントの変更も小さなものでした。

これからも、気が向いたら更新していこうと思います。

2020-01-26

Flaskドキュメント日本語訳で、原文をツールチップ表示するようにしました

「Flask (v1.1.1) ドキュメントの Quickstart / Tutorial を日本語に訳しました - msiz07の日記」とかで紹介してる[Flaskドキュメント日本語訳(v1.1.1)][1_1_1ja]、しばらくこっちのブログには記事書いてなかったですが、更新はぼちぼち続けてます。

そんなサイトですが、このたび、翻訳したところにマウスのカーソルを置くと、翻訳元の原文をツールチップで表示するようにしました。

原文表示前は以下のような見た目ですが:

日本語にした部分（「Changelog」とか、一部は除く）にマウスのカーソルを移動させると、翻訳元の原文が以下のような感じで表示されます:

仕組み自体はそれほど複雑ではないんですが、Read the Docsで使ってるSphinxの仕組みの中で実装するのが手間がかかりました。Sphinxの内部は殆ど知らなかったもんで。

最初に紹介した[Flaskドキュメント日本語訳(v1.1.1)][1_1_1ja]のサイト、正直、翻訳のプロではないので誤訳もそれなりにあると思いますが、今回の機能で原文を確認しやすくなったと思うんで、そんなときは適宜、原文を確認してください。

2020-01-25

ここ数日Read the Docsでビルドが失敗するようです

分かる人しかわからない話ですが、タイトルのとおり、ここ数日Read the Docsでドキュメントのビルドに失敗するようです。

以下のとおり、システム関連で様々な情報交換がされている有名サイトstack overflowで早速取り上げた書き込みがありました。

stackoverflow.com

どうやら原因は、Pythonのpipでバージョン20.0に不具合があったためのようです。早速20.0.1がリリースされたらしい。

Read the Docsでドキュメント公開している場合の対応方法ですが、ログインして、自分のプロジェクトへ移動してから、以下の手順です。

「バージョン」画面へ移動
ビルドしたいバージョンの「編集」をクリックして移動
移動後の画面で「wipe」をクリックして（その後の確認画面で確認もして）、不具合に影響している環境を削除

既に書きましたが、pipの新リリースも出たようなので、この記事を書いている時点では既に修正されているかもしれません。

2019-12-12

Flask (v1.1.1) ドキュメントの「The Application Context」と「The Request Context」を日本語に訳しました

今回も「Flask (v1.1.1) ドキュメントの Quickstart / Tutorial を日本語に訳しました - msiz07の日記」の続きで、 Flaskドキュメント日本語訳(v1.1.1)内の「The Application Context」と「The Request Context」を日本語訳しました。

以前のFlaskから大きくは変わらない使用だと思うんですが、以前から公開されていたv0.5.1の日本語訳のころには原文の方で該当箇所のドキュメントがなかったようなので、そちらの日本語訳には含まれていない部分になります。

個人的な印象では、今回のコンテキスト周りの話を知った後だと、クイックスタートやチュートリアルの理解度が変わる感じがしました。

とくに「The Request Context」では「context local」という用語の説明があるので、これを知ってからコンテキスト関連の記述がある他の場所を読むと、理解度が上がるような感じがします。あくまで現時点の印象ですが。

例のごとく、誤解・誤訳など、気づいた点があれば、コメントなりpull requestなりで助けていただけるとありがたいです。

2019-12-09

Flask (v1.1.1) ドキュメントの「Modular Applications with Blueprints」を日本語に訳しました

このブログでは今の所このネタしか書いてないですが、「Flask (v1.1.1) ドキュメントの Quickstart / Tutorial を日本語に訳しました - msiz07の日記」の続きで、 Flaskドキュメント日本語訳(v1.1.1)内の「Modular Applications with Blueprints」を日本語訳しました。

blueprintはチュートリアルでも取り上げられている機能ですが、 FlaskのChangelogによるとv0.8から導入されたみたいなので、以前から公開されていたv0.5.1の日本語訳では扱われていない部分になります。

ざっくり説明すると、以下のようなことができるようになる機能です。

view、templateなどをblueprintの単位でグループ化できる
templateやstaticファイル用のフォルダをFlaskアプリケーション全体で設定されるフォルダとは別に、blueprintごとに用意できる
URLの特定のパス以下のリクエストをblueprintのviewへ割り振れる
url_forで使用するendpoint名をblueprint名で階層化（グループ化）できる

誤解・誤訳など、気づいた点があれば、コメントなりpull requestなりで助けていただけるとありがたいです。