Formatos da CLI v0

Associe o analisador legado instalado à estrutura de idiomas correspondente e verifique o arquivo nativo reconstruído.

Escolha o grupo com base nos dados que você quer extrair e nos arquivos que espera receber. A v0 usa o tipo do grupo para selecionar um analisador; a extensão não altera essa escolha. Por isso, um catálogo JSON e um catálogo Xcode com vários idiomas precisam de configurações diferentes, mesmo que ambos contenham mensagens.

Escolha primeiro o modelo de saída #

A maioria dos grupos grava arquivos separados por idioma usando [locale] no caminho. CSV, catálogos de strings do Xcode, dicionários JSON e blocos Vue i18n podem conter vários idiomas em um único arquivo. Quando a saída for compartilhada, confira tanto a seção de destino quanto a de origem após a tradução.

GrupoConteúdoModelo de saída documentado
json, json5, jsoncVariantes de JSON estruturadoArquivos separados por idioma
json-dictionaryValores JSON que contêm objetos com chaves por idiomaArquivo compartilhado
yamlCatálogo YAMLArquivos separados por idioma
yaml-root-keyYAML encapsulado na chave raiz do idioma de saídaArquivos separados por idioma
markdown, mdx, markdocDocumentos da família MarkdownArquivos separados por idioma
html, mjmlMarcação HTML e de e-mailArquivos separados por idioma
androidRecursos XML do AndroidArquivos separados por idioma
xcode-strings, xcode-stringsdictRecursos de strings e plurais da AppleArquivos separados por idioma
xcode-xcstringsCatálogo de strings do XcodeArquivo compartilhado
flutterCatálogo ARBArquivos separados por idioma
poPO do GettextArquivos separados por idioma
propertiesPropriedades JavaArquivos separados por idioma
csvCSV com vários idiomasArquivo compartilhado
csv-per-localeUm CSV por idiomaArquivos separados por idioma
xml, xliffXML e XLIFFArquivos separados por idioma
srt, vttLegendasArquivos separados por idioma
phpArrays de localização em PHPArquivos separados por idioma
typescriptConteúdo de localização em TypeScriptArquivos separados por idioma
vue-jsonBlocos JSON do Vue i18n com chaves por idiomaArquivo compartilhado
txtTexto simplesArquivos separados por idioma

Esta é a família legada de grupos, não uma lista de compatibilidade com outras ferramentas. Alguns itens podem ter sido incluídos apenas em versões mais recentes da v0. Os analisadores de TypeScript, PHP e Vue processam as estruturas de localização para as quais oferecem suporte; a presença deles não autoriza a reescrita arbitrária de código-fonte executável.

O despachante 0.138.10 também contém ail, ejs, twig, dato e xcode-xcstrings-v2. Mantenha o analisador já usado pelo projeto instalado até verificar sua entrada e sua saída. Uma enumeração no esquema, por si só, não basta: o esquema legado também lista compiler, mas esse fluxo de despacho não tem um carregador correspondente.

yaml-root-key reconstrói apenas a raiz do idioma selecionado. Não aponte a origem e o destino para o mesmo arquivo YAML compartilhado: uma gravação pode substituir as demais raízes. Use um caminho específico para o idioma, como locales/[locale].yml. Esse comportamento difere do de um dicionário JSON ou bloco Vue que mescla explicitamente um novo idioma à estrutura original.

Configure um arquivo representativo #

Para JSON, o mesmo padrão identifica um arquivo de origem e destinos separados:

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

Para um catálogo Xcode compartilhado usado junto com recursos do Android específicos de cada idioma:

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

Adapte a notação dos idiomas do Android e os diretórios de recursos à aplicação. Após a primeira execução, valide os dois formatos nativos com as respectivas ferramentas de compilação e confirme que a aplicação carrega o destino selecionado. O fato de a configuração ser aceita não garante, por si só, que o caminho funcione.

Localize arquivos sem selecionar a saída gerada #

Os caminhos são resolvidos em relação a i18n.json; * encontra correspondências dentro de um nível. O suporte ao uso recursivo de ** foi introduzido em 0.135.0. Por padrão, ele exclui node_modules, .git, dist, build, .next e .turbo. Exclua explicitamente qualquer outro conteúdo gerado:

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

Para vários pacotes, escolha uma configuração compartilhada ou por pacote de acordo com os idiomas e com quem é responsável pelo engine de localização. Caminhos bem delimitados evitam que a saída gerada seja usada inesperadamente como entrada de origem.

Verifique as proteções específicas de cada formato #

Para catálogos de chave/valor, aplique controles de chaves de acordo com quem é responsável por cada valor. Comentários em JSONC e em catálogos do Xcode podem conter notas para tradutores. Documentos de formato livre e legendas não usam necessariamente esses recursos da mesma forma.

Confira o que o analisador reconstruiu: chaves e valores de catálogos, marcação e links de documentos, marcações de tempo de legendas ou identificadores de recursos nativos. Aceite a saída somente depois de confirmar que o analisador ou processo de compilação que a consome consegue usá-la. Ao migrar, consulte o Manual de formatos atual e a lista de formatos compatíveis da ferramenta que faz a chamada, em vez de presumir que esta matriz legada também se aplica.