Lockfile de CLI v0
Usa la línea base de origen heredada para entender los cambios pendientes y recuperar el estado sin ocultar traducciones incompletas.
i18n.lock permite que v0 distinga el contenido de origen que no cambió del texto que necesita traducción. Consérvalo junto con el contenido de origen y las traducciones de destino aceptadas que describe. No registra cada edición manual del contenido de destino ni demuestra que una traducción sea correcta.
Qué registra el archivo #
En lingo.dev@0.138.10, el archivo está en formato YAML e incluye version: 1 y un mapeo checksums. Cada sección externa calcula el hash de un patrón de ruta procesado; sus entradas vinculan las claves de origen con sumas de verificación de los valores de origen basadas en MD5. Deja que la CLI administre estas entradas en lugar de crearlas manualmente.
Cuando cambia una suma de verificación, una clave presente pasa a ser candidata para traducción. Si los hashes de los valores de origen coinciden, también pueden vincular una clave nueva con una clave eliminada dentro del mismo contexto procesado, lo que permite reutilizar la traducción al cambiar el nombre. Ninguno de estos mecanismos funciona como una memoria de traducción sin restricciones entre archivos.
Distingue la traducción del reemplazo de la línea base #
| Operación | Qué hace |
|---|---|
lingo run | Traduce el conjunto de cambios calculado y actualiza el estado de origen. |
lingo run --force | Regenera la salida seleccionada sin depender del conjunto de cambios habitual. |
lingo lockfile | Agrega las secciones faltantes del estado de origen y deja intactas las que ya tienen contenido. |
lingo lockfile --force | Reemplaza las sumas de verificación de origen a partir de los archivos actuales sin traducir el contenido de destino. |
lingo run --frozen | Comprueba la sincronización sin traducir, pero primero inicializa la línea base si falta. |
Supongamos que el contenido en inglés cambia después de que se acepta una traducción al francés. Reemplazar su suma de verificación con lockfile --force registra el nuevo contenido en inglés como línea base, aunque la traducción al francés todavía puede expresar el significado anterior. Por eso, reconstruir la línea base no debe ser una práctica habitual para resolver un error de sincronización.
Las ejecuciones limitadas a un idioma de destino o a claves específicas pueden guardar traducciones sin actualizar la línea base de origen compartida que ya existe. Una ejecución habitual posterior puede volver a procesar el cambio de origen y reemplazar una corrección hecha después de esa ejecución limitada. Concilia cuidadosamente las salidas de los idiomas correspondientes antes de actualizar la línea base compartida.
Al consolidar un cambio de origen en varios idiomas:
- Mantén fija la revisión del contenido de origen y conserva
i18n.lockmientras alguna salida afectada siga incompleta. Usalingo runpara una actualización habitual de todo el proyecto, o las ejecuciones de alcance limitado documentadas cuando las salidas necesiten trabajo y revisión por separado. - Revisa la salida de cada idioma que abarque el reemplazo de las sumas de verificación de origen, incluidas las salidas que no se modificaron en la ejecución de alcance limitado más reciente. Resuelve los errores y concilia las correcciones manuales aceptadas con ese contenido de origen. Si alguna salida sigue desactualizada o genera dudas, deja pendiente la línea base compartida.
- Si el trabajo de alcance limitado dejó intacta la línea base existente y todas las salidas abarcadas ya están aceptadas, ejecuta
lingo lockfile --forcedesde el directorio raíz del proyecto que corresponda. Este comando reemplaza las sumas de verificación de origen sin traducir, así que no lo uses para omitir la revisión anterior ni supongas que el último selector de idioma de destino limita este reemplazo. - Revisa las diferencias del Lockfile e incluye en un mismo commit la revisión exacta del contenido de origen, todas las traducciones de destino correspondientes aceptadas y
i18n.lock. Una ejecución posterior delingo run --frozenpuede comprobar la sincronización con esa línea base consolidada; no puede determinar si el contenido de destino está actualizado ni si la traducción es de calidad.
El modo congelado no es estrictamente de solo lectura cuando falta i18n.lock. Puede inicializar primero las sumas de verificación, y la sola presencia de claves de destino no demuestra que el contenido esté actualizado. Establece un par de origen y destino confiable antes de interpretar una comprobación exitosa en modo congelado como prueba de sincronización.
Recupera el estado faltante o en conflicto #
Cuando falta el Lockfile, v0 no necesariamente regenera todo el contenido de destino presente: sin una suma de verificación previa, puede conservar sus valores. Revisa los pares de origen y destino que generen dudas antes de aceptar una línea base recién creada. Traducciones existentes explica ese caso de adopción.
Si hay un conflicto de fusión, primero concilia los cambios de origen y destino de ambas ramas. Restaura un Lockfile confiable cuando sea posible. Si debes reconstruirlo, revisa los pares de traducción reales, porque la reconstrucción registra el estado de origen, no si el contenido de destino está actualizado.
El procedimiento de reparación del YAML heredado conserva la última entrada duplicada e informa las eliminaciones. Eso 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 incluir el archivo reparado en un commit junto con las salidas aceptadas.