Formatos compatíveis

A CLI da Lingo.dev usa tipos de bucket para processar e traduzir diferentes formatos de arquivo. Cada tipo de bucket é um parser dedicado, criado para um formato específico. Configure um ou mais buckets no seu i18n.json para definir quais arquivos a CLI deve traduzir.

Tipos de bucket#

Modos de saída#

Os buckets operam em um de dois modos de saída:

Arquivos separados por idioma — a CLI cria um arquivo distinto para cada idioma de destino. Os padrões de inclusão precisam conter o placeholder [locale]:

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

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

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

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

Arquivos CSV geralmente armazenam todos os idiomas em colunas dentro de um único arquivo. Catálogos .xcstrings do Xcode e YAML com chaves raiz funcionam de forma parecida.

Exemplos de configuração#

Aplicativo 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"]
    }
  }
}

Aplicativo mobile (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"]
    }
  }
}

Recursos específicos de bucket#

Alguns buckets oferecem recursos adicionais 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 arquivo i18n.json
• Use [locale] como placeholder para códigos de idioma (obrigatório para buckets de "arquivos separados")
• O asterisco (*) corresponde a qualquer nome de arquivo: locales/[locale]/*.json
• Padrões recursivos (**) correspondem a arquivos em qualquer nível de 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 padrão — adicione suas próprias entradas exclude por cima, conforme necessário (requer CLI 0.135.0+)
• As extensões de arquivo não afetam o parsing — o tipo de bucket é que determina o parser

Próximos passos#