Lockfile de CLI v0

Usa la base de referencia del origen de la versión anterior para entender los cambios pendientes y recuperar el estado sin ocultar traducciones sin terminar.

i18n.lock permite a v0 distinguir entre el texto de origen que no ha cambiado y el que necesita traducción. Consérvalo junto con el origen y las traducciones de destino aceptadas que describe. No registra todas las modificaciones manuales del destino ni demuestra que una traducción sea correcta.

Qué registra el archivo #

En lingo.dev@0.138.10, el archivo tiene formato YAML e incluye version: 1 y un mapa checksums. Cada sección externa calcula el hash de un patrón de ruta procesado; sus entradas asocian las claves de origen con sumas de comprobación de los valores de origen basadas en MD5. Deja que la CLI gestione estas entradas en lugar de crearlas manualmente.

Si cambia una suma de comprobación, la clave correspondiente, si está presente, pasa a ser candidata a traducción. La coincidencia entre los hashes de los valores de origen también puede vincular una clave nueva con una eliminada dentro del mismo contexto procesado, lo que permite reutilizar la traducción al cambiar el nombre de una clave. Ninguno de estos mecanismos ofrece una memoria de traducción sin restricciones entre archivos.

Distingue entre traducir y sustituir la base de referencia #

OperaciónQué hace
lingo runTraduce las diferencias calculadas y actualiza el estado del origen.
lingo run --forceRegenera la salida seleccionada sin depender del cálculo habitual de diferencias.
lingo lockfileAñade las secciones que faltan del estado del origen sin modificar las que ya contienen datos.
lingo lockfile --forceSustituye las sumas de comprobación del origen a partir de los archivos actuales sin traducir los destinos.
lingo run --frozenComprueba la sincronización sin traducir, pero primero inicializa la base de referencia si no existe.

Supongamos que el texto en inglés cambia después de aceptar una traducción al francés. Sustituir su suma de comprobación con lockfile --force registra el nuevo texto en inglés como base de referencia, aunque el francés todavía pueda expresar el significado anterior. Por tanto, reconstruir la base de referencia no debe ser el procedimiento habitual para resolver un fallo de sincronización.

Las ejecuciones limitadas a un idioma de destino o a determinadas claves pueden escribir traducciones sin actualizar la base de referencia compartida del origen que ya existe. Una ejecución normal posterior puede volver a procesar el cambio del origen y sustituir una corrección realizada después de esa ejecución limitada. Revisa y concilia expresamente las salidas de los idiomas correspondientes antes de actualizar la base de referencia compartida.

Al resolver un cambio del origen en varios idiomas:

  1. Mantén fija la revisión del origen y conserva i18n.lock mientras quede alguna salida afectada sin terminar. Usa lingo run para una actualización normal de todo el proyecto, o las ejecuciones de alcance limitado documentadas cuando las salidas necesiten trabajo y revisión por separado.
  2. Revisa todas las salidas por idioma que abarca la sustitución de las sumas de comprobación del origen, incluidas las que no se hayan modificado en la ejecución de alcance limitado más reciente. Resuelve los fallos y concilia las correcciones manuales aceptadas con ese origen. Si alguna salida sigue desactualizada o genera dudas, deja pendiente la actualización de la base de referencia compartida.
  3. Si el trabajo de alcance limitado no modificó la base de referencia existente y ya se han aceptado todas las salidas que abarca, ejecuta lingo lockfile --force desde el directorio raíz del proyecto correspondiente. Este comando sustituye las sumas de comprobación del origen sin traducir, así que no lo uses para saltarte la revisión previa ni supongas que el último selector de idioma de destino limita esta sustitución.
  4. Revisa las diferencias del Lockfile y confirma juntos la revisión exacta del origen, todas las traducciones de destino correspondientes que se hayan aceptado y i18n.lock. Una ejecución posterior de lingo run --frozen puede comprobar la sincronización con esa base de referencia consolidada; no puede determinar si las traducciones de destino están actualizadas ni evaluar su calidad.

El modo congelado no es estrictamente de solo lectura cuando falta i18n.lock. Puede inicializar primero las sumas de comprobación, y la mera presencia de claves de destino no demuestra que estén actualizadas. Establece un par de origen y destino fiable antes de interpretar una comprobación satisfactoria en modo congelado como prueba de sincronización.

Recupera un estado que falta o presenta conflictos #

Cuando falta el Lockfile, v0 no regenera necesariamente todas las traducciones de destino existentes: sin una suma de comprobación anterior, puede conservar sus valores. Revisa los pares de origen y destino que generen dudas antes de aceptar una base de referencia recién creada. Traducciones existentes explica este caso de adopción.

En caso de conflicto de fusión, concilia primero los cambios del origen y del destino de ambas ramas. Restaura un Lockfile fiable siempre que sea posible. Si tienes que reconstruirlo, revisa los pares de traducción reales, porque la reconstrucción registra el estado del origen, no si el destino está actualizado.

El procedimiento de reparación de YAML de la versión anterior conserva la última entrada duplicada e informa de las eliminaciones. Esto resuelve la duplicación en la sintaxis, pero no determina cuál de las redacciones de las ramas es correcta. Revisa los valores en conflicto antes de confirmar el archivo reparado junto con las salidas aceptadas.