lingo init
Crea la configuración de localización definiendo explícitamente el idioma de origen, los idiomas de destino y las rutas de catálogo.
lingo init escribe los ajustes de localización en .lingo/config.json. Úsalo cuando un proyecto necesite definir por primera vez su idioma de origen, su lista de idiomas de destino y sus patrones de archivo. 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.
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yesAbre el archivo generado y comprueba que solo selecciona el contenido de origen que quieres incluir. Después, crea esos archivos si es necesario, inicia sesión y ejecuta link antes de realizar una traducción remota.
Opciones #
| Opción | Valor 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> | Establece el catálogo de React i18n.messagesPath; valor predeterminado: locales. |
--types-path <path> | Establece la declaración i18n.typesPath; valor predeterminado: lingo.d.ts. |
--force | Sustituye los ajustes de localización existentes. |
--no-agents-md | Omite el bloque de Lingo.dev en AGENTS.md y CLAUDE.md. |
--yes, -y | Usa los valores proporcionados o predeterminados sin hacer preguntas. |
Sin --yes, se te pedirá que indiques las opciones que faltan. Las listas se dividen por comas y espacios, así que, para añadir 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 de destinos resultante queda vacía, se rechaza. Pon 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 añade a un CLAUDE.md existente, salvo 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 las ejecuciones posteriores sustituyen únicamente el texto que hay entre ellos.
Reinicializar un proyecto existente #
Si no fuerzas la operación, la configuración de localización existente se conserva y la inicialización falla en lugar de sobrescribirla. Si la fuerzas, 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 pequeño cambio, 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 de catálogo se omiten en la configuración guardada; una ejecución forzada que restablezca esos valores puede borrar los valores personalizados anteriores de i18n. Cambiar las rutas de catálogo no modifica automáticamente los patrones de los archivos de traducción.
La guía del primer archivo cubre los pasos que siguen a la configuración: la traducción inicial del contenido existente y la obtención de los archivos de destino. Consulta Configuración como referencia para las entradas de archivo avanzadas.