Archivo de bloqueo i18n.lock

i18n.lock es un archivo de bloqueo que realiza un seguimiento de las sumas de verificación del contenido para evitar retraducciones innecesarias y optimizar el rendimiento de la CLI de Lingo.dev.

i18n.lock almacena sumas de verificación del contenido fuente y las claves de traducción para identificar qué ha cambiado entre las ejecuciones de traducción. Como resultado, solo el contenido nuevo o modificado se traduce, reduciendo el tiempo de procesamiento y los costos de traducción.

Estructura del archivo de bloqueo

i18n.lock utiliza un formato YAML estructurado para almacenar sumas de verificación de contenido:

version: 1
checksums:
  a07974ea09011daa56f9df706530e442:
    key: f8692d39317193acf0e2e47172703c46
  b18975fb19122ebb67g0ef817641f553:
    key: g9703e40428204bdf1f3f58283814d57

Elementos de configuración:

  • version — Versión del esquema del archivo de bloqueo para compatibilidad de migración
  • checksums — Mapa de sumas de verificación de contenido a sumas de verificación de claves que rastrea el contenido traducido
  • checksums.[content-hash] — Hash SHA-256 del contenido fuente que sirve como identificador único
  • checksums.[content-hash].key — Hash SHA-256 de la clave de traducción que permite la detección de cambios de nombre de clave

Lingo.dev CLI conserva las traducciones existentes cuando detecta contenido idéntico con diferentes sumas de verificación de clave. No se produce retraducción, manteniendo la consistencia de la traducción mientras permite cambios en la organización de las claves. Lea más sobre cambio de nombre de claves.

Integración en el flujo de trabajo

i18n.lock opera automáticamente durante los flujos de trabajo de traducción:

Primera ejecución — Crea el archivo de bloqueo con las sumas de verificación iniciales del contenido:

npx lingo.dev@latest i18n

# Crea i18n.lock con todas las sumas de verificación del contenido fuente

Recrear archivo de bloqueo — Recrea el archivo de bloqueo desde cero:

npx lingo.dev@latest lockfile --force

# Recrea i18n.lock con todas las sumas de verificación del contenido fuente

Consejo: Puede utilizar este comando de forma segura para restablecer el archivo de bloqueo a su estado verdadero durante la resolución de conflictos de fusión.

Ejecuciones posteriores — Procesa solo el contenido modificado:

npx lingo.dev@latest i18n

# Compara el contenido actual con i18n.lock

# Traduce solo el contenido nuevo o modificado

Forzar retraducción — Omite la optimización del archivo de bloqueo y retraduce todo el contenido, recreando el archivo de bloqueo:

npx lingo.dev@latest i18n --force

# Ignora i18n.lock y retraduce todo el contenido

Verificación congelada — Valida la integridad de la traducción:

npx lingo.dev@latest i18n --frozen

# Falla si algún contenido requiere traducción

# Se utiliza en CI/CD para asegurar traducciones completas

Integración con control de versiones

i18n.lock debe ser confirmado en el control de versiones junto con los archivos de traducción.

El archivo de bloqueo es una parte esencial del sistema de traducción incremental de Lingo.dev CLI, haciéndolo práctico para proyectos de cualquier tamaño.