翻訳のオーバーライド

Lingo.dev CLIでは、ターゲットファイルを直接編集することで翻訳を手動でオーバーライドできます。一度オーバーライドされたカスタム翻訳は、ソースコンテンツが変更されない限り、その後のCLI実行時にも保持されます。

オーバーライドの仕組み

Lingo.dev CLIはコンテンツフィンガープリントを使用して変更を検出します。ターゲットファイルの翻訳を手動で編集すると、ソースコンテンツのフィンガープリントが変更されていないため、CLIは変更内容を保持します。

ワークフローの例:

1. 初回翻訳 — CLIがスペイン語翻訳を生成:

// locales/en.json (source)
{
  "greeting": "Welcome to our platform"
}

// locales/es.json (generated)
{
  "greeting": "Bienvenido a nuestra plataforma"
}

2. 手動オーバーライド — スペイン語翻訳を編集:

// locales/es.json (manually edited)
{
  "greeting": "¡Bienvenido a nuestro espacio digital!"
}

3. その後のCLI実行 — オーバーライドが保持されます:

npx lingo.dev@latest run
# Your custom Spanish translation remains unchanged

4. ソース変更による再翻訳のトリガー — 英語のソースを変更した場合:

// locales/en.json (source modified)
{
  "greeting": "Welcome to our new platform"
}

CLIはソースの変更を検出して再翻訳を行い、オーバーライドを新しいAI生成翻訳に置き換えます。

キー名変更のサポート

Lingo.dev CLIは、キー名を変更した場合でも翻訳を保持します。ロックファイルがコンテンツとキーの両方のフィンガープリントを追跡するため、翻訳作業を失うことなくシームレスなキーのリファクタリングが可能です。

詳細: キー名の変更