Volver a traducir contenido seleccionado con la CLI v0

Actualiza traducciones antiguas tras cambios en el contenido de origen o en las directrices, controlando el alcance y protegiendo las modificaciones aceptadas.

Usa una ejecución normal cuando cambie el contenido de origen. Usa una ejecución forzada cuando el origen siga igual, pero la traducción deba reflejar nuevas instrucciones o sustituir un valor que no te convence. Ambas pueden sobrescribir las modificaciones manuales normales.

Deja que los cambios en el origen determinen qué procesa una ejecución normal #

sh
lingo run
Estado del origen y del destinoResultado de una ejecución normal de v0
El valor de origen ha cambiado respecto a su suma de comprobación anteriorTraducir el valor modificado.
Falta una clave de origen en el destinoTraducir el contenido que falta.
Se ha eliminado una clave de origenEliminar su entrada de destino gestionada.
Una clave nueva coincide con la suma de comprobación del valor de origen de una clave eliminadaReutilizar la traducción dentro de ese contexto procesado.
El destino existe y el origen no ha cambiadoConservar el valor de destino.

Una corrección manual normal se mantiene mientras el origen no cambie, pero no tiene por qué sobrevivir a todas las actualizaciones futuras. Las claves preservadas reservan un valor independiente bajo control humano.

Actualiza una traducción afectada #

Tras cambiar un modelo, una instrucción, un glosario o una regla, empieza por el idioma y la clave afectados:

sh
lingo run --force --target-locale es --key welcome/title

Aquí, welcome/title apunta a title dentro de welcome. En 0.138.10, el comando de ejecución admite claves exactas, prefijos que respetan los límites y patrones glob. Pon --key 'welcome/**' entre comillas para seleccionar los descendientes sin que el intérprete de comandos expanda el patrón.

Revisa el resultado traducido junto a su origen y, después, cárgalo en la aplicación. El trabajo limitado a un idioma o a una clave no actualiza una referencia compartida existente. Sigue las reglas de consolidación del Lockfile para que una ejecución normal posterior no vuelva a procesar por sorpresa el mismo cambio en el origen.

Selecciona un volumen de trabajo manejable en un proyecto grande #

--target-locale, --bucket, --file y --key son selectores que se pueden repetir. --source-locale cambia el origen que se usa en la ejecución. Parte del inventario de grupos y rutas configurados y acótalo, en lugar de indicar un archivo cualquiera que no esté configurado.

sh
lingo run --target-locale es --bucket json --file 'apps/web/**'

El selector de archivos del comando de ejecución admite coincidencias por subcadena o minimatch con las rutas configuradas detectadas. El del comando de purga solo admite subcadenas, y su selector de claves también funciona de otra manera. No reutilices los selectores de un comando en el otro sin comprobar antes las entradas seleccionadas.

Para una actualización más amplia y deliberada:

sh
lingo run --force --bucket json --target-locale es

Esto puede regenerar todo el contenido JSON en español seleccionado. lingo run --force sin argumentos abarca todo el proyecto configurado. Guarda los resultados aceptados antes de ampliar el alcance y calcula una estimación para ese mismo alcance forzado si usas el servicio de Lingo.dev.

En cambios grandes, separar el alcance por archivo y por idioma facilita la revisión de las diferencias. Si algo falla, conserva los resultados de los bloques que se completaron correctamente y vuelve a intentarlo con el alcance pertinente antes de forzarlo todo. El procesamiento en paralelo controla la capacidad de procesamiento, no la selección ni la reversión.

Mantén los catálogos de la interfaz y los documentos en sus propios grupos de formato, y excluye el contenido generado y los borradores. Separa las configuraciones de los paquetes cuando los destinos o los motores de localización sean distintos. En CI, lingo run --frozen comprueba una referencia fiable sin traducir; investiga los fallos en lugar de recalcular las sumas de comprobación para ocultarlos. La guía de configuración del ejecutor actual usa un paquete y una configuración diferentes, así que migra antes de adoptarla.

Usa la purga solo cuando de verdad quieras eliminar contenido #

La técnica antigua de purgar y luego ejecutar elimina las claves de destino para que el proceso normal de completar el contenido que falta las procese. Borra los resultados antes de que la regeneración termine correctamente y no está demostrado que mejore el rendimiento. Consulta la referencia del comando de purga para comprobar sus selectores específicos y el riesgo para el idioma de origen; guarda una copia recuperable hasta que la regeneración y la revisión hayan finalizado correctamente.