以前の投稿で、ハンドルバーテンプレートからgettext文字列を抽出するpybabel-hbsを作成する必要がある理由と理由について書きました。



少し後に、jsonから同じものを抽出する必要がありました。

これが、pybabel-jsonが生まれた方法です。

githubに pybabel-jsonをpipインストールする



babelに組み込まれたjavascript lexerを使用しましたが、微妙な違いもありましたが、投稿はそれについてではなく、hbsプラグインよりも面白く書かれておらず、ほとんど注意する必要はありません。



この投稿は、ローカライズのセット全体が、データベースまたは他のまったく静的でない場所からのデータをどのように処理するのか、一般的にどのように見えるかについてです。

含まれるもの：

（私は言う必要があります-アイテムは必須ではありません、これはすべて部分的にのみ必要に応じてアプリケーションに接続するのは非常に簡単です）



-バベル。 アプリケーションをローカライズするためのユーティリティのセット。

-うめき。 タスクマネージャー、

-コーヒースクリプト。 プレゼンテーションは必要ありません。クライアントコードはすべてコーヒーで書かれており、そこから文字列を抽出する必要もあります。

-ハンドルバー-テンプレート

-json-文字列ストレージ

-ジェド。 js用のgettextクライアント

-po2json。 Jedがサポートする.poファイルを.json形式に変換するユーティリティ

gettextと神話について

gettextは当初、アプリケーションをローカライズするためのユーティリティのセットでしたが、今日はgettextを一般に受け入れられている形式とも呼びます。 （唯一のものと混同しないでください）

最小限のエッセンスは次のように説明できます：特定のgettext関数を通過して目的の言語の行に変わる英語の行がありますが、複数形の異なる曲用に関する言語の規則+コンテキストとドメインを指定する機能を保持します。

行であり、キーであり、どこかでテキストになる定数USER_WELCOME_MESSAGEではないことに注意することが重要です。



誰もがコンテキストを必要としているわけではなく、不必要にプルリクエストを歓迎しているため、Babelプラグインにはまだ実装していません

後でドメインに関するいくつかの単語があります。

ただし、 ngettextは、 すべてではないにしても、多くの人にとって必需品です。

そして神話について。

りんごはゼロ。 リンゴなし
リンゴ一個。 リンゴ1個
 2つのリンゴ。 りんご2個
 5つのリンゴ。  5つのリンゴ

この簡単な例は、「USER_WELCOME_MESSAGE」に似た言語定数を愛するすべての人を示しています。



babelで事前定義および説明されているルールにより、選択する行が決まります。

たとえば、これは英語用です。

"Plural-Forms: nplurals=2; plural=(n != 1)\n"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これはロシア語用です：

 "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && " "n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)\n"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

グレートとマイティ:)

恐れる必要はありません。たとえば日本語の場合、これを手動で書く必要はありません。



だから、神話について。

何度か、メインサイトをロシア語で作成し、ロシア語の行をgettext呼び出しでラップしてから英語を追加できるという意見を聞きました。

同じ言語定数を使用している松葉杖を持っている場合、数字を含む傾斜文はなく、「You have apples：1」のようなugい形式を使用しているので、もちろん基本的なロシア語を実行できます。

「リンゴが1個あります」、「リンゴが7個あります」など、もう少し美しいメッセージをユーザーに表示する場合は、メイン言語を英語にする必要があります。



なんで？ りんごがすべてです。

複数形は常に単数形であるとは限らず、単数形は常に単位であるとは限りません。

この点で英語は簡単ですが、ロシア語ではありません。



キーは正確に英語を想定しているため、デフォルトではngettext。 さらに、ngettextは、入力として2つのパラメーター（単数形と複数形）のみを取ります。 そして、複数の配列ではありません。



したがって、デフォルトでロシア語を引き続き使用する場合は、少なくともロシア語とロシア語の翻訳ファイルをサポートする必要があります。このファイルでは、「You have％s apples」という行が正しい曲用に変わります。 はい、できます-しかし、曲がっています。

変更するときは、ロシア語の文字列ではなく、キーのみが変更されることを覚えておく必要があります。また、ロシア語の言語ファイルを並行して編集する必要があります。 一般に、これを行う必要はありません。 ngettextは、元の英語と可能な限り互換性があります。



