Formatos compatibles

La CLI de Lingo.dev utiliza tipos de bucket para analizar y traducir distintos formatos de archivo. Cada tipo de bucket es un parser específico diseñado para un formato concreto. Configura uno o varios buckets en tu i18n.json para definir qué archivos debe traducir la CLI.

Tipos de bucket#

Modos de salida#

Los buckets funcionan en uno de estos dos modos de salida:

Archivos independientes por idioma: la CLI crea un archivo distinto para cada idioma de destino. Los patrones include deben contener el marcador [locale]:

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}

Esto genera locales/en.json, locales/es.json, locales/fr.json, etc.

Modifica el archivo de origen: la CLI escribe las traducciones en el mismo archivo que contiene el contenido original. En este caso, no se utiliza el marcador [locale]:

{
  "buckets": {
    "csv": {
      "include": ["translations.csv"]
    }
  }
}

Los archivos CSV suelen almacenar todos los idiomas en columnas dentro de un único archivo. Los catálogos .xcstrings de Xcode y los archivos YAML con claves raíz funcionan de forma parecida.

Ejemplos de configuración#

Aplicación web con JSON#

{
  "buckets": {
    "json": {
      "include": ["src/locales/[locale].json"],
      "lockedKeys": ["brand/name"]
    }
  }
}

Sitio de documentación con Markdown#

{
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

Aplicación móvil (iOS + Android)#

{
  "buckets": {
    "xcode-xcstrings": {
      "include": ["ios/Localizable.xcstrings"]
    },
    "android": {
      "include": ["android/app/src/main/res/values-[locale]/strings.xml"]
    }
  }
}

Monorepo con varios formatos#

{
  "buckets": {
    "json": {
      "include": ["apps/web/locales/[locale].json"]
    },
    "mdx": {
      "include": ["packages/docs/content/[locale]/*.mdx"]
    },
    "flutter": {
      "include": ["apps/mobile/lib/l10n/app_[locale].arb"]
    }
  }
}

Funciones específicas de cada bucket#

Algunos buckets admiten funciones adicionales más allá de los patrones include/exclude:

Reglas de los patrones include#

• Los patrones son relativos a la ubicación del archivo i18n.json
• Usa [locale] como marcador para los códigos de idioma (obligatorio en los buckets de "archivos independientes")
• El asterisco (*) coincide con cualquier nombre de archivo: locales/[locale]/*.json
• Los patrones recursivos (**) coinciden con archivos a cualquier nivel de profundidad: src/**/[locale].json, config/locales/**/[locale].yml. Cuando un patrón usa **, node_modules, .git, dist, build, .next y .turbo se excluyen por defecto; añade tus propias entradas exclude además según lo necesites (requiere CLI 0.135.0+)
• Las extensiones de archivo no afectan al análisis: el tipo de bucket determina qué parser se utiliza

Siguientes pasos#