Adopta traducciones existentes en CLI v0

Completa las claves faltantes de catálogos heredados sin perder los valores existentes y establece una línea base confiable del contenido de origen.

V0 puede partir de catálogos creados con otras herramientas. Su actualización incremental habitual compara las claves de origen y destino y agrega las entradas faltantes sin regenerar los valores existentes. Esto es distinto de lo que hace la CLI actual, que completa los archivos faltantes.

Conserva el trabajo existente #

Configura el bucket del catálogo en i18n.json y guarda una copia recuperable de las traducciones de destino aceptadas. Comprueba que los valores existentes sean traducciones reales: los textos provisionales en el idioma de origen pueden ocultar las entradas faltantes que buscabas completar.

Por ejemplo, este contenido de origen tiene tres claves:

json
{
  "welcome": "Welcome back",
  "button.save": "Save",
  "button.cancel": "Cancel"
}

Un catálogo de destino existente en español tiene dos:

json
{
  "welcome": "Te damos la bienvenida de nuevo",
  "button.save": "Guardar"
}

La tarea habitual para completar entradas faltantes agrega button.cancel y conserva los valores existentes, a menos que las sumas de verificación anteriores indiquen un cambio en el contenido de origen que requiera una nueva traducción.

Ejecuta el proceso para un solo idioma y revisa las diferencias #

sh
lingo run --target-locale es

Revisa las claves agregadas, las eliminadas por ya no estar en el contenido de origen y cualquier valor regenerado de las claves modificadas. Verifica el idioma y la carga de la aplicación; luego, guarda en un commit el resultado aceptado junto con el estado del Lockfile.

Una ejecución de alcance limitado no actualiza la línea base existente de sumas de verificación del contenido de origen. Que el Lockfile no haya cambiado no demuestra que todos los idiomas correspondan al contenido de origen actual. Una ejecución habitual posterior puede volver a procesar el texto de origen modificado; sigue el procedimiento para establecer la línea base.

Si una clave existente no tiene una suma de verificación previa, 0.138.10 no la marca como actualizada solo porque falta esa suma. Por lo tanto, la ausencia de un Lockfile no obliga a volver a traducir todo ni demuestra que las traducciones de destino existentes estén al día. Revisa los pares que generen dudas antes de tomar la nueva línea base como referencia definitiva.

Corrige los problemas conocidos por separado #

Si un valor existente es incorrecto, haz una corrección manual o solicita una actualización selectiva:

sh
lingo run --force --target-locale es --key button.cancel

Una ejecución forzada puede reemplazar el trabajo manual. Usa claves preservadas cuando un valor deba mantenerse bajo control humano e incluye la revisión de los cambios posteriores en el contenido de origen como parte de esa responsabilidad.