Formatos da CLI v0
Associe um analisador legado instalado à respetiva estrutura por idioma e verifique o ficheiro nativo reconstruído.
Escolha o grupo com base nos dados que pretende extrair e nos ficheiros que espera obter. A v0 utiliza 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 exigem configurações diferentes, mesmo que ambos contenham mensagens.
Escolha primeiro o modelo de saída #
A maioria dos grupos grava ficheiros separados por idioma, utilizando [locale] no caminho. Os ficheiros CSV, os catálogos de cadeias de caracteres do Xcode, os dicionários JSON e os blocos Vue i18n podem conter vários idiomas num único ficheiro. Quando a saída é partilhada, verifique tanto a secção de destino como a de origem após a tradução.
| Grupo | Conteúdo | Modelo de saída documentado |
|---|---|---|
json, json5, jsonc | Variantes de JSON estruturado | Ficheiros separados por idioma |
json-dictionary | Valores JSON que contêm objetos com chaves por idioma | Ficheiro partilhado |
yaml | Catálogo YAML | Ficheiros separados por idioma |
yaml-root-key | YAML contido na chave de raiz do idioma de saída | Ficheiros separados por idioma |
markdown, mdx, markdoc | Documentos da família Markdown | Ficheiros separados por idioma |
html, mjml | Marcação HTML e de e-mail | Ficheiros separados por idioma |
android | Recursos XML do Android | Ficheiros separados por idioma |
xcode-strings, xcode-stringsdict | Cadeias de caracteres e recursos de plural da Apple | Ficheiros separados por idioma |
xcode-xcstrings | Catálogo de cadeias de caracteres do Xcode | Ficheiro partilhado |
flutter | Catálogo ARB | Ficheiros separados por idioma |
po | PO do Gettext | Ficheiros separados por idioma |
properties | Propriedades Java | Ficheiros separados por idioma |
csv | CSV com vários idiomas | Ficheiro partilhado |
csv-per-locale | Um CSV por idioma | Ficheiros separados por idioma |
xml, xliff | XML e XLIFF | Ficheiros separados por idioma |
srt, vtt | Legendas | Ficheiros separados por idioma |
php | Matrizes de localização em PHP | Ficheiros separados por idioma |
typescript | Conteúdo de localização em TypeScript | Ficheiros separados por idioma |
vue-json | Blocos JSON do Vue i18n com chaves por idioma | Ficheiro partilhado |
txt | Texto simples | Ficheiros separados por idioma |
Esta é a família de grupos legados, não uma lista de compatibilidade com outras ferramentas. Algumas entradas podem não existir nas versões v0 mais antigas. Os analisadores de TypeScript, PHP e Vue processam as estruturas de localização que suportam; a sua presença não autoriza a reescrita arbitrária de código-fonte executável.
O mecanismo de encaminhamento 0.138.10 também contém ail, ejs, twig, dato e xcode-xcstrings-v2. Mantenha o analisador que o projeto instalado já utiliza até verificar a respetiva entrada e saída. Um valor enumerado no esquema, por si só, não basta: o esquema legado também inclui compiler, mas esta via de encaminhamento não dispõe de 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 ficheiro YAML partilhado: uma operação de escrita pode substituir as restantes raízes. Utilize um caminho específico por idioma, como locales/[locale].yml. Este comportamento difere do de um dicionário JSON ou de um bloco Vue que integra explicitamente um novo idioma na estrutura original.
Configure um ficheiro representativo #
Para JSON, o mesmo padrão identifica um ficheiro de origem e destinos separados:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Para um catálogo Xcode partilhado em conjunto com recursos Android específicos por idioma:
{
"buckets": {
"xcode-xcstrings": { "include": ["ios/Localizable.xcstrings"] },
"android": {
"include": ["android/app/src/main/res/values-[locale]/strings.xml"]
}
}
}Adapte a grafia dos identificadores de idioma do Android e os diretórios de recursos à aplicação. Após a primeira execução, valide ambos os formatos nativos com as respetivas ferramentas de compilação e confirme que a aplicação carrega o destino selecionado. O facto de a configuração ser aceite não garante, por si só, que o caminho funciona.
Encontre ficheiros sem selecionar a saída gerada #
Os caminhos são resolvidos relativamente a i18n.json; * encontra correspondências num único nível. O suporte para ** recursivo foi introduzido em 0.135.0. Por predefinição, 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 partilhada ou por pacote consoante os idiomas e quem é responsável pelo motor 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 controlos de chaves consoante quem é responsável por cada valor. Os comentários em JSONC e nos catálogos Xcode podem conter notas para tradutores. Os documentos de formato livre e as legendas não utilizam necessariamente estas funcionalidades da mesma forma.
Verifique o que o analisador reconstruiu: chaves e valores do catálogo, marcação e ligações do documento, marcações de tempo das legendas ou identificadores de recursos nativos. Aceite a saída apenas depois de confirmar que o analisador ou o processo de compilação que a utiliza consegue processá-la. Ao migrar, consulte o manual de formatos atual e a lista de formatos suportados pela ferramenta que faz a invocação, em vez de presumir que esta matriz legada continua a aplicar-se.