CLI v0のキー制御と手動編集
従来のカタログで、原文に従う値、人が管理する翻訳、通常の修正を明確に区別します。
通常の手動修正と、保持対象に指定したキーでは、値が維持される条件が異なります。v0では通常、原文が変わらない限り、既存の訳文が維持されます。一方、保持対象のキーでは、原文が変わっても、その値は人が管理するものとして維持されます。
通常の翻訳を修正する #
訳文の値を直接編集し、承認された文言をコミットします。原文に変更がなければ、通常の差分処理でその訳文を維持できます。原文のチェックサムが変わると、そのキーは再び翻訳対象になります。また、強制実行では、原文に変更がなくても訳文が置き換えられることがあります。
原文が変わった際に意味を見直す必要がある修正には、この方法を使ってください。人が管理し続ける必要があるコンテンツは、保持対象に設定し、原文の変更を確認する手順も用意してください。
管理主体を明示する #
| 制御 | 従来の出力動作 |
|---|---|
lockedKeys | 原文の値をコピーします。訳文の編集内容が上書きされることがあります。 |
ignoredKeys | 選択したコンテンツを翻訳と出力の対象から除外します。 |
preservedKeys | 値がない場合は原文の値を初期値として設定し、その後は人が管理できるよう、訳文の値を維持します。 |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}この例では、ブランド名は原文と同じ値のまま維持され、内部用の項目は出力から除外され、法的な用語は引き続き人が管理します。原文言語の仮の文言を新たに保持対象にした場合も、リリース前に翻訳する必要があります。アプリケーションが無視対象のキーを必要とする場合は、代替値を用意するか、そのキーを必要としないように変更してください。
文書化されていない優先順位を前提にせず、制御パターンが重複する場合は動作を確認してください。このv0の動作は、現在の訳文保持の制御とは異なります。
入れ子のキーとリテラルキーを指定する #
従来のパスでは、スラッシュで階層をたどります。brand/nameはbrand内のnameを選択し、modules/ai.translationはmodules内の、ドットを文字として含むキーを選択します。ワイルドカードは従来の照合規則に従うため、意図した階層の深さでテストしてください。現在のドットと角括弧による構文とは互換性がありません。
名前の変更時に再利用する #
従来の差分処理では、同じ処理対象パスの範囲内で、新しいキーの原文値のハッシュを、削除されたキーの以前のハッシュと照合できます。テキストが同一であれば、新たに翻訳することなく、既存の訳文を名前変更後のキーに引き継げます。
キーと原文の両方を変更すると、新たな翻訳作業が発生します。独立したパス間で移動する場合や、同一の文字列を繰り返し使う場合は、確認が必要です。この照合は、制約なく利用できる翻訳メモリではありません。現在のJSONでは識別がパスに基づいており、この動作は引き継がれません。
意図的に置き換える場合は再翻訳を、文脈に関する指針を伝える場合は翻訳者向けメモを使ってください。ただし、どちらを使う場合も、出力値を誰が管理するかは別途決める必要があります。