ところで、同時に.poファイルが英語とロシア語を検索する方法の例を示します

 msgid "You have %(apples_count)d apple" msgid_plural "You have %(apples_count)d apples" msgstr[0] "  %(apples_count)d " msgstr[1] "  %(apples_count)d " msgstr[2] "  %(apples_count)d "
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

 msgid "You have %(apples_count)d apple" msgid_plural "You have %(apples_count)d apples" msgstr[0] "" msgstr[1] ""
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

つまり、結果の行数は言語構成に依存します。 たぶん、ダースの複数形がある言語があります...

OK、それではどこから始めますか？

まだ3個のリンゴを持っているすべての人は、始めるためにやる気がなければなりません

pip install babel

難しい部分は後ろにあります。



残ります：

-コード内のすべてのテキストをgettext呼び出しに変更します

-コードにbabelを設定する

-受信した.potファイルに基づいて、目的の各言語に対応する.poファイルを作成します。

そして実際に何を翻訳しますか？

質問は一見簡単そうではありません：



シンプルな部分はテンプレートとコードです。

Djangoとフラスコ-テンプレートからの抽出があります

Pythonとjavascriptはbabelによってネイティブにサポートされています

handlebarsとjson-投稿の最初にリンクを作成する必要がありました。

coffeescriptの場合-レシピの詳細

その他すべて-Googleによる救助



繰り返しますが、この部分は単純です。このため、すべての行は、各抽出プログラムが必要とする形式に従ってgettext / ngettextの呼び出しでラップする必要があります。 原則として、使用する機能をオーバーライドする機能も提供します。

たとえば、私はこれを持っています：

 pybabel extract -F babel.cfg -o messages.pot -k "trans" -k "ntrans:1,2" -k "__" .
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

transとntransはjavascriptに対して指定され、__はpythonに対して指定されます。この関数は文字列を透過的に送信するために使用されます（詳細は後ほど）



以上です

print（ "apple"）はprint（ngettext（ "apple"））に変換する必要があります

そしてすべて

print（ "i have％s apples"）to print（ngettext（ "I have％s apples"、 "I have％s apples"、num_of_apples）％num_of_apples）



ここで、私は誰も使用しないことを望み、名前のないパラメーターの使用を推奨しないことに注意する必要があります。

私の場合-名前付きのもののみ、つまり、次のようになります。



Python：

 print(gettext("I have an apple!")) print(ngettext( "I have %(apples_count)d apple", "I have %(apples_count)d apples", num_of_apples ).format(apples_count=num_of_apples))
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

フラスコとジャンゴには独自のラッパーがあるため、標準のgettextが使用されます



Javascript：

 console.log(i18n.trans("I have an apple!")) console.log(i18n.ntrans("I have %(apples_count)d apple","I have %(apples_count)d apples",num_of_apples,{apples_count:num_of_apples}));
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここおよびコーヒープロキシは、ここからJedメソッドに使用されます。

github.com/tigrawap/pybabel-hbs/blob/master/client_side_usage/i18n.coffee

組み込みのJed sprintfにより、パラメーターが文字列に渡されます





