Traducciones existentes

Max PrilutskiyCEO y cofundadorUpdated el mes pasado · 1 min read

No hace falta empezar con un proyecto vacío. Si ya tienes archivos traducidos, el CLI trabaja con ellos: completa lo que falta y mantiene intactas las traducciones que ya tienes.

Haz que la configuración apunte a lo que ya tienes#

Define los idioma de origen y de destino, junto con los patrones de archivo, para que coincidan con la ubicación de tus traducciones actuales:

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

Si locales/de.json y locales/fr.json ya existen, se quedan tal y como están.

Rellena los huecos#

bash
lingo push --backfill-missing

--backfill-missing solo genera destinos que faltan: un idioma que todavía no tiene archivo o, después de la primera ejecución, claves que el motor aún no ha traducido. Los archivos que ya tienes no se sobrescriben.

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

Mantén ciertos valores bloqueados#

Si algunas traducciones existentes se han revisado manualmente y no deben cambiar nunca, márcalas como preservedKeys para que ninguna ejecución futura las toque:

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

Cómo se inicializa el lockfile#

El primer push registra un hash de cada archivo de origen en .lingo/lock.json. A partir de ahí, un lingo push normal solo envía los archivos de origen que han cambiado: tus traducciones existentes no vuelven a enviarse salvo que cambies el origen o lo fuerces. Haz commit del lockfile junto con tus traducciones. Consulta Configuration.

Sobrescribir a propósito

--backfill-missing Nunca sobrescribe. Para volver a generar intencionadamente las traducciones existentes (tras cambiar el modelo o alguna regla), usa un push con un alcance específico --force.