すべてを再翻訳せずに言語を追加する

承認済みの翻訳を保持したまま、新しい翻訳先ロケールを追加し、アプリケーションで新しいリソースを利用できることを確認します。

言語の追加には、翻訳対象への指定、リソースの作成、アプリケーションでの読み込みという三つの作業が必要です。画面に新しい言語の選択肢を追加しても、その言語のカタログは作成されません。また、カタログを翻訳しただけでは、ルートでそのカタログが使われるようにはなりません。

まず、復元可能な原文と承認済みの翻訳を用意します。追加するロケールを記録し、必要に応じて地域や文字体系も指定してください。pt-BRとpt-PTは異なる利用者層を指し、求められる表現も異なる場合があります。

既存の構成とガイダンスを確認する #

原文のパターン、現在の翻訳先、想定する出力パスを一覧にします。翻訳先ファイルが言語ごとに分かれていれば、個別に追加できます。一方、共有のXcode文字列カタログでは、一つのファイルに複数のロケールを格納するため、ファイルの有無だけでは対応範囲を判断できません。

新しい利用者層に向けて、モデルの対応範囲、用語、文体、語り口を確認します。近いロケールのガイダンスは、適用できる部分だけ再利用してください。用語を共通にできても、呼びかけ方の慣習は異なる場合があります。右から左に書く言語への対応には、文字列の翻訳だけでなく、アプリケーションの表示方向やレイアウトの調整も必要です。

現在のCLIプロジェクトに翻訳先を追加する #

現在のCLIでは、翻訳先を.lingo/config.json内のtargetLocalesで指定します。pushに--target-localeや--localeのオプションはありません。モノレポでは、作業ディレクトリによってどのプロジェクト設定が選択されるかを確認してください。

翻訳先を追加する前に、lingo push --waitを使い、既存の言語で未処理になっている通常の原文更新をすべて完了させます。レビューを終えて出力を取得し、各言語の翻訳を現在の原文と照合してください。新しい言語を追加する間は、その原文のリビジョンを固定します。

バックフィルでは、既存の翻訳先ファイルは変更されません。新しい言語のファイルだけを作成する場合は、既存の原文のベースラインが保持されるため、その後の通常のプッシュでも、ほかの言語に対する未処理の編集を処理できます。先にそれらの更新を完了しておけば、既存の翻訳先と新しい翻訳先を、同じレビュー済みの原文リビジョンにそろえられます。

次に、インストール、認証、リンクが完了したプロジェクトの設定に翻訳先を追加し、不足しているファイルに対して予定されている処理を確認します。

sh
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait

見積もりでは翻訳は行われず、ジョブも作成されません。ただし、処理計画を立てるために、サーバーにないファイルがアップロードされます。オフラインの処理ではなく、料金を保証するものでもありません。バックフィルは設定されたパターンを調べ、不足している翻訳先ファイルを作成します。既存の翻訳先ファイルに新しいキーを追加するものではありません。新しいロケールが最新の状態になった後は、通常の原文変更に対して、保存済みのベースラインを基にlingo push --waitを使います。

共有のXCStringsカタログでは、一つのファイル内でロケールごとに処理が計画されます。iOSワークフローに沿って、新しいエントリを確認してください。

リクエストの対象を一つのロケールに限定する必要がある場合は、管理されたブランチまたはジョブ設定でtargetLocalesの対象を絞り、処理後に全ロケールの一覧を元に戻します。新しい言語を対象にするためだけに、強制オプションを追加しないでください。対象範囲内の既存の翻訳も再翻訳され、レビュー済みの表現が置き換わるおそれがあります。こうした違いはプッシュで説明しています。旧世代のフラグについては、CLI v0のロケールリファレンスを参照してください。

アシスタントにも同じ制約を伝える #

エージェントは、構成の確認、ロケール向けガイダンスの提案、設定の差分の準備を行えます。ローカルファイルと組織が所有するローカライゼーションエンジンの設定のうち、どちらの変更を許可するのか、または両方を許可するのかを指定してください。それぞれの権限の違いは委任で説明しています。

適用されるプライマリモデルとフォールバックモデル、共通のガイダンスとロケール固有のガイダンスについて説明するよう依頼します。出力を比較する前に、保存されている状態を確認してください。選択の仕組みはロケールの解決で説明しています。モデルの優先設定は、言語品質のベンチマークではありません。

新しい利用者層に向けた結果を検証する #

返されたパスと差分を、意図した対象範囲と照合します。原文の更新や許可された修正に伴う変更を除き、既存の承認済み翻訳が変更されていないことを確認してください。アプリケーションのリソース用ツールで、変数、複数形の分岐、ロケールのメタデータを検証します。

新しいロケールで代表的なコンテンツを読み込みます。意味に加え、フォールバック、表示領域からのはみ出し、表示方向も確認してください。対応範囲を広げる前に、測定に使えるよう原文のリビジョンと結果を保存します。

設定からロケールを削除すると、新しい作業の対象には選ばれなくなりますが、リソースや実行時のルートは削除されません。それらを変更するかどうかは、別途判断してください。特に、一つの共有カタログに原文と複数の言語が含まれている場合は注意が必要です。