アプリケーションのローカライズNode.js。 パート2：ツールとプロセス

翻訳者から：これは、 ペルソナプロジェクトに関係する、Mozilla IdentityチームによるNode.jsシリーズの 10番目の記事です。

---

Node.jsアプリケーションのローカライズに関する以前の記事では、コードでi18n-abideモジュールを使用する方法を学びました。 プログラマーとしての私たちの仕事は、実際にはテンプレートで行をラップし、 gettext()



呼び出しでアプリケーションコードをラップしたという事実で終わりました。 しかし、アプリケーションのローカライズと翻訳の作業はまだ始まったばかりです。

ツールキット

Mozilla Personaチームのローカライズツールキットは、他のMozillaコミュニティで使用されているツールと互換性がありますが、Nodeに固有の親しみやすさと柔軟性の利点を保持しています。



Mozillaプロジェクトはほぼ15年前であり、ローカライザーと翻訳者のチームはオープンソースの世界で最大の（そしてクールな）チームの1つです。 そのため、古くておしゃれなツールといってもよいほど、馴染みのあるものを長い間広く使用しています。

Gettext

GNU Gettextは、デスクトップおよびWebアプリケーションをローカライズするために設計されたツールキットです。 Nodeのコードとテンプレートを書くときは、どこでも英語のフレーズを使用しますが、それぞれをgettext()



呼び出しでラップします。



gettextは2つのことを行います。

• アセンブリ中に、アプリケーションで検出されたすべての行のディレクトリをコンパイルします。
• 実行時にそれらをローカライズされたオプションに置き換えます。

抽出されたすべての行は、拡張子が.po



テキストファイルに保存されます。将来、これらをpoファイルと呼びます。

Poファイル

Poファイルは、gettextが読み取り、書き込み、および結合できる特定の形式のテキストファイルです。



zhTW / LCMESSAGES / messages.po poファイルの内容の例を次に示します。

 #: resources/views/about.ejs:46 msgid "Persona preserves your privacy" msgstr "Persona 保護您的隱私"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

後で詳しく検討しますが、ここでmsgid



は英語の文字列であり、 msgstr



は中国語への翻訳であることを理解することが重要です。 #



で始まるものはすべてコメントです。 この例のコメントは、コード内のこの行の場所を示しています。



Gettextは、文字列とpoファイルを操作するための多くの他のツールを提供します。 私たちもそれらに触れます。

なぜこのツールキットなのか

gettextを使用するためのNode.jsモジュールの詳細な調査に入る前に、なぜこの特定のツールセットを選択したのかを自問する必要がありますか？



1年前、国際化とローカリゼーションのための既存のNode.jsモジュールを詳細に調べました。 それらのほとんどは、文字列を保存するための独自の自転車とJSONベースのフォーマットを発明しました。



一方、MozillaはPOEdit 、 Verbatim 、 Translate Toolkit、 Pootleなどのツールを長く使用してきました。 人々に再学習を強いる代わりに、使い慣れた標準やプロセスと互換性のあるツールを開発することにしました。



Poファイルは、翻訳者の交換と協力のための一般的な形式です。 翻訳のために私たちから行を受け取り、完成したテキストを提供するのはこの形式です。



MozillaでPHPとPythonに戻って多くの開発経験があるので、Gettextは非常に便利です。 Webアプリケーションが成長し、より多くのテキストが含まれるにつれて、十分にテストされたツールとGettext APIの使用を必要とするニュアンスがますます現れます。

翻訳者用のpoファイルを作成します

そのため、コードをgettext呼び出しでマークアップしました。 次は？ 「ストリングドライバー」と呼ばれるものが実行されます。 あなた自身、翻訳者、または管理者になります。 文字列ドライバーは何をしますか？

• アプリケーションに最初に現れた行を取得します。
• 後続のリリースで、変更された新しい行を検索するか、削除された行をマークします。
• 翻訳者のチームごとにpoファイルを準備します。
• 競合を解決し、変更または削除された翻訳文字列をマークします。

これは少しわかりにくいかもしれませんが、幸いなことに、これらのタスクのほとんどは自動化されています。 問題が発生した場合にのみ、ラインマンが介入する必要があります。



msginit、xgettext、msgfmt、およびその他のGNU Gettextツールは、行ディレクトリを操作するための強力なセットです。 これらのツールでは、文字列コードのみが機能します。 ほとんどの開発者は、それらに気付かないままでいることができます。



ロケールのファイルツリーを作成します。

 $ mkdir -p locale/templates/LC_MESSAGES
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

このディレクトリには、poファイルテンプレート.pot



ファイルが格納されます。 これらは将来gettextで使用されます。

行の取得

前回の記事では、i18n-abideをインストールしました。

 $ npm install i18n-abide
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

他のコマンドラインツールの中でも、abideは抽出ポットを提供します。 このコマンドは、ロケールディレクトリ内の文字列を取得するために使用されます。

 mkdir -p locale/templates/LC_MESSAGES $ ./node_modules/.bin/extract-pot --locale locale
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

