Volver a traducir contenido seleccionado de CLI v0
Actualiza las traducciones heredadas cuando cambien el contenido de origen o las directrices, sin perder el control del alcance ni las ediciones aceptadas.
Usa una ejecución normal cuando cambie el contenido de origen. Usa una ejecución forzada cuando el contenido de origen no cambie, pero la traducción deba reflejar nuevas instrucciones o reemplazar un valor que no te convence. Ambas pueden reemplazar las ediciones manuales normales.
Deja que los cambios en el contenido de origen determinen qué procesar en una ejecución normal #
lingo run| Estado del origen y del destino | Resultado de una ejecución normal de v0 |
|---|---|
| El valor de origen cambió respecto de su suma de verificación anterior | Traducir el valor modificado. |
| Falta una clave de origen en el destino | Traducir el contenido faltante. |
| Se eliminó una clave de origen | Eliminar la entrada de destino administrada correspondiente. |
| El valor de origen de una clave nueva tiene la misma suma de verificación que el de una clave eliminada | Reutilizar la traducción dentro de ese contexto procesado. |
| El destino está presente y el origen no cambió | Conservar el valor de destino. |
Una corrección manual normal se conserva mientras el contenido de origen no cambie, pero no está protegida ante todas las actualizaciones futuras. Las claves preservadas reservan un valor independiente bajo control humano.
Actualiza una traducción afectada #
Después de 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, run acepta claves exactas, prefijos que respetan los límites y patrones glob. Escribe --key 'welcome/**' entre comillas para seleccionar los descendientes sin que el intérprete de comandos expanda el patrón.
Revisa la traducción junto a su contenido de origen y luego cárgala en la aplicación. El trabajo limitado a un idioma o una clave no actualiza una línea base compartida existente. Sigue las reglas de consolidación del Lockfile para que una ejecución normal posterior no vuelva a procesar inesperadamente el mismo cambio en el contenido de origen.
Selecciona una carga de trabajo manejable en un proyecto grande #
--target-locale, --bucket, --file y --key son selectores que puedes repetir. --source-locale cambia el origen utilizado en la ejecución. Parte del inventario de grupos y rutas configurados y luego limita la selección, en lugar de indicar un archivo arbitrario que no esté configurado.
lingo run --target-locale es --bucket json --file 'apps/web/**'El selector de archivos de run admite coincidencias por subcadena o mediante minimatch con las rutas configuradas detectadas. El selector de archivos de purge solo admite coincidencias por subcadena; su selector de claves también funciona de otra manera. No reutilices selectores de un comando en el otro sin comprobar las entradas seleccionadas.
Para una actualización más amplia e intencional:
lingo run --force --bucket json --target-locale esEsto puede regenerar todo el contenido JSON en español seleccionado. lingo run --force sin opciones abarca el proyecto configurado. Conserva los resultados aceptados antes de ampliar el alcance y estima ese mismo alcance forzado cuando uses el servicio de Lingo.dev.
Para cambios grandes, separar el alcance por archivo e idioma facilita la revisión de las diferencias. Si ocurre un error, conserva los resultados de los bloques procesados correctamente y vuelve a intentar el alcance correspondiente antes de forzar todo. El procesamiento en paralelo controla la capacidad de procesamiento, no la selección ni la reversión.
Mantén los catálogos de interfaz y los documentos en grupos separados por formato, y excluye el contenido generado y los borradores. Usa configuraciones de paquetes separadas cuando los destinos o los motores de localización sean distintos. En CI, lingo run --frozen comprueba una línea base confiable sin traducir; investiga los errores en lugar de recalcular las sumas de verificación para ocultarlos. La receta de ejecución actual usa un paquete y una configuración diferentes, así que migra antes de adoptarla.
Usa purge solo cuando quieras eliminar contenido #
La técnica histórica de ejecutar purge y luego run deja claves faltantes en el destino para que el proceso normal de completar contenido faltante las procese. Elimina los resultados antes de que la regeneración se complete correctamente y no es una mejora de rendimiento comprobada. Consulta la referencia de purge para verificar sus selectores específicos y el riesgo para el idioma de origen; conserva una copia recuperable hasta que la regeneración y la revisión se completen correctamente.