lingo init

Crea la configuración de localización con rutas explícitas para el origen, los destinos y el catálogo.

lingo init escribe la configuración de localización en .lingo/config.json. Úsalo cuando un proyecto necesite definir por primera vez el idioma de origen, la lista de idiomas de destino y los patrones de archivos. Los archivos de origen, las credenciales y la vinculación con el motor de localización se gestionan por separado: la inicialización no crea ni traduce esos recursos.

sh
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yes

Abre el archivo generado y verifica que seleccione únicamente el contenido de origen que quieres usar. Luego, crea esos archivos si es necesario, inicia sesión y ejecuta link antes de traducir de forma remota.

Opciones #

OpciónValor predeterminado o efecto
--source <locale>en al aceptar los valores predeterminados.
--targets <list>Idiomas separados por comas; de,fr,es con --yes.
--files <list>Patrones separados por comas: locales/<source>.json con --yes, por ejemplo, locales/en.json.
--messages-path <path>Define i18n.messagesPath del catálogo de React; valor predeterminado: locales.
--types-path <path>Define i18n.typesPath de la declaración; valor predeterminado: lingo.d.ts.
--forceReemplaza la configuración de localización existente.
--no-agents-mdOmite el bloque de Lingo.dev en AGENTS.md y CLAUDE.md.
--yes, -yUsa los valores proporcionados o predeterminados sin hacer preguntas.

Sin --yes, se te pide que elijas las opciones que faltan. Las listas se separan por comas y espacios, así que, para agregar un patrón que contenga un espacio, edita .lingo/config.json. Se eliminan los idiomas de destino duplicados y el que coincida exactamente con el idioma de origen. Si la lista resultante de idiomas de destino queda vacía, se rechaza. Escribe los patrones entre comillas para que el intérprete de comandos no los expanda antes de que los reciba la CLI.

Init también escribe un bloque de Lingo.dev en el AGENTS.md del proyecto y crea el archivo si no existe. Además, lo escribe en un CLAUDE.md existente, a menos que este importe un AGENTS.md que reciba el bloque. El bloque indica a los agentes de programación que ejecuten npx @lingo.dev/cli agent-guide antes de realizar tareas de localización. El texto fuera de los marcadores del bloque se conserva, y una ejecución posterior reemplaza solo el texto entre ellos.

Reinicializar un proyecto existente #

Sin forzar la operación, se conserva la configuración de localización existente y la inicialización falla en lugar de sobrescribirla. Al forzarla, el comando reconstruye files[] a partir de los patrones. Se pierden las opciones avanzadas de las entradas, como las exclusiones, los formatos explícitos, las plantillas de salida y los controles de claves. Guarda esas opciones antes de forzar la operación o, si solo necesitas un cambio menor, edita la configuración existente.

Las demás secciones de nivel raíz se conservan, incluida la vinculación con la organización y el motor de localización. Los valores predeterminados de las rutas del catálogo se omiten en la configuración guardada; una ejecución forzada que restablezca esos valores puede borrar las personalizaciones anteriores de i18n. Cambiar las rutas del catálogo no modifica automáticamente los patrones de los archivos de traducción.

La guía para el primer archivo continúa desde la configuración hasta la traducción inicial del contenido existente y la recuperación de los archivos de destino. Consulta Configuración como referencia para las entradas de archivos avanzadas.