Coffeescript：

 console.log i18n.trans "I have an apple!" console.log i18n.ntrans "I have %(apples_count)d apple", "I have %(apples_count)d apples", num_of_apples, apples_count:num_of_apples
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ハードルバー：

 {{#trans}} I have an apple! {{/trans}} {{# ntrans num_of_apples apples_count=num_of_apples}} I have %(apples_count)d apple {{else}} I have %(apples_count)d apples {{/ntrans}}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

JSON文字列ストア：

 { "anykey":"I have an apple!", "another_any_key":{ "type":"gettext_string", "funcname":"ngettext", "content":"I have %(apples_count)d apples", "alt_content":"I have %(apples_count)d apples" } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

オフトピック：pybabel-jsonドキュメントでのこの形式の説明



num_of_applesが呼び出しごとに2回繰り返されることに気付くのは難しくないと思います。

理由は、ngettextの引数として渡されると、どの文字列を使用するかを決定し、2回目は、この文字列に代入される他の可能なパラメータとともに、文字列のパラメータとして使用するためです。



-私が言ったように-これは単純な部分で、既存のテキストをラップします。

次に必要



1）テキストのあるボタンに刻まれているすべてのボタンを変更します。 テキスト付きのボタンが悪いことは誰もが知っています。 しかし、多くの場合、これはより高速であり、設計者はそのように望んでいるため、受け入れられなければなりません:)

-この段落ではすべてが明確になります-退屈ですが、必要です



2）

もっと興味深い点は、一見一定に見える行をどう処理するかですが、どれが完全に一定ではないのでしょうか？

例として、私たちのケース-歌のジャンル-を挙げます。 それはダイナミクスのようであり、それらはデータベースに保存されますが、実際には-まれにしか変化しないスタティックであり、切り取って翻訳に送信するのが良いでしょう。



これがまさにpybabel-jsonの原因です。

このソリューションは、サードパーティのサーバーエラーメッセージへの応答など、他の翻訳の問題に対するソリューションでもあります。 これは静的であると言えますが、これは制御できない静的であり、翻訳のために美しくラップする必要があります。

必要なのは、.jsonファイルを作成することだけです

errors.json

コンテンツ付き

 { "from_F_service": [ "Connection error", "Access denied" ], "from_T_service":[ "Oops, it is too long" ] }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

キーなし、文字列のクリーン配列。

サービスがメッセージを変更した場合に発生する最悪の事態は、ユーザーが未翻訳バージョンを受け取ることです。 原則として、これらはささいなことです



データベース内のデータについては、build-push-deployシステムでの状況は何でも似ています（結局のところ、何かありますか）。 すべてを組み立てるためのコマンドがあり、すべてのbabelがデータベースから必要なすべてのデータを抽出し、同様のjsonを収集するこれらのコマンドの前にスクリプトを追加する必要がある同じレベルで、トラックによって起動されたbabelはすでにデータを収集します。

もちろん、ソース管理が落ちないように、そのようなファイルは一般的に.gitignoreまたは何かの類似物に追加する必要があります



この方法で取得されたすべての文字列は、gettext関数の呼び出しを通過する必要があります

つまり、Pythonの場合、gettext（）、js Jedまたは前述のプロキシメソッドの場合



また、逆の順序で実行する場合もあることに注意してください。 または、逆の順序で行う必要があります。

つまり、コード内で行を翻訳する必要があるが、翻訳自体は別の場所で開始されることを決定します。

Pythonで例を示します。

 class SomeView(MainView): title=gettext("This view title")
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

このようなコードを作成すると、サーバーの起動時にクラスが作成された場合は英語でクラスの作成済みコピーを取得するリスクが発生します。作成が動的であるが最初の呼び出しでキャッシュされた場合は中国語版など



そのような場合、翻訳に注意したいが、正しい場所で翻訳したい

適切な場所は、クラスではなくオブジェクトを作成することです

つまり

 def __(string,*k,**kwargs): return string class MainView(SomeParent): def __init__(self): #.... self.title=gettext(self._title) #.... class SomeView(MainView): _title=__("This view title")
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

つまり、文字列コレクタは__を翻訳用の文字列として定義し、関数自体は何も実行せず、適切なタイミングで翻訳が開始されます。

したがって、すべてが1つの場所にあり、美しく見えます。



これは、node.jsで記述する場合、coffeescriptやjavascriptを含む多くの言語に適用されます。

ブラウザにとっては、クラスの作成時でも、どの言語を作成するかがすでにわかっているはずなので、これはあまり意味がありません。



ただし、いずれにしても、クラスの作成時ではなく、コンストラクターで翻訳する方が正確です。



私に知られている翻訳の方向のすべての可能性をバイパスしたようです。これがすべて行われたとしましょう。

すべてを一緒に接着する

これですべてを収集できます。いくつかの簡単な手順があります。

0）ファイルがない場合に将来誓わないように、元の行の空のディレクトリを作成します

 touch messages.pot
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

1）ターゲット言語の.poファイルを作成するこれは1回行われ、ビルドに含めるべきではありません。 .poファイルは、各言語の元の行とそれらへの翻訳の両方を含むファイルです。

 pybabel init -i messages.pot -d path/i18n -l es #   .po      path/i18n/es (   i18n  ) #   ,   : (   ,       echo?, echo   ) echo {es,en,fr,de,ja} | xargs -n1 pybabel init -i messages.pot -d path/i18n -l
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

2）.potファイル（行のメインリポジトリ）を作成/更新します。これもビルドには含まれませんが、翻訳のために送信される新しい.poファイルを受信する必要がある場合に実行する必要があります。

 python/node/your_language update_translation_jsons #      pybabel extract -F babel.cfg -o messages.pot -k "trans" -k "ntrans:1,2" -k "__" . #    # trans -    , ntrans -  # __  ""    # babel.cfg -  babel-     pybabel update -i messages.pot -d path/i18n/ # .po    ,
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここでは、babel.cfgファイルの例を示すのは不要です。これは、どのファイルからどのファイルから文字列を抽出するかを示すマッピングファイルです。

 [python: path/backend/notifier.py] [hbs: path/static/**.hbs] [json: path/static/i18n/src/**.json] [javascript: path/static/**.coffee_js] encoding = utf-8
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

3）すべての.poファイルをpo2jsonで実行して.jsonを取得します。これはJedが受け入れます。

これはビルドに含めることができ、含める必要があります。

あなたができないことはgitで許可することです。彼らはそこに属していません。



すべての.poファイルを正確にフィードする方法とそれらを配置する場所は、ユーザーの良心にかかっています。

ビルドの残りの部分と同じように、私はそれらをうなり声で実行します。

githubとグラントリポジトリにあるgrunt-po2jsonは、名前変更をサポートしていないため壊れていますが、必要です。すべての最終的な.jsonファイルが同じディレクトリに移動する方が便利であるため、ローカルに修正しましたが、それを送信する必要がありますケースプルリクエスト...



もちろん、po2jsonをインストールした後（ npm install po2json ）、ビルドスクリプトに同様のものを含める方がはるかに簡単です。

 echo {es,en,fr,de,ja} | xargs -n1 -I {} po2json /path/i18n/{}/LC_MESSAGES/messages.pot /path/to/build/i18n/{}.json
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ストリームに含まれていないが、注意を引く意味がある

ポストの間に彼は何度か「後でもっと」と約束しましたが、後で適切な場所はありませんでした。



例えば：

coffeescriptには独自の抽出機能がありません。これは、staticsを構築するときに、coffeescriptがjavascriptでコンパイル（または翻訳）されるためです。

したがって、javascriptへの変換後に.js文字列のアセンブルを開始するだけで十分です。

私の場合、すべてが少し間違っています。各コーヒーファイルの隣にはcoffee_jsファイルがあります。これは、編集時にgrunt watchを使用して作成され（そして静的を再起動しますが、これは別の投稿のトピックです:)）、これらのファイルはそれ自体gitaの外にあります。 ここにそれらからの線があります



-ドメインの言及もありました。

ドメインは最終的に異なるファイル、messages.pot / messages.po =ドメインメッセージです

複数のドメイン名を作成したり、すべてのドメイン名をJedインスタンスにバインドしたり、複数の異なるJedインスタンスを作成してそれらにリダイレクトしたりできます。

しかし、このためには、ヘルパーハンドルバーまたは他のラッパーを拡張する必要があります...私はそのような必要性は一度もありませんでしたが、原則として事前に余分なことは何もしないことを好みます:)



-導入ブロックのtexへの小さな脚注

「リンゴが1個あります」、「リンゴが7個あります」など、もう少し美しいメッセージをユーザーに表示する場合は、メイン言語を英語にする必要があります。

ngettextの呼び出しでは、「リンゴが1つある」ではなく、「you have％（apples_count）d apples」と記述する必要があることを理解する必要があります。

なぜなら、1つの場合と21番目の場合、最終行は最初の形式である必要があります-つまり、「You have％d apple」



-自動レベルでまだ解決できていない1つの問題に焦点を当てることも重要です。

babelは、Jedと互換性のない形式で「空行」（言語とその複数行を決定する.poファイル構成）を作成します

Jedは、複数形がそこにあることを期待しますが、バベルは複数形を発行します

ここでは、babelの出力、Jedの入力、またはそれらの間を編集する必要があります。

しかし、最初に、両方の構成を見てください。



何かを見逃した、記述しなかったなど -コメント、補足に書き込みます。

目標は、各ユーティリティを詳細に分析することではなく、これらの存在と、それらがどのように、そしてどのように正確に連携するかについて話すことでした。

残りはコメントで場所を見つけます