CLI v0で選択したコンテンツを再翻訳する

対象範囲を管理し、承認済みの編集内容を守りながら、原文や指針の変更に合わせて従来の翻訳を更新します。

原文が変わった場合は、通常実行を使います。原文に変更がなくても、新しい指示を翻訳に反映したい場合や、納得のいかない訳文を置き換えたい場合は、強制実行を使います。どちらの場合も、通常の手動編集が上書きされる可能性があります。

原文の変更に応じて通常実行の対象を決める #

sh
lingo run
原文と翻訳先の状態v0での通常実行の結果
原文の値が前回のチェックサムに対応する値から変わっている変更された値を翻訳します。
原文のキーが翻訳先に存在しない不足しているコンテンツを翻訳します。
原文のキーが削除されている対応する管理対象の翻訳先エントリを削除します。
新しいキーの原文の値のチェックサムが、削除されたキーの原文の値のチェックサムと一致するその処理のコンテキスト内で翻訳を再利用します。
翻訳先の値が存在し、原文に変更がない翻訳先の値を保持します。

通常の手動修正は、原文が変わらない限り維持されますが、その後のあらゆる更新で維持されるわけではありません。保持対象のキーでは、人が管理する値を別に確保します。

影響を受ける翻訳を一つ更新する #

モデル、プロンプト、用語集、ルールを変更したら、まずは影響を受けるロケールとキーから始めます。

sh
lingo run --force --target-locale es --key welcome/title

ここでは、welcome/titleがwelcome内のtitleを指定します。0.138.10の実行コマンドでは、完全一致のキー、境界を考慮したプレフィックス、グロブを指定できます。シェルによる展開を避けて配下のキーを選択するには、--key 'welcome/**'を引用符で囲みます。

翻訳結果を原文と並べて確認し、アプリケーションでも読み込んで確認します。ロケールやキーで範囲を絞った処理では、既存の共有ベースラインは更新されません。後の通常実行で同じ原文の変更が予期せず再処理されないよう、Lockfileの確定ルールに従ってください。

大規模なプロジェクトでは管理しやすい処理範囲を選ぶ #

--target-locale、--bucket、--file、--keyは、繰り返し指定できるセレクターです。--source-localeは、その実行で使用する原文を変更します。未設定のファイルを任意に指定するのではなく、設定済みのバケットとパスの一覧から対象を絞り込んでください。

sh
lingo run --target-locale es --bucket json --file 'apps/web/**'

実行コマンドのファイル照合では、検出された設定済みパスに対して、部分文字列またはミニマッチによる照合を使用できます。パージコマンドのファイル照合は部分文字列のみで、キーの照合方法も異なります。両コマンドでセレクターを流用する際は、必ず選択されるエントリを確認してください。

意図的により広い範囲を更新する場合は、次のようにします。

sh
lingo run --force --bucket json --target-locale es

これにより、選択したスペイン語のJSONコンテンツをすべて再生成できます。lingo run --forceを単独で指定すると、設定済みのプロジェクト全体が対象になります。範囲を広げる前に承認済みの出力を保護し、Lingo.devのバックエンドを使用する場合は、同じ強制実行範囲で見積もりを行ってください。

大規模な変更では、ファイルとロケールで対象範囲を分けると、差分をレビューしやすくなります。処理が失敗しても、成功した処理単位の出力は保持し、全体を強制実行する前に該当範囲を再試行してください。並列処理が制御するのはスループットであり、対象の選択やロールバックではありません。

画面の翻訳カタログとドキュメントは、それぞれの形式に対応するバケットに分け、自動生成コンテンツと下書きは除外してください。翻訳先やローカライゼーションエンジンが異なる場合は、パッケージ設定を分けます。継続的インテグレーションでは、lingo run --frozenが翻訳を行わずに信頼できるベースラインを検証します。失敗を抑え込むためにチェックサムを再構築するのではなく、原因を調査してください。現在のランナーの実行手順では別のパッケージと設定を使用するため、採用する前に移行してください。

削除が目的の場合にのみパージを使う #

従来の「パージしてから実行する」手法は、翻訳先のキーを欠落状態にし、通常の不足分補完処理の対象にするものです。この方法では再生成が成功する前に出力が削除されるうえ、性能が向上することも確認されていません。パージのリファレンスで、パージ固有のセレクターとソースロケールに関するリスクを確認してください。再生成とレビューが成功するまでは、復元可能なコピーを保持してください。