Referencia de CLI v0
Mantén un proyecto i18n.json ya instalado sin perder sus traducciones aceptadas ni el estado de referencia del contenido de origen.
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 reproducir la recuperación.
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 una instalación de v0 #
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 comprobación anteriores del contenido de origen para detectar entradas nuevas, modificadas, eliminadas o renombradas.
El texto seleccionado se procesa mediante un motor de localización de Lingo.dev o un proveedor directo configurado. Con las traducciones recibidas se reconstruyen los archivos de destino o las secciones por idioma de un archivo compartido. Algunas tareas pueden escribir resultados correctos antes de que otra falle; el proyecto en su conjunto no constituye una transacción atómica.
Conserva el estado de referencia junto con el contenido #
Incluye i18n.json, los resultados aceptados de cada idioma y i18n.lock en el mismo commit. El Lockfile registra el estado del contenido de origen, no cada edición del contenido de destino ni cada aprobación de un idioma. Las ejecuciones normales actualizan las sumas de comprobación del contenido de origen; las limitadas a un idioma de destino o a determinadas 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 de origen tras una ejecución de alcance limitado. Traducciones existentes explica cómo adoptarlas sin sustituir todos los valores que ya hay.
Encuentra la siguiente operación #
Usa el procedimiento para el primer archivo para reproducir una pequeña ejecución con la versión anterior. Configuración y Formatos indican qué lee y escribe la generación instalada.
Para el trabajo habitual, Idiomas permite añadir un idioma de destino; Controles de claves distingue las ediciones normales de los valores gestionados por personas; Retraducción delimita el alcance de una actualización deliberada. Monorepos y Procesamiento en paralelo abordan la responsabilidad sobre el contenido y la capacidad de procesamiento, sin dar por hecho que añadir más procesos de trabajo elimina los límites del proveedor.