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 #

sh
lingo run
Estado del origen y del destinoResultado de una ejecución normal de v0
El valor de origen cambió respecto de su suma de verificación anteriorTraducir el valor modificado.
Falta una clave de origen en el destinoTraducir el contenido faltante.
Se eliminó una clave de origenEliminar 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 eliminadaReutilizar 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:

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

Aquí, 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.

sh
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:

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

Esto 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.