Migra a la CLI actual

Reemplaza los buckets heredados y las huellas del contenido de origen sin perder las traducciones aceptadas ni dejar de tener una aplicación funcional.

La @lingo.dev/cli actual usa operaciones de envío y descarga del lado del servidor y el estado del proyecto de .lingo. El paquete anterior lingo.dev procesa los buckets de forma local y usa i18n.json y i18n.lock. Migrar implica conservar el comportamiento que necesita el proyecto, no solo cambiar el nombre de un comando.

Conserva un punto de partida funcional #

Registra la versión instalada y conserva el contenido de origen, las traducciones de destino aceptadas, la configuración y el Lockfile anterior en el control de versiones. Confirma que la aplicación cargue esas traducciones. Mantén el enrutador, el proveedor, el selector de idioma y el cargador de catálogos de la configuración de localización existente hasta que funcione un reemplazo de alcance limitado.

Registra las versiones del framework y del entorno de ejecución, junto con los idiomas de origen, de destino y predeterminado requeridos. Prueba rutas representativas con prefijo de idioma, la detección inicial, el comportamiento de respaldo y el cambio de idioma. Mantén estas verificaciones de la aplicación separadas de la migración de la traducción de archivos.

Reconfigura la selección de archivos #

Crea .lingo/config.json con los idiomas de origen y de destino y entradas explícitas de archivos; luego vincula tu organización autorizada y tu motor de localización. Los buckets y las huellas heredados no se pueden adaptar a este esquema con solo cambiarles el nombre.

La configuración actual de la CLI admite 22 formatos, entre ellos HTML (.html y .htm), texto sin formato (.txt, una unidad por línea, como en v0), tablas CSV con una columna por idioma en un solo archivo y archivos .properties de Java (una unidad por clave, como en v0, con lockedKeys, preservedKeys y ignoredKeys que se cotejan igual que en v0, y lockedPatterns en sintaxis RE2, que no admite aserciones de anticipación ni de retrospección, ni referencias inversas). Revisa un archivo del contenedor csv de v0 y compáralo con la estructura CSV antes de moverlo. Revisa las rutas de un contenedor properties de v0 y compáralas con las propiedades de Java: un nombre de archivo [locale] como messages_[locale].properties se convierte en un patrón de origen como messages_en.properties. Los contenedores CSV por idioma, MJML y otros exclusivos de la versión anterior requieren una conversión verificada u otra vía de traducción. Configuración detalla los valores exactos de la enumeración, las reglas de coincidencia y las plantillas de salida. Los ajustes de modelo, instrucciones y URL base para proveedores directos de v0 no corresponden a este esquema de proyecto.

Revisa un archivo de origen seleccionado y las rutas de destino que se derivan de él antes de ampliar la configuración. Para las propiedades de los formatos de la familia Markdown, usa translateComponentProps.

Adopta y actualiza las traducciones #

La planificación actual de alcance limitado o de inicialización permite adoptar las traducciones de destino existentes. Revisa archivos representativos y las modificaciones hechas por personas antes de establecer esa base de referencia: que los archivos existan no demuestra que sus valores correspondan al contenido de origen más reciente.

El proceso de completar faltantes crea los archivos comunes que faltan, mientras que v0 normalmente completa las claves que faltan dentro de los catálogos existentes. Para ese trabajo posterior, usa las actualizaciones incrementales actuales del contenido de origen o la función compatible de actualización de claves. Una clave JSON renombrada se considera trabajo nuevo basado en rutas, incluso si su texto coincide con el de una clave anterior; no dependas de la reutilización que ofrece v0 al renombrar claves mediante huellas de contenido.

Durante el trabajo incremental, se pueden conservar las modificaciones de las traducciones de destino correspondientes a claves que no cambiaron. Las reglas explícitas para conservar claves agregan una decisión independiente sobre quién controla su contenido. En los formatos con archivos separados, forzar la actualización de todo el archivo elimina el contexto del destino actual y puede reemplazar la redacción aceptada, por lo que no es un atajo para adoptar traducciones existentes.

Completa la primera ejecución con la CLI actual #

Sigue la guía de inicio rápido actual hasta completar los faltantes y recuperar los archivos. Un primer envío simple sin una base de referencia almacena los bytes del contenido de origen en lugar de solicitar las traducciones iniciales. Espera o descarga los archivos antes de dar por terminado el flujo de trabajo de archivos.

Incluye el origen, el destino y la configuración aceptados, junto con el Lockfile actual, en un mismo commit. El puntero a la última ejecución permanece en el directorio personal local y no se transfiere por Git. Un pull posterior compara los hashes; guardar solo una edición divergente en un commit no resuelve ese conflicto. lingo check reemplaza la antigua verificación del Lockfile congelado a nivel de archivo: falla si un origen ha cambiado desde .lingo/lock.json o si falta un archivo de destino, y nunca crea un Lockfile faltante. Sin un Lockfile guardado en un commit, no puede detectar cambios en el origen y solo verifica que existan los archivos de destino.

Migración de React #

El flujo de trabajo actual de React extrae las llamadas con texto literal de origen y contexto a JSONC y declaraciones, traduce los catálogos seleccionados y luego carga un mapa de cadenas en tiempo de ejecución. Verifica el comportamiento de respaldo, las variables, el cambio de idioma y la redacción aceptada de un componente antes de extender el cambio.

Usa Migrar mensajes existentes de React y React para el trabajo específico del paquete. El lingo guide migrate incluido refleja la versión instalada; no garantiza la equivalencia con todas las configuraciones generadas anteriormente.