ロケールをルートに持つYAML
単一のロケールルート配下にある値を翻訳し、ルート名を翻訳先の言語に合わせて変更します。
Railsは、YAMLファイルのルートからロケールを読み取ります。ファイル名がcheckout.es.ymlでも、ルートがen:であれば、英語のリソースとして定義されます。yaml-root-keyハンドラーは、ルート配下のメッセージを翻訳するとともに、ルートを翻訳先のロケールに変更し、言語間で参照パスの一貫性を保ちます。
ロケールラッパーとメッセージパス #
原文カタログには、変数の埋め込みと複数形の分岐の両方を含められます。
en:
checkout:
greeting: Hello, %{name}
items:
one: One item
other: "%{count} items"メッセージパスはcheckout.greeting、checkout.items.one、checkout.items.otherです。これらのパスにはenが含まれないため、英語の原文とスペイン語の訳文で同じメッセージを対応付けられます。翻訳先のラッパーはesに変わりますが、checkout、one、otherはキーとして保持されます。
変数の埋め込み構文と複数形のカテゴリ名は、アプリケーションの仕様の一部です。文言を翻訳するだけでは、Railsの複数形ルールは設定されず、翻訳先の言語に必要なカテゴリがすべて追加されるわけでもありません。リソースを採用する前に、該当する数量や変数を使い、アプリケーション上で表示を確認してください。
パーサーは、スカラー型のキーと、その配下のマッピングからなる単一のルートペアを必要とします。空のロケールは使用できますが、ルート直下にスカラー型のメッセージやリストを置くことはできません。複数のロケールを含むYAMLファイルは、ロケールごとのファイルに分割してください。すべてのルートを変更せずに保持する場合は、汎用YAMLを使用してください。OpenAPI仕様には、このハンドラーを使用しないでください。
更新と対象範囲の限定 #
入れ子になった文字列値は、ロケールラッパー配下のパスに基づいて比較されます。構造は現在の原文に従い、前回の原文と既存の訳文を使って、変更のない値を引き継ぎます。コメントとアンカーはYAMLツリーのシリアル化処理を経るため、書式が正規化される場合があります。
前回の原文を指定すれば、対象範囲をキー単位や用語単位に限定しても、変更のない翻訳を再利用できます。CLIの--keyは保存済みのベースラインを使用し、--forceを追加しても、この再利用は無効になりません。文言を意図どおりに修正するには、訳文を直接編集してください。翻訳指針の変更後にファイルを再生成する場合は、承認済みの訳文を保存し、対象範囲を指定してファイル全体を処理する--forceを--keyなしで実行してから、変更されたメッセージをすべて確認してください。
キー単位で対象範囲を指定すると、範囲外のマッピングにある未解決の文字列は省略される場合があります。シーケンスの要素は位置をずらさず、原文の値を保持します。特に、狭い対象範囲から新しいロケールを作成する場合は、解析が成功したかどうかとは別に、内容に不足がないか確認してください。
ロケールと出力先の設定 #
原文が.ymlまたは.yamlの場合は、format: "yaml-root-key"を明示的に設定してください。拡張子だけではロケールラッパーを識別できません。ファイルパターンと翻訳先のファイル配置については、CLIの設定とGitHubを参照してください。
再構築には翻訳先のロケールが必要です。指定がない場合、再構築は失敗します。CLIのlocaleFormatが変更するのはパスの表記であり、YAML内に記述されるロケールではありません。出力先とそのルートの両方を確認し、Railsを通じて挨拶と複数形のメッセージを読み込んでください。Railsアプリのローカライズでは、これらのファイルと、リクエストのロケール選択、ヘルパー、フォールバック動作との連携について説明しています。