更新時もレビュー済みの翻訳を保持する
原文と承認済み訳文の基準データをセットで保存し、適切な更新モードを選んで、何が変わったかを正確に確認します。
承認済みの翻訳は、保持する価値のある作業の成果です。原文のメッセージが一つ変わっても、その周囲の訳文は正しいままかもしれません。ワークフローに適切な基準データを渡し、意図したマージ処理を適用すれば、正しい訳文を再利用して保持できます。
「差分更新」という言葉だけでは、こうした保護が働くかどうかは分かりません。以前の原文と承認済みの訳文を保存し、呼び出し側の更新仕様を選んだうえで、実際の差分を確認してください。訳文の修正対象が分かっている場合は単一キーの更新を使い、送信済みの処理が途中で止まった場合は復旧から始めてください。
変更すべき内容と保持すべき内容を両方記録する #
次の原文を例に考えてみましょう。
{
"retention": "Reports remain available for 30 days.",
"support": "Contact support",
"productName": "ExampleApp"
}原文の管理者が保存期間を60日に変更したとします。変更前の原文、新しい原文、レビュー済みの訳文を保存してください。訳文の期間は変更する必要がありますが、承認済みのsupportの表現はそのまま残す必要があります。productNameを原文と同一に保つことと、レビュー済みの訳文表現を保持することは、別の要件です。
承認済み訳文の最新リビジョンを、ダウンロード後にローカルで加えた編集やその理由とともに保存してください。サーバー上の基準データと作業ツリー内の訳文は、すでに内容が異なっている可能性があります。
原文の変更には通常の差分計画を使う #
現在のCLIでは、通常のlingo push --waitが、記録された原文の状態と訳文をもとに変更を計画します。設定、原文、承認済みの訳文、.lingo/lock.jsonをバージョン管理に含めてください。Lockfileを削除すると、計画の内容が変わります。影響のない単なる再読み込みではありません。
--backfill-missingが補うのは、不足している訳文ファイルです。既存ファイル内の欠落したキーや変更されたキーをすべて補うわけではありません。位置引数で指定する原文パターンでは、対象範囲を限定して計画するため、再利用の動作も異なります。--forceは、選択した個別ファイル形式の訳文を再生成するため、承認済みのテキストを置き換える可能性があります。一方、共有のXCStringsカタログでは、埋め込まれた翻訳を引き続き再利用できる場合があります。置き換えを要求する前に、プッシュのリファレンスで適切な方法を選んでください。
広範囲に実行する前に対象範囲を確認し、必要に応じて見積もりを行ってください。取得後は、変更された値と、その周囲の承認済みの値を比較します。保持されたかどうかは、実行時のラベルではなく、結果を見て判断してください。
原文のロックと訳文の保持を区別する #
対応しているキーをロックすると、原文のテキストが訳文にコピーされます。保持するキーでは、既存の訳文の値が維持されます。そのため、レビュー済みのフランス語メッセージをロックすると、英語に置き換わることがあります。フランス語の表現を保護する機能ではありません。
キーの制御方法は形式によって異なります。キーを出力から除外することも、また別の動作です。原文の事実関係が変わった値は、無条件に保持しないでください。古い意味が残るおそれがあります。
取得時にローカルの修正との整合性を取る #
更新を送信する前に、既存の修正を保存してください。プッシュ時に取り込まれた訳文そのものが、その更新での置き換え対象になります。送信後の編集を検出するには、--waitを指定せずに実行し、その後でlingo pull --dry-runを確認してください。プルは、ローカルの訳文を、取り込まれた訳文および記録されたハッシュと比較します。その後の編集を上書きしないよう、処理を拒否することがあります。push --waitから直接ダウンロードする場合、この時点での再確認は行われません。
競合が発生した場合は、ローカルの修正、記録された訳文、新たに取得する結果を、関連する原文の各リビジョンと照らし合わせて比較してください。引き続き適用できる修正は、通常のレビュープロセスを通じて保持します。lingo pull --forceは、ローカルの作業を保存し、置き換えると明確に判断した後にのみ使用してください。強制実行は保護を回避するものであり、正しい表現を選ぶものではありません。
アップルの共有カタログでは、ファイル全体を保存し、変更していないロケールも確認してください。原文と複数の言語を含むファイルを、破棄してよい訳文出力と同じように削除しないでください。
確認後に新しい基準データを承認する #
この例では、新しい訳文の期間が60日になっていること、supportの値が保持されていること、productNameが意図どおりに動作することを確認してください。変数と構造は、それを利用する実行環境で確認します。差分で分かるのは変更箇所です。新しい記述の内容が正しいかどうかは、言語レビューで判断します。
承認済みの訳文を、対応する原文のリビジョンとともに、次の基準データとして保存してください。その修正を今後の指針に反映すべき場合は、用語集やルールを変更するかどうかを別途判断してください。一度の編集を承認しただけで、ローカライゼーションエンジンが新しい方針を学習するとは考えないでください。