CLI v0で既存の翻訳を取り込む
既存の値を保持しながら、従来のカタログで不足しているキーを補い、信頼できるソースの基準を確立します。
バージョン0では、ほかの環境で作成したカタログを使い始められます。通常の差分処理では、ソースとターゲットのキーを比較し、既存の値を再生成せずに不足している項目を追加します。これは、現行のCLIで行う欠落ファイルの補完とは異なります。
これまでの作業成果を保持する #
i18n.jsonでカタログのバケットを設定し、承認済みのターゲットを復元できるようにコピーを保存します。既存の値が実際に翻訳されているかを確認してください。ソース言語の仮の値が入っていると、補完したい翻訳の抜けを見落とすことがあります。
たとえば、次のソースには3つのキーがあります。
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}既存のスペイン語のターゲットには、2つのキーがあります。
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}通常の補完処理では、既存の値を保持したままbutton.cancelを追加します。ただし、以前のチェックサムとの比較で、再翻訳が必要なソースの変更が検出された場合は例外です。
1つのロケールで実行し、差分を確認する #
lingo run --target-locale es追加されたキー、ソースに存在しなくなったために削除されたキー、キーの変更に伴って再生成された値を確認します。翻訳内容とアプリケーションでの読み込みを確認してから、承認した出力をLockfileの状態とともにコミットします。
対象を限定した実行では、既存のソースチェックサムの基準は更新されません。Lockfileに変更がなくても、すべてのロケールが現在のソースと一致している証拠にはなりません。後で通常の実行を行うと、変更されたソーステキストが再び処理される場合があります。基準の確定の手順に従ってください。
既存のキーに以前のチェックサムがない場合、0.138.10はチェックサムがないという理由だけで、そのキーを更新済みとして扱うことはありません。つまり、Lockfileがなくても、すべての翻訳が強制的に再翻訳されるわけではありません。一方で、既存のターゲットが最新であることの証明にもなりません。新しい基準を信頼できるものとして扱う前に、不確かなソースと翻訳の組み合わせを確認してください。
既知の問題は個別に修正する #
既存の値に誤りがある場合は、手動で修正するか、対象を選んで更新を依頼します。
lingo run --force --target-locale es --key button.cancel強制実行では、手作業で仕上げた内容が上書きされることがあります。人が管理し続ける必要のある値にはキーの保持機能を使い、その後のソース変更のレビューも管理の一環として行ってください。