スクリプトは、アプリケーションのソースコード全体を調べ、行を見つけてpoテンプレートファイルに書き込みます。



従来のgettextユーティリティを使用してpotファイルを作成できますが、便利でクロスプラットフォームな特別なjsxgettextモジュールを作成しました。 フードの下で、extract-potはそれを使用します。



Jsxgettextは、コード内でgettext()



呼び出しを検索し、それらから文字列引数を抽出してから、gettextツールキットと互換性のある形式で文字列をフォーマットします。 このようなポットファイルからの抜粋を次に示します。

 #: resources/views/about.ejs:46 msgid "Persona preserves your privacy" msgstr "" #: resources/views/about.ejs:47 msgid "" "Persona does not track your activity around the Web. It creates a wall " "between signing you in and what you do once you're there. The history of " "what sites you visit is stored only on your own computer." msgstr "" "" #: resources/views/about.ejs:51 msgid "Persona for developers" msgstr ""
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

後で、翻訳付きのpoファイルがこのテンプレートに基づいて作成されます。 次のようになります。

 #: resources/views/about.ejs:46 msgid "Persona preserves your privacy" msgstr "Persona 保護您的隱私" #: resources/views/about.ejs:47 msgid "" "Persona does not track your activity around the Web. It creates a wall " "between signing you in and what you do once you're there. The history of " "what sites you visit is stored only on your own computer." msgstr "" "Persona 只是連結您登入過程的一座橋樑，不會追蹤您在網路上的行為。您的網頁瀏覽" "紀錄只會留在您自己的電腦當中。" #: resources/views/about.ejs:51 msgid "Persona for developers" msgstr "Persona 的開發人員資訊"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

トピックの感触を良くするために、中国語用のpoファイルの完全版をご覧ください 。

ロケール作成

Gettextセットのmsginitコマンドを使用して、テンプレートファイルに基づいて特定のロケールのpoファイルを作成します。

 $ for l in en_US de es; do mkdir -p locale/${l}/LC_MESSAGES/ msginit --input=./locale/templates/LC_MESSAGES/messages.pot \ --output-file=./locale/${l}/LC_MESSAGES/messages.po \ -l ${l} done
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

アメリカ英語、ドイツ語、スペイン語用のpoファイルを作成しました。

Poファイル

そこで、行を抽出し、ロケールフォルダーを作成しました。 これがファイルツリーの外観です。

 locale/ el/ LC_MESSAGES/ messages.po en_US LC_MESSAGES/ messages.po es LC_MESSAGES/ messages.po templates LC_MESSAGES/ messages.pot
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

アプリケーションのこれらの部分には、翻訳者へのアクセス権を付与できます。 たとえば、スペインのチームはlocale/es/LC_MESSAGES/messages.po



アクセスできlocale/es/LC_MESSAGES/messages.po



。 非常に大規模なプロジェクトがある場合は、スペイン語版とアルゼンチン語版のスペイン語用に、es-ESとes-ARの2つの個別のロケールが存在することもあります。



時間が経つにつれて、新しいロケールが追加される可能性があります。

行の変更をマージ

リリースごとに新しい行を追加し、古い行を変更および削除します。 これらの変更に応じて、すべてのpoファイルを更新する必要があります。 Gettextには、このための強力なツールがあります。 私たち自身のために、GNU Gettextパッケージのmsgmergeコマンドを使用するmerge-po.shスクリプトラッパーを作成しました。



i18n-abideツールをシステムパスに追加します。

 $ export PATH=$PATH:node_modules/i18n-abide/bin
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

行のマージプロセスを開始します。

 $ ./node_modules/.bin/extract-pot --locale locale . $ merge_po.sh ./locale
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

初めてと同様に、extract-potはすべての行を収集し、テンプレートを作成します。 次に、merge-po.shはすべてのpoファイルを更新し、それらを現在のバージョンのアプリケーションに合わせます。 その後、翻訳チームが再び仕事を引き受けることができます。

Gettext vs. Invented Not Here症候群

gettextの代わりに独自のJSONベースのバイクを発明することは大したことではありません。 Nodeモジュールのほとんどの作成者は、このパスを選択しています。 しかし、アプリケーションが成長し、新しい言語が追加されると、小さな問題が雪だるま式のように成長します。 たとえば、merge-po.shがない場合、遅かれ早かれ、独自のマージツールを作成してデバッグする必要があります。 30個のロケールの30個のファイルを、紛失したり混乱させたりすることなく、手動で更新します。それでも混乱です。



また、gettextには必要なものがすべて揃っているため、時間と神経が大幅に節約されます。

おわりに

poファイルを作成および更新する方法がようやくわかったので、翻訳者の注意に委任できます。 一般に、常に事前に話し合い、いつ転送を開始できるか、どのボリュームが予想されるか、いつ完了することが望ましいかについて話し合うことをお勧めします。 gettextのドキュメントを勉強するのにも役立ちます。



したがって、行は翻訳されています。次の記事では、アプリケーションの実行中にローカライズがどのように機能するかを学習します。

---