Adopt existing translations in CLI v0
Fill missing legacy catalog keys while retaining present values and establishing a trustworthy source baseline.
V0 can start from catalogs produced elsewhere. Its ordinary delta compares source and target keys, adding missing entries without regenerating every present value. This is different from the current CLI's missing-file backfill.
Preserve the existing work #
Configure the catalog's bucket in i18n.json and save a recoverable copy of accepted targets. Check that present values are actual translations: source-language placeholders can conceal the gaps you intended to fill.
For example, this source has three keys:
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}An existing Spanish target contains two:
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}The ordinary gap-fill task adds button.cancel while retaining present values, unless earlier checksums establish a source change requiring retranslation.
Run one locale and inspect the diff #
lingo run --target-locale esCheck additions, removals of no-longer-source keys, and any regenerated changed values. Inspect language and application loading, then commit accepted output with the lockfile state.
A scoped run does not refresh an existing source-checksum baseline. Its unchanged lockfile is not proof that all locales match current source. A later ordinary run can revisit changed source text; follow baseline settlement.
When no previous checksum exists for a present key, 0.138.10 does not mark that key updated merely because the checksum is missing. A missing lock therefore does not force universal retranslation, nor prove that present targets are current. Inspect uncertain pairs before treating the new baseline as authoritative.
Correct known problems separately #
For an incorrect present value, make a manual correction or request a selected refresh:
lingo run --force --target-locale es --key button.cancelForce can replace manual work. Use preserved keys when a value must remain under human control, and make review of subsequent source changes part of that ownership.