Migra a la CLI actual
Sustituye los grupos de archivos y las huellas del contenido de origen del sistema anterior sin perder las traducciones aceptadas ni dejar de tener una aplicación funcional.
La @lingo.dev/cli actual realiza las operaciones de envío y descarga en el servidor y usa el estado del proyecto de .lingo. El paquete lingo.dev anterior procesa los grupos de archivos en 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 #
Anota la versión instalada y guarda en el control de versiones el contenido de origen, las traducciones de destino aceptadas, la configuración y el Lockfile anterior. Confirma que la aplicación carga 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 una alternativa de alcance acotado.
Anota las versiones del marco de desarrollo y del entorno de ejecución, así como los idiomas de origen, destino y predeterminado necesarios. Prueba rutas representativas con prefijo de idioma, la detección inicial, el comportamiento de reserva y el cambio de idioma. Mantén estas comprobaciones 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 destino y entradas explícitas para los archivos; después, vincula tu organización autorizada y tu motor de localización. Los grupos de archivos y las huellas del sistema anterior no pueden adaptarse a este esquema con un simple cambio de 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 único 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). Antes de migrar un archivo de un grupo csv de v0, comprueba que se ajuste a la estructura CSV. Contrasta las rutas de un grupo properties de v0 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 grupos de CSV por idioma, MJML y otros exclusivos de la versión anterior necesitan una conversión verificada u otra vía de traducción. En Configuración encontrarás los valores exactos de la enumeración, las reglas de coincidencia y las plantillas de salida. Los ajustes de modelo, instrucciones y URL base de v0 para proveedores directos no tienen cabida en 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 acotado y de inicialización permite adoptar traducciones de destino existentes. Revisa archivos representativos y las ediciones manuales antes de establecer ese punto de referencia: que un archivo exista no demuestra que sus valores correspondan al contenido de origen más reciente.
El proceso de completado añade los archivos ordinarios que faltan, mientras que v0 suele añadir las claves que faltan en los catálogos existentes. Para ese trabajo posterior, usa las actualizaciones incrementales del contenido de origen o la actualización de claves admitida por la versión actual. Una clave JSON renombrada se considera trabajo nuevo basado en su ruta, aunque su texto coincida con el de una clave antigua; no confíes en la reutilización de traducciones tras un cambio de nombre mediante las huellas del contenido de v0.
Durante el trabajo incremental pueden conservarse las ediciones de destino de las claves que no han cambiado. Las reglas explícitas para conservar claves añaden una decisión independiente sobre quién controla su contenido. En los formatos con archivos separados, forzar la actualización del archivo completo elimina el contexto del destino actual y puede sustituir textos aceptados, por lo que no es un atajo para adoptar traducciones.
Completa la primera ejecución de la versión actual #
Sigue la guía de inicio rápido actual hasta completar los archivos que faltan y recuperar los archivos. Un primer envío simple sin un punto 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 en un mismo commit el origen, el destino y la configuración aceptados, junto con el Lockfile actual. El puntero a la última ejecución se mantiene localmente en el directorio personal y no se transfiere mediante Git. Un pull posterior compara los hashes; incluir solo una modificación divergente en un commit no resuelve ese conflicto. lingo check sustituye el antiguo control de 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 si falta. Sin un Lockfile incluido en un commit, no puede detectar cambios en el origen y solo comprueba que existan los archivos de destino.
Migración de React #
El flujo de trabajo actual de React extrae las llamadas con texto de origen literal y contexto a JSONC y declaraciones, traduce los catálogos seleccionados y después carga un mapa de cadenas en tiempo de ejecución. Comprueba el comportamiento de reserva, las variables, el cambio de idioma y los textos aceptados 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.