キー保持 · Lingo.dev

保持されたキーは、最初にソースの値で初期化されたあと、自動更新から保護されます。CLI がそれらを上書きすることはありません。法務文書、コンプライアンス関連のコピー、マーケティングのタグラインなど、手動翻訳が必要なコンテンツのプレースホルダーとして機能します。

設定#

バケット内のi18n.jsonに preservedKeys を追加します。

json

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "preservedKeys": ["legal/privacy", "legal/terms"]
    }
  }
}

仕組み#

次のソースファイルを例に見てみましょう。

json

{
  "welcome": "Welcome to our platform",
  "legal": {
    "privacy": "We respect your privacy and protect your data.",
    "terms": "By using this service, you agree to our terms."
  }
}

最初の実行では、CLI は保持されたキーをそのままコピーし、それ以外はすべて翻訳します。

json

// locales/es.json (first run)
{
  "welcome": "Bienvenido a nuestra plataforma",
  "legal": {
    "privacy": "We respect your privacy and protect your data.",
    "terms": "By using this service, you agree to our terms."
  }
}

法務セクションを手動で翻訳したあとは、その後 CLI を実行しても翻訳内容はそのまま維持されます。

キー保持とキー固定の違い#

	キー保持	キー固定
初期値	プレースホルダーとしてソース値を使用	常にソース値
手動編集	永続的に保持	実行のたびにソースで上書き
ユースケース	法務、コンプライアンス、手動翻訳	ブランド名、技術ID

キーパス記法#

ネストされたキーにはスラッシュ（/）、ワイルドカードにはアスタリスク（*）を使います。

json

{ "preservedKeys": ["legal/*", "marketing/tagline"] }

次のステップ#