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.

GrupoConteúdoModelo de saída documentado
json, json5, jsoncVariantes de JSON estruturadoFicheiros separados por idioma
json-dictionaryValores JSON que contêm objetos com chaves por idiomaFicheiro partilhado
yamlCatálogo YAMLFicheiros separados por idioma
yaml-root-keyYAML contido na chave de raiz do idioma de saídaFicheiros separados por idioma
markdown, mdx, markdocDocumentos da família MarkdownFicheiros separados por idioma
html, mjmlMarcação HTML e de e-mailFicheiros separados por idioma
androidRecursos XML do AndroidFicheiros separados por idioma
xcode-strings, xcode-stringsdictCadeias de caracteres e recursos de plural da AppleFicheiros separados por idioma
xcode-xcstringsCatálogo de cadeias de caracteres do XcodeFicheiro partilhado
flutterCatálogo ARBFicheiros separados por idioma
poPO do GettextFicheiros separados por idioma
propertiesPropriedades JavaFicheiros separados por idioma
csvCSV com vários idiomasFicheiro partilhado
csv-per-localeUm CSV por idiomaFicheiros separados por idioma
xml, xliffXML e XLIFFFicheiros separados por idioma
srt, vttLegendasFicheiros separados por idioma
phpMatrizes de localização em PHPFicheiros separados por idioma
typescriptConteúdo de localização em TypeScriptFicheiros separados por idioma
vue-jsonBlocos JSON do Vue i18n com chaves por idiomaFicheiro partilhado
txtTexto simplesFicheiros 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:

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

Para um catálogo Xcode partilhado em conjunto com recursos Android específicos por idioma:

json
{
  "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:

json
{
  "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.