Incorpora traducciones existentes en CLI v0
Completa las claves que faltan en los catálogos heredados, conserva los valores existentes y establece una referencia fiable del contenido de origen.
V0 puede partir de catálogos creados con otras herramientas. Su proceso incremental habitual compara las claves de origen y de destino y añade las entradas que faltan sin regenerar los valores existentes. Este comportamiento es distinto del de la CLI actual, que completa los archivos que faltan.
Conserva el trabajo existente #
Configura el contenedor 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 sin traducir que querías completar.
Por ejemplo, este contenido de origen tiene tres claves:
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}Un catálogo de destino existente en español contiene dos:
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}La tarea habitual para completar las entradas que faltan añade button.cancel y conserva los valores existentes, salvo que las sumas de comprobación anteriores indiquen un cambio en el origen que requiera volver a traducir.
Ejecuta la tarea para un solo idioma y revisa las diferencias #
lingo run --target-locale esComprueba las entradas añadidas, las eliminaciones de claves que ya no están en el origen y los valores regenerados de las claves modificadas. Revisa el idioma y la carga en la aplicación; después, guarda en un commit el resultado aceptado junto con el estado del Lockfile.
Una ejecución de alcance limitado no actualiza la referencia existente de las sumas de comprobación del origen. Que el Lockfile no haya cambiado no demuestra que todos los idiomas se correspondan con el origen actual. Una ejecución habitual posterior puede volver a procesar el texto de origen modificado; sigue las indicaciones de consolidación de la referencia.
Si no existe una suma de comprobación anterior para una clave presente, 0.138.10 no la marca como actualizada solo porque falte esa suma. Por 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 de origen y destino que generen dudas antes de dar por válida la nueva referencia.
Corrige los problemas conocidos por separado #
Si un valor existente es incorrecto, haz una corrección manual o solicita una actualización selectiva:
lingo run --force --target-locale es --key button.cancelForzar la actualización puede sobrescribir el trabajo manual. Usa claves preservadas cuando un valor deba seguir bajo control humano e incluye la revisión de los cambios posteriores en el origen como parte de esa responsabilidad.