Configuración de la CLI v0

Configura contenedores heredados, rutas de idiomas y sistemas de traducción sin mezclar generaciones.

lingo.dev@0.138.10 lee i18n.json desde el directorio de trabajo. Cada contenedor define su analizador y detecta archivos; la configuración de idiomas identifica el idioma de origen y los de destino. Este contrato es independiente del que usa .lingo/config.json actualmente.

Declara idiomas y contenedores #

json
{
  "$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 con respecto a la configuración. La clave del contenedor selecciona el analizador, no la extensión del archivo. Consulta la matriz de formatos y salidas 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 con cuidado las coincidencias de rutas #

[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:

json
{
  "include": [
    "standard/[locale].json",
    { "path": "legacy/[locale].json", "delimiter": "_" }
  ]
}

Para en-US, la segunda ruta usa legacy/en_US.json. La forma en que el idioma aparece en el nombre del archivo es independiente de los valores de idioma normalizados que se envían al sistema de traducción.

La detección recursiva de ** está disponible a partir de 0.135.0; las versiones anteriores requieren rutas explícitas. De forma predeterminada, la detección recursiva excluye node_modules, .git, dist, build, .next y .turbo. Agrega exclusiones para otros árboles de archivos 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 con puntos dentro de modules. El bloqueo copia los valores de origen; la opción de ignorar los omite de la salida; y la preservación completa los valores faltantes con los de origen y luego los deja bajo control humano. 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 marcador de posición 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 explícitamente. Si lo omites, se aplica la política del sistema de traducción en lugar de indicar una configuración estable; el servicio actual puede exigir un ID o seleccionar el motor de localización habilitado más antiguo al que la clave tenga acceso.

Los proveedores directos usan un ID de proveedor, un modelo y una instrucción. Este formato histórico no debe interpretarse como una recomendación ni como garantía de que el modelo indicado siga disponible:

json
{
  "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 dependas de provider.baseUrl para redirigir las solicitudes de run de lingo.dev@0.138.10. La ruta de OpenAI pasa baseUrl, mientras que la dependencia del proveedor, fijada a una versión específica, lee baseURL, por lo que ese valor de configuración se ignora. La dependencia admite OPENAI_BASE_URL en su lugar; verifica 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 una computadora portátil.

Sistema de traducciónCredencial
Lingo.devLINGO_API_KEY
OpenAIOPENAI_API_KEY
AnthropicANTHROPIC_API_KEY
GoogleGOOGLE_API_KEY
MistralMISTRAL_API_KEY
OpenRouterOPENROUTER_API_KEY
Ollama localLa configuración local no usa una clave de API del proveedor.

LINGO_API_URL cambia el destino del servicio de Lingo.dev; aun así, debes verificar la compatibilidad y la confiabilidad. Mantén las credenciales fuera de la configuración y de los registros. Después de cambiar el sistema de traducción o la detección de archivos, reproduce una pequeña ejecución con el primer archivo. Cambiar un modelo o una instrucción no modifica las huellas digitales del contenido de origen, por lo que el texto existente requiere una actualización deliberada si eso es lo que buscas.