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.
| Grupo | Conteúdo | Modelo de saída documentado |
|---|---|---|
json, json5, jsonc | Variantes de JSON estruturado | Arquivos separados por idioma |
json-dictionary | Valores JSON que contêm objetos com chaves por idioma | Arquivo compartilhado |
yaml | Catálogo YAML | Arquivos separados por idioma |
yaml-root-key | YAML encapsulado na chave raiz do idioma de saída | Arquivos separados por idioma |
markdown, mdx, markdoc | Documentos da família Markdown | Arquivos separados por idioma |
html, mjml | Marcação HTML e de e-mail | Arquivos separados por idioma |
android | Recursos XML do Android | Arquivos separados por idioma |
xcode-strings, xcode-stringsdict | Recursos de strings e plurais da Apple | Arquivos separados por idioma |
xcode-xcstrings | Catálogo de strings do Xcode | Arquivo compartilhado |
flutter | Catálogo ARB | Arquivos separados por idioma |
po | PO do Gettext | Arquivos separados por idioma |
properties | Propriedades Java | Arquivos separados por idioma |
csv | CSV com vários idiomas | Arquivo compartilhado |
csv-per-locale | Um CSV por idioma | Arquivos separados por idioma |
xml, xliff | XML e XLIFF | Arquivos separados por idioma |
srt, vtt | Legendas | Arquivos separados por idioma |
php | Arrays de localização em PHP | Arquivos separados por idioma |
typescript | Conteúdo de localização em TypeScript | Arquivos separados por idioma |
vue-json | Blocos JSON do Vue i18n com chaves por idioma | Arquivo compartilhado |
txt | Texto simples | Arquivos 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:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Para um catálogo Xcode compartilhado usado junto com recursos do Android específicos de cada idioma:
{
"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:
{
"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.