CLI バージョン0のロケールを追加・管理する
目的に合った言語のバリエーションを選び、旧バージョンで翻訳先を追加して、ファイルとアプリケーションの動作を確認します。
バージョン0では、locale.sourceで原文の言語を指定し、locale.targetsで継続的に翻訳する言語を選択します。読者に合った言語のバリエーションを選び、設定、ファイル名、バックエンド、アプリケーションで一貫して使われていることを確認してください。
翻訳先を一つ追加する #
既存のスペイン語とフランス語に加えてドイツ語にも対応するには、i18n.jsonを編集します。
{
"locale": { "source": "en", "targets": ["es", "fr", "de"] }
}その翻訳先を指定して、インストール済みのバージョン0のバイナリを実行します。
lingo run --target-locale deこのフラグは、今回の実行に限って翻訳先リストを上書きします。設定にないロケールも指定できますが、今後の実行でも使う場合は設定に追加してください。ファイルを分けるパターンlocales/[locale].jsonを使うと、locales/de.jsonが書き出されます。読者向けにドイツ語を有効にする前に、値を確認し、そのファイルをアプリケーションで読み込んでください。
翻訳先がまだ存在しない場合は、選択したすべてのキーが必要です。すでに存在する場合は、通常、既存の値を保持し、不足しているキーを補います。ただし、原文が変更されていれば再翻訳が必要になることもあります。承認済みのほかのロケールをそのままにしておきたい場合は、新しい言語の初回追加と広範囲にわたる強制実行を同時に行わないでください。
実行対象を特定の翻訳先ロケールに絞っても、既存の原文チェックサムの基準値は更新されません。その後の通常実行で、変更された原文が再び処理される可能性があります。対象を絞ったレビューで恒久的に確定したと判断する前に、確定ルールに従ってください。
必要に応じて地域と文字体系を指定する #
{
"locale": {
"source": "en-US",
"targets": ["en-GB", "es-MX", "pt-BR", "fr-CA"]
}
}地域を指定したロケールでは、求められる表記や語彙の違いを区別できます。英語で「色」を表す語の綴りの違い、スペイン語で「コンピューター」を表す「オルデナドール/コンプタドーラ」、ポルトガル語で「列車」を表す「トレン/コンボイオ」など、言語だけの指定では不十分な場合があります。ただし、用法は文脈にも左右されます。タグを指定しても、生成されるすべての表現が読者に適しているとは限りません。中国語でも、zh-Hansやzh-TWのように文字体系や地域を区別する必要がある場合があります。
インストール済みのバージョンに対応する一覧を確認します。
lingo show locale sources
lingo show locale targetsこれらの一覧は、すべてのバックエンドでの対応や品質を保証するものではありません。過去の対応言語数に頼るのではなく、選んだ言語の組み合わせで小規模に実行し、結果を確認してから対象を広げてください。
言語の識別とファイル構成を分けて考える #
旧バージョンの処理では、プラットフォームごとに異なる複数の表記をAPIリクエスト用に正規化します。一方、ファイルにはアンダースコアやアンドロイドのリソース命名規則が必要な場合があります。区切り文字の設定と形式ごとの配置規則を使い、実際の出力先を確認してください。
翻訳しても、dirの設定、操作部品の左右反転、ルーティングの追加は行われません。アラビア語、ヘブライ語、ペルシャ語、ウルドゥー語では、一般に右から左への表示が必要です。コンテンツを表示する画面で、埋め込まれた数字や識別子も含めて確認してください。アプリケーション側でも、コンテンツを読み込むだけでなく、新しいロケールを認識する必要があります。
翻訳先を削除する #
locale.targetsからコードを削除すると、以降の実行では選択されなくなります。既存のファイルは残るため、保持するか、配信を停止するか、削除するかは別途判断してください。完全削除はデータを破壊する操作で、原文のコンテンツも対象になり得ます。設定からロケールを削除する操作とは異なります。