Pular para o conteúdo
Pular para o conteúdo

Docs / Conceitos

Página traduzida automaticamente

Esta página foi traduzida automaticamente, então pode ter erros ou soar um pouco estranha. A versão em inglês é a fonte da verdade. Ler o original em inglês.

Idiomas e locales

Quais idiomas o verbatra traduz, como o código de locale chega a cada provedor e como ele trata plurais, sistemas de escrita, variantes e texto RTL.

O verbatra não tem uma lista própria de idiomas: ele aceita qualquer código de locale BCP 47 válido, então você pode usar os idiomas que o seu provedor aceita e, em um projeto somente humano, todos eles. O verbatra escreve cada código do jeito que o provedor espera, submete cada tradução às regras de plural do idioma e avisa antes de uma execução quando um provedor não consegue atender um locale.

Códigos de locale

Todo locale da sua configuração precisa ser uma tag BCP 47 válida, como fr, pt-BR, sr-Latn ou es-419; para arquivos chamados pt_BR.json, escreva pt-BR e defina files.localeStyle como posix. As regras completas estão em Códigos de locale.

O código da sua configuração é o que o verbatra guarda em todo lugar: caminhos de arquivo, arquivo de lock e cache (veja O arquivo de lock e a procedência e O cache de tradução). Uma grafia específica do provedor existe só dentro de uma requisição. Mudar a grafia de um código que você já traduz, como pt_BR para pt-BR, mantém o histórico dele; veja Um código de locale com grafia diferente.

Cobertura por provedor

A qualidade da tradução de um idioma é assunto do provedor; cada linha leva à lista do próprio fornecedor.

ProvedorIdiomasCódigo enviadoGlossárioTom
anthropicSem lista fixa. Claude multilingual supportComo escrito, mais os nomes em inglês do idioma, do sistema de escrita e da regiãoTermos do locale no promptNo prompt
openaiSem lista fixa. Using the OpenAI API in different languagesComo escrito, mais os nomesTermos do locale no promptNo prompt
geminiGemini language supportComo escrito, mais os nomesTermos do locale no promptNo prompt
opencodeO que o modelo Zen escolhido cobrirComo escrito, mais os nomesTermos do locale no promptNo prompt
openai-compatibleO que o modelo em execução cobrirComo escrito, mais os nomesTermos do locale no promptNo prompt
deeplDeepL supported languagesNormalizado para os códigos do DeepLSó um glossário do DeepL criado previamente e indicado por glossaryId, para 32 idiomasFormalidade do DeepL para alguns idiomas, não com uma chave de API do nível gratuito
google-translateCloud Translation language support (a lista NMT vale para o nível Basic, v2, que o verbatra usa)Normalizado para chinês e norueguês, nos demais casos como escritoNenhumNenhum
libretranslateOs modelos instalados no seu servidor; a lista do projeto original mostra o que há para instalarSó o idioma, exceto pt-BR, zh-Hans e zh-HantNenhumNenhum
noneNão se aplica: nenhum provedor é chamadoNada é enviadoNão se aplicaNão se aplica

Na prática:

  • Os provedores de LLM não têm lista fechada. Eles tentam qualquer idioma que você nomear, e a qualidade cai onde há poucos dados de treinamento, então um idioma de destino com poucos recursos merece revisão humana. As Sinalizações de revisão apontam os resultados mais suspeitos.
  • O DeepL e o Google Cloud Translation têm lista fechada, verificada antes de uma execução.
  • O LibreTranslate oferece os modelos que estiverem instalados no seu servidor.
  • Um tone ou glossário que um provedor não consegue respeitar é relatado como aviso; veja Tom e glossário entre provedores.

Como cada provedor recebe o código

O DeepL e o Google Cloud Translation recebem a própria grafia de alguns códigos, e o DeepL recusa um destino en ou pt sem região antes de qualquer requisição. Os provedores de LLM recebem o código mais os nomes em inglês do idioma, do sistema de escrita e da região. O localeMap nas options do provedor substitui o código por locale; o mapeamento completo está em Códigos de locale enviados ao provedor.

Verificar o suporte antes de uma execução

Antes de gastar qualquer coisa, o verbatra avalia cada locale configurado contra o provedor, e o verbatra doctor --locales imprime os veredictos:

  • supported (aceito): o código que o verbatra envia está na tabela do provedor, ou o provedor é um LLM.
  • unverified (não verificado): só o idioma base consta na lista, o código vem de uma entrada explícita do localeMap, ou o provedor é um servidor LibreTranslate cujos modelos só são conhecidos pela lista ao vivo. O locale é traduzido, com o alerta LOCALE_UNVERIFIED_BY_PROVIDER.
  • unsupported (não aceito): nem o código nem o idioma base constam na lista. O translate, o watch e uma retradução de uma única chave recusam a execução inteira com LOCALE_UNSUPPORTED_BY_PROVIDER.

Deixe o locale de fora com --locales ou, se o provedor adicionou o idioma depois, mapeie-o em localeMap: o verbatra confia em uma entrada explícita. As tabelas incluídas no pacote são cópias das listas dos fornecedores (DeepL com 125 códigos e Google com 198, ambas de 28 de setembro de 2026); o verbatra doctor --live confere a lista atual.

Nada é recusado para um provedor de LLM. Um destino fora dos idiomas que os LLMs reconhecidamente traduzem bem recebe o alerta LOCALE_NOT_WELL_TESTED, um lembrete para revisar a saída. A lista confere o idioma base, então pt-BR conta como português: árabe (ar), chinês (zh), holandês (nl), inglês (en), francês (fr), alemão (de), hindi (hi), indonésio (id), italiano (it), japonês (ja), coreano (ko), polonês (pl), português (pt), russo (ru), espanhol (es), sueco (sv), turco (tr), ucraniano (uk) e vietnamita (vi).

