一つのキーや用語を安全に更新する

選択した部分だけを再翻訳し、周囲の内容を保持。意図どおりに修正された箇所と、変更せずに残した内容の両方を確認します。

対象を絞った修正には、二つの成功条件があります。選択した内容が改善されることと、修正に関係のない承認済みの内容がそのまま保たれることです。両方を確認できるよう、既存の訳文と、それに対応する原文のリビジョンを保存してください。

修正するキーや用語が決まっている場合は、このガイドを参照してください。通常の原文変更については、更新時の保持を参照してください。すでに送信済みの処理がある場合は、追加の処理を依頼する前に、その復旧状態を確認してください。

承認済みの隣接項目も比較対象に含める #

例として、次のようなカタログを考えてみましょう。

json
{
  "account": {
    "invitation": "Approval is required before access is granted.",
    "support": "Contact support"
  }
}

account.invitationの訳文だけを修正する必要があるとします。そのまま残したい承認済みのaccount.supportの表現も含めて、訳文と原文のリビジョンを保存してください。

表現の修正方法を選ぶ #

一度限りの修正で、意図した表現に確実に直したい場合は、訳文の値を直接編集してください。アプリケーションで確認したうえで、レビュー済みのカタログをコミットします。そのメッセージの原文が変わらない限り、通常の原文更新でも編集内容を保持できます。

再生成する場合は、まず、異なる翻訳結果を得るために必要な情報を与えてください。エンジンの用語集に承認済みの用語を追加する、ルールで繰り返し適用される指示を修正する、メッセージのJSONC コンテキストを明確にするといった方法があります。その後、対象のキーを再生成してください。原文も翻訳の指針も変えずに再生成すると、同じ表現になることがあります。

用語の意味に基づいて選択範囲を定める #

メッセージを選ぶ前に、用語の意味を定義してください。たとえば、製品内の「ワークスペース」が共有プロジェクト領域を意味する一方で、別の箇所では物理的な作業スペースを指している場合があります。製品内で意図する意味と、チームが承認した訳語を用語集に記録し、その意味で使われているメッセージだけを選択してください。この判断については、用語の適用範囲で詳しく説明しています。

CLI で既存の翻訳先キーを選択する #

locales/en/account.jsonにあるその JSON 原文を使うよう設定済みのプロジェクトで、次を実行します。

bash
lingo push "locales/en/account.json" --key "account.invitation" --wait

JSON では、--keyは原文が変わっていなくても、選択した単位を再生成します。設定済みのロケールのうち、翻訳先ファイルがすでに存在する各ロケールで対象のキーを更新し、新しい値をそのファイルに統合します。

再生成する前に、既存の修正内容を保存してください。このプッシュで取得される訳文は、選択したキーで置き換えの対象になります。送信後に行われた訳文の編集を検出するには、--waitを省略し、結果を取得する前にlingo pull --dry-runを確認してください。競合への対処については、プル時のローカル編集の分類を参照してください。

キーを再生成しても、原文全体の基準状態は変わりません。これは、push --waitで結果を取得する場合も、別途プルして取得する場合も同じです。そのため、保留中の通常の原文編集は、後で通常のプッシュを行う際に引き続き送信されます。

キーパターンでは、完全一致のキー、オブジェクトの接頭辞、セグメント全体に一致する*ワイルドカードを指定できます。auth.loginでは、auth.login_urlに一致させずにauth.login.titleを含めることができます。ワイルドカードは引用符で囲み、複数のパターンを指定する場合は--keyを繰り返してください。

JSONC、TypeScript、PHP でも、同じように範囲を指定して再生成できます。YAML とロケールをルートに持つ YAML では、選択した訳文が変更されず、そのまま保持される場合があります。意図した表現に確実に直すには訳文を直接編集し、ファイル全体を再生成する場合は事前に承認済みの訳文を保存してください。CLI の適用範囲では、形式ごとの動作とキーの表記方法を説明しています。

用語の影響を受けるキーやファイルを探す #

対象の用語を意図した意味で使っている原文メッセージを探し、その文脈を確認してください。上記のコマンドの--keyを使って、対応するキーを選択します。ファイル全体の再生成が必要な形式では、承認済みの訳文を保存してから、該当する原文ファイルを再生成してください。例:

sh
lingo push 'docs/en/workspaces.md' --force --wait

設定ですでに選択されている原文のパスを使用してください。これにより、設定済みの翻訳先ロケールで、そのファイルの訳文が置き換えられます。用語の前後の文章も含めて、書き換えられたメッセージまたはファイルの全体を比較してください。

変更箇所、保持された内容、利用時の動作を確認する #

変更された翻訳先の各パスを、保存しておいた版と比較してください。この例では、招待文でアクセス前の承認が必要という条件が維持され、サポートメッセージが承認済みの基準版と一致している必要があります。隣接項目の欠落や予期しない書き換えがある場合は、承認する前に適用範囲と基準状態を確認してください。

変数とキーの制御設定を確認してください。ロックは原文をコピーし、保持は訳文の値を維持します。無視は、その機能に対応する形式の出力から内容を除外します。

出力を実際の利用先の実行環境に読み込んでください。文書の場合は、変更した箇所、リンク、コンポーネントを確認します。ローカルの編集内容を置き換える前にプルの競合を解消し、承認済みの訳文を、対応する原文のリビジョンおよび Lockfile とともにコミットしてください。