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 #
lingo run| Estado del origen y del destino | Resultado de una ejecución normal de v0 |
|---|---|
| El valor de origen ha cambiado respecto a su suma de comprobación anterior | Traducir el valor modificado. |
| Falta una clave de origen en el destino | Traducir el contenido que falta. |
| Se ha eliminado una clave de origen | Eliminar su entrada de destino gestionada. |
| Una clave nueva coincide con la suma de comprobación del valor de origen de una clave eliminada | Reutilizar la traducción dentro de ese contexto procesado. |
| El destino existe y el origen no ha cambiado | Conservar 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:
lingo run --force --target-locale es --key welcome/titleAquí, 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.
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:
lingo run --force --bucket json --target-locale esEsto 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.