Referencia de CLI v0
Mantén un proyecto i18n.json instalado sin perder sus traducciones aceptadas ni el estado de referencia del contenido fuente.
Este manual describe el paquete anterior lingo.dev y su flujo de trabajo i18n.json/i18n.lock. Los ejemplos se limitan a 0.138.10. Conserva la versión registrada en el Lockfile del proyecto existente mientras planificas una migración; instalar la última versión, que puede cambiar, no permite recuperar el proyecto de forma reproducible.
Para un proyecto nuevo, empieza con la CLI actual. Su flujo de trabajo de envío y descarga del lado del servidor sigue reglas distintas de estado y selección.
Cómo funciona una ejecución con v0 instalado #
La configuración del grupo selecciona un analizador y detecta los archivos de origen y destino, expandiendo [locale] cuando es necesario. El analizador extrae el contenido y separa los valores que reconoce como no traducibles. El cálculo de diferencias compara los valores de origen, los valores de destino existentes y las sumas de verificación anteriores del contenido fuente para identificar entradas nuevas, modificadas, eliminadas o renombradas.
El texto seleccionado se procesa con un motor de localización de Lingo.dev o con un proveedor directo configurado. Las traducciones recibidas se reconstruyen en archivos de destino o en secciones por idioma de un archivo compartido. Algunas tareas pueden escribir resultados correctos antes de que otra falle; el proyecto completo no se procesa como una transacción atómica.
Conserva el estado de referencia junto con el contenido #
Incluye i18n.json, los resultados aceptados por idioma y i18n.lock en una misma confirmación de cambios. El Lockfile registra el estado del contenido fuente, no cada edición del contenido de destino ni cada aprobación de un idioma. Las ejecuciones normales actualizan las sumas de verificación del contenido fuente; las ejecuciones limitadas a un idioma de destino o a ciertas claves pueden escribir resultados sin actualizar el estado de referencia existente.
La referencia del Lockfile explica por qué una ejecución normal posterior puede volver a procesar un cambio en el contenido fuente después de una ejecución de alcance limitado. Traducciones existentes explica cómo adoptar traducciones sin reemplazar todos los valores existentes.
Encuentra la siguiente operación #
Usa el procedimiento para el primer archivo para reproducir una ejecución pequeña de la versión anterior. Configuración y Formatos indican qué lee y escribe la generación instalada.
Para el trabajo continuo, Idiomas permite agregar un idioma de destino; Controles de claves distingue las ediciones normales de los valores gestionados por personas; Retraducción define el alcance de una actualización deliberada. Monorepositorios y Procesamiento en paralelo explican las responsabilidades y la capacidad de procesamiento sin dar por hecho que aumentar la cantidad de procesos de trabajo elimina los límites del proveedor.