Formatos suportados

A CLI do Lingo.dev usa tipos de bucket para processar e traduzir diferentes formatos de ficheiro. Cada tipo de bucket é um parser específico, criado para um formato concreto. Configure um ou mais buckets no seu i18n.json para definir que ficheiros a CLI deve traduzir.

Tipos de bucket#

Modos de saída#

Os buckets funcionam num de dois modos de saída:

Ficheiros separados por idioma — a CLI cria um ficheiro distinto para cada idioma de destino. Os padrões de inclusão têm de conter o placeholder [locale]:

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

Isto gera locales/en.json, locales/es.json, locales/fr.json, etc.

Altera o ficheiro de origem — a CLI escreve as traduções no mesmo ficheiro que contém o conteúdo original. O placeholder [locale] não é utilizado:

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

Os ficheiros CSV normalmente guardam todos os idiomas em colunas dentro de um único ficheiro. Os catálogos Xcode .xcstrings e o YAML com chaves de raiz funcionam de forma semelhante.

Exemplos de configuração#

Aplicação web com JSON#

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

Site de documentação com Markdown#

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

Aplicação móvel (iOS + Android)#

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

Monorepo com vários 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"]
    }
  }
}

Funcionalidades específicas por bucket#

Alguns buckets suportam funcionalidades adicionais para além dos padrões de inclusão/exclusão:

Regras dos padrões de inclusão#

• Os padrões são relativos à localização do ficheiro i18n.json
• Use [locale] como placeholder para os códigos de idioma (obrigatório para buckets de "ficheiros separados")
• O asterisco (*) corresponde a qualquer nome de ficheiro: locales/[locale]/*.json
• Os padrões recursivos (**) correspondem a ficheiros em qualquer profundidade: src/**/[locale].json, config/locales/**/[locale].yml. Quando um padrão usa **, node_modules, .git, dist, build, .next e .turbo são excluídos por predefinição — adicione as suas próprias entradas exclude conforme necessário (requer CLI 0.135.0+)
• As extensões dos ficheiros não afetam o processamento — o tipo de bucket determina o parser

Próximos passos#