Sistemas de escrita e variantes regionais

Uma subtag de sistema de escrita ou de região muda o que se pede ao provedor, não o modo como o verbatra guarda qualquer coisa:

Seu localeDeepLGoogle Cloud TranslationLibreTranslateProvedores de LLM
pt-BR / pt-PTPT-BR / PT-PTpt-BR / pt-PTpt-BR / ptPortuguese (Brazil) / Portuguese (Portugal)
es-419, es-MXES-419es-419, es-MXesSpanish (Latin America), Spanish (Mexico)
zh-Hans / zh-HantZH-HANS / ZH-HANTzh-CN / zh-TWzh-Hans / zh-HantChinese (Simplified) / Chinese (Traditional)
sr-Latn / sr-CyrlSR para ambossr-Latn / sr-Cyrlsr para ambosSerbian (Latin) / Serbian (Cyrillic)

O DeepL e o LibreTranslate mantêm o sistema de escrita só para o chinês, então sr-Latn e sr-Cyrl recebem o sistema de escrita que o motor usa para o sérvio; um provedor de LLM, que recebe o sistema de escrita pelo nome, é a escolha confiável. A sinalização de revisão LENGTH_RATIO_OUTLIER pondera os caracteres pelo sistema de escrita, então um texto compacto em chinês, japonês ou coreano não é sinalizado como curto, e um termo de glossário em um sistema de escrita sem espaços entre as palavras é encontrado por inclusão.

Plurais

O verbatra lê as categorias de plural de que um idioma precisa, ordinais incluídos, das regras do CLDR nos dados de ICU do Node.js: o inglês tem duas categorias cardinais, o russo e o polonês quatro, o árabe e o galês seis, o japonês só other. Para um locale sem regras no Node.js, o aviso da execução parte de one e other, enquanto a barreira de integridade, o check e o doctor exigem só other; a verificação plural-rules do verbatra doctor nomeia esse locale.

A forma de manter um plural correto depende do formato:

  • i18next identifica cada forma com um sufixo do CLDR (items_one, items_few). Quando a origem não tem uma categoria de que o destino precisa, a execução relata PLURAL_CATEGORIES_INCOMPLETE; com generatePlurals: true e um provedor de LLM, o verbatra grava as formas ausentes. Veja Idiomas com mais categorias de plural.
  • next-intl e ARB mantêm um plural ICU inteiro em um único valor, e um valor cujos ramos não servem ao idioma de destino é recusado; veja Ramos de plural por idioma de destino.
  • Apple, Android e gettext preservam no ciclo de ida e volta exatamente as formas que cada locale tem, e uma forma ausente precisa ser adicionada manualmente. O gettext mantém o cabeçalho Plural-Forms como está escrito.

Alertas de plural

O verbatra check e o verbatra doctor alertam sobre todo plural que não tem uma categoria usada pelo idioma, em cada formato listado acima, exceto o gettext, cujas formas seguem o próprio cabeçalho; plurais em outros formatos não são verificados. O DeepL, o Google Cloud Translation e o LibreTranslate traduzem as formas existentes, mas nunca geram formas novas.

Idiomas da direita para a esquerda

Árabe, hebraico, persa, urdu e outros idiomas da direita para a esquerda não pedem tratamento especial: um valor é lido, enviado, verificado e gravado de volta como está, sem caracteres de controle de direção adicionados, removidos ou reordenados. O que isso significa para você:

  • Defina a direção no seu app, não nas strings, com o atributo dir, o CSS ou a direção de layout da sua plataforma. A verificação de marcação inline recusa uma tradução que adiciona um atributo dir que a origem não tem.
  • Caracteres de controle de direção são texto comum e podem ser descartados; confira as traduções que dependem de um deles. Incorporações, substituições de direção ou isolamentos sem fechamento (quando a origem fecha os seus) ou substituições de direção adicionadas geram BIDI_CONTROLS_CHANGED.
  • Uma ordem alterada de placeholders só gera INTEGRITY_REORDERED, porque outra ordem costuma ser a correta em outro idioma.
  • O Studio mostra os valores da direita para a esquerda em todo locale cujo sistema de escrita corre nesse sentido, pela direção do navegador ou pelo sistema de escrita provável do locale (ku-Arab da direita para a esquerda, ku da esquerda para a direita). Só a exibição muda.
  • O verbatra pseudo --mode bidi renderiza a sua origem da direita para a esquerda em um pseudolocale ar-XB, expondo suposições de layout da esquerda para a direita antes de existir qualquer tradução. Conferir imagens e ícones espelhados fica por sua conta.

Idiomas com poucos recursos e modelos locais

Para um idioma que o seu provedor hospedado cobre mal:

  • Execute um modelo local pelo openai-compatible. Ele precisa ser um modelo de chat ajustado para instruções que retorne um único objeto JSON; veja Escolher um modelo local.
  • Use um modelo de tradução dedicado fora do verbatra e traga o resultado de volta pelo ciclo de ida e volta da pasta de trabalho (veja Entregar com Excel ou CSV), que executa as mesmas verificações de integridade. Nenhum destes se conecta ao openai-compatible, porque não são modelos de chat: MADLAD-400 (Apache-2.0, mais de 400 idiomas), TranslateGemma (55 idiomas, termos de uso do Gemma) e NLLB-200 (cerca de 200 idiomas, mas CC-BY-NC-4.0, portanto não serve para um produto comercial). Confira você mesmo a licença de cada modelo.
  • Peça a uma pessoa que traduza. O fluxo somente humano funciona para qualquer idioma (veja Trabalhar sem tradução automática).
Editar no GitHub

Nesta página