Configuración de CLI v0
Configura contenedores heredados, rutas de idiomas y servicios de traducción sin mezclar generaciones.
lingo.dev@0.138.10 lee i18n.json del directorio de trabajo. Cada contenedor especifica su analizador y detecta archivos; los ajustes de idioma definen el idioma de origen y los de destino. Este contrato es independiente del que utiliza .lingo/config.json actualmente.
Declara idiomas y contenedores #
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
},
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}Las rutas se resuelven tomando la configuración como referencia. La clave del contenedor selecciona el analizador, no la extensión del archivo. Consulta la matriz de formatos y salidas de la versión heredada cuando un formato almacene varios idiomas en un solo archivo.
El campo version registra la generación del esquema. Una migración del esquema heredado puede actualizar ese archivo sin migrar a la CLI actual. Conserva la configuración anterior y revisa todos los cambios generados.
Define las coincidencias de rutas con cuidado #
[locale] se sustituye por el código del idioma de origen o de destino. Un delimitador específico para cada ruta permite usar nombres de archivo con guiones bajos:
{
"include": [
"standard/[locale].json",
{ "path": "legacy/[locale].json", "delimiter": "_" }
]
}Para en-US, la segunda ruta usa legacy/en_US.json. La representación en el nombre del archivo es independiente de los valores de idioma normalizados que se envían al servicio.
La detección recursiva de ** está disponible a partir de 0.135.0; las versiones anteriores necesitan rutas explícitas. De forma predeterminada, la detección recursiva excluye node_modules, .git, dist, build, .next y .turbo. Añade exclusiones para otros árboles de directorios generados.
Define el comportamiento de las claves #
Los controles de claves heredados usan rutas de recorrido separadas por barras y coincidencias con comodines. modules/ai.translation selecciona la clave literal que contiene puntos dentro de modules. El bloqueo copia los valores de origen; la omisión los excluye de la salida; y la conservación inicializa los valores que faltan a partir del origen y deja después su gestión en manos de una persona. injectLocale selecciona las claves de salida para el código del idioma de destino.
Consulta Controles de claves para conocer los efectos exactos. Una instrucción de traducción no protege la estructura, y un texto provisional en el idioma de origen sigue necesitando una traducción humana antes de usarse.
Elige un motor de localización o un proveedor directo #
Con una credencial de Lingo.dev, engineId selecciona el glosario, las reglas, la voz y los modelos de un motor de localización. Es preferible seleccionarlo de forma explícita. Si se omite, se aplica la política del servicio en lugar de especificar una configuración estable; el servicio actual puede exigir un ID o seleccionar el motor de localización habilitado más antiguo al que tenga acceso la clave.
Los proveedores directos usan un ID de proveedor, un modelo y una instrucción. Este formato histórico no debe tomarse como una recomendación ni como una indicación de que el modelo mencionado siga disponible:
{
"provider": {
"id": "openai",
"model": "gpt-4o-mini",
"prompt": "Translate the provided text from {source} to {target}."
}
}La instrucción sustituye {source} y {target} por códigos de idioma. No confíes en provider.baseUrl para redirigir las solicitudes run de lingo.dev@0.138.10. La ruta de OpenAI pasa baseUrl, mientras que la dependencia del proveedor fijada a una versión lee baseURL, por lo que ese valor de configuración se ignora. La dependencia admite OPENAI_BASE_URL en su lugar; comprueba el destino previsto antes de enviar contenido o credenciales. La ruta de Ollama también ignora provider.baseUrl y crea el proveedor con los valores predeterminados. Su servicio debe ser accesible desde el entorno de ejecución; un entorno de ejecución remoto no puede usar la dirección localhost de un portátil.
| Servicio | Credencial |
|---|---|
| Lingo.dev | LINGO_API_KEY |
| OpenAI | OPENAI_API_KEY |
| Anthropic | ANTHROPIC_API_KEY |
GOOGLE_API_KEY | |
| Mistral | MISTRAL_API_KEY |
| OpenRouter | OPENROUTER_API_KEY |
| Ollama local | La configuración local no usa una clave de API del proveedor. |
LINGO_API_URL cambia el destino del servicio de Lingo.dev; sigue siendo necesario comprobar que sea compatible y de confianza. Mantén las credenciales fuera de la configuración y los registros. Tras cambiar el servicio o la detección, reproduce una pequeña ejecución con el primer archivo. Cambiar un modelo o una instrucción no modifica las huellas del contenido de origen, por lo que el texto existente necesita una actualización deliberada si lo que buscas es actualizarlo.