既存の翻訳

空のプロジェクトから始める必要はありません。すでに翻訳ファイルがあるなら、CLIはそのまま併用できます。不足分を補いながら、既存の翻訳はそのまま維持します。

今あるものを設定で指定する#

ソースロケールとターゲットロケール、そしてファイルパターンを設定し、既存の翻訳ファイルが置かれている場所に合わせて指定します。

{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "files": [{ "pattern": "locales/en.json" }]
}

locales/de.json と locales/fr.json がすでにある場合は、そのまま保持されます。

不足分だけを埋める#

lingo push --backfill-missing

--backfill-missing が生成するのは、不足している ターゲットだけです。つまり、まだファイルがないロケール、あるいは（初回実行後は）エンジンがまだ翻訳していないキーだけです。既存のファイルが上書きされることはありません。

✓ Run lfr_a8c...: localized 1 target file(s), 2 already up-to-date.

特定の値を固定する#

既存の翻訳の中に、人手でレビュー済みで今後いっさい変更したくないものがある場合は、preservedKeys として指定してください。以後の実行ではそれらに一切触れません。

{ "pattern": "locales/en.json", "preservedKeys": ["legal.terms"] }

lockfileが初回設定を支える仕組み#

最初のpushで、すべてのソースファイルのハッシュが .lingo/lock.json に記録されます。それ以降、通常の lingo push で送信されるのは変更のあったソースだけです。ソースを変更するか強制しない限り、既存の翻訳が再送信されることはありません。lockfileは翻訳ファイルと一緒にコミットしてください。Configuration を参照してください。