Gettext

メッセージのコンテキストとソースの識別情報を保持し、複数形の再構築の制約を踏まえながら、POの翻訳先の値を翻訳します。

Gettextは、原文と訳文を同じエントリに保持します。poファイルハンドラーはmsgidを読み取り、原文を残したまま訳文をmsgstrに書き込みます。また、msgctxtを使い、異なる状況で使われる同じ単語を区別します。

コンテキストでメッセージを区別 #

たとえば、次のエントリでは、同じ「バック」という単語に異なる訳を付けられます。

text
msgctxt "checkout navigation"
msgid "Back"
msgstr ""

msgctxt "product surface"
msgid "Back"
msgstr ""

これらはmsgidが同じでも、別々の単位として扱われます。コンテキストは翻訳のヒントとしても提供されます。コメント行とフラグ行はエントリとともに保持されますが、すべてのコメントが指示として解釈されたり、レビューフラグが更新されたりすることを保証するものではありません。

このパーサーは、サポート対象の引用符付きPOフィールドと継続行に処理範囲を絞っています。入力にはUTF-8を使用してください。任意の従来の文字エンコーディングを変換する機能はありません。.potの自動検出は、CLIの.poの推論で保証される範囲には含まれません。

複数形の再構築には制約があります #

複数形のエントリでは、msgidとmsgid_pluralが、それぞれ単数形と複数形の独立したテキスト単位になります。ハンドラーは、翻訳先のスロットを少なくとも2つ生成します。既存の翻訳先にそれより多くのスロットがある場合、変更のないエントリでは承認済みの語形が保持されます。最初の2つの翻訳先の語形のどちらかが変更されると、追加のスロットには、個別に生成された語形ではなく、新しい複数形の値が入ります。

コンパイルする前に、複数形の出力をレビューしてください。複数の異なる語形が必要な言語では、各スロットに正しい文言を設定し、それに合ったPlural-Formsヘッダーを用意する必要があります。既存の翻訳先ヘッダーが優先されます。初回の出力ではソースのヘッダーが引き継がれ、Languageが翻訳先のロケールに変更されます。ハンドラーは、翻訳先の言語に合わせてPlural-Formsを書き換えることはありません。

更新とシリアライズ #

前回のソースを基準に、コンテキスト、メッセージの識別情報、単数形・複数形の単位ごとに変更を識別します。保持するmsgstrの値は、既存の翻訳先エントリから取得します。ソースの識別情報を変更すると、承認済みの訳文を引き続き利用できる場合でも、そのメッセージが新規と見なされることがあります。

再構築では、ソースのフィールド、コメント行、エントリ前後のレイアウトを保持しながら、msgstrの値と該当するヘッダーを置き換えます。引用符で囲まれた訳文の値は、書式が変更される場合があります。ファイルの解析に加え、メッセージ数と複数形のメタデータも検証してください。

カタログの設定とコンパイル #

CLIは.poからpoを推論します。CLIの設定またはGitHubでソースカタログを選択してください。

アプリケーションのGettextツールで出力をコンパイルまたはインポートし、さまざまな数量での複数形の表示と、コンテキストに応じた検索をテストしてください。解析に成功した場合でも、複数形の値の重複とヘッダーを確認してください。これらによって、数量ごとにアプリケーションが表示する内容が決まります。