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

Documentação

Configure o verbatra e mantenha cada locale em sincronia.

Guias e referência da CLI, do SDK, do Studio e do servidor MCP: comece pelo início rápido ou peça ao seu agente de programação que configure o verbatra.

Comece pelo seu objetivo

Escolha o que você quer fazer; cada card abre a página que explica como.

Escolha sua stack

Um card marcado com Início rápido abre um guia passo a passo para essa stack; os demais cards abrem o comando init e a estrutura de arquivos.

Cada execução é um diff, não uma reescrita.

O que acontece quando você executa verbatra translate.

Manter manualmente um único locale de origem faz todos os outros arquivos de locale divergirem: chaves novas faltam nos destinos, strings editadas deixam traduções obsoletas para trás e chaves excluídas ficam como órfãs. O verbatra fecha essa lacuna comparando cada destino com um arquivo de lock versionado, verbatra.lock.json, e enviando só o que mudou ao provedor que você configurou; uma segunda execução sem nada novo para traduzir não faz nenhuma chamada ao provedor. Cada resultado é verificado antes de ser gravado, então um placeholder quebrado fica retido e é tentado de novo, nunca publicado. Veja Como funciona uma execução para a sequência completa de etapas.

  1. 1. Verificar

    verbatra check compara a origem, os destinos e o arquivo de lock. Não chama nenhum provedor e dispensa chave de API.

  2. 2. Traduzir

    verbatra translate envia só as chaves ausentes e alteradas, e recusa qualquer resultado com placeholders incompatíveis, marcação inline quebrada ou sintaxe ICU inválida.

  3. 3. Barrar na CI

    A GitHub Action executa o check em cada pull request e o faz falhar enquanto um locale estiver fora de sincronia.

O verbatra lê e grava os formatos comuns de arquivo de locale, de JSON e YAML a XLIFF, gettext e catálogos do Android e da Apple, e traduz por qualquer provedor de LLM ou de tradução automática aceito, por trás de uma única interface (ou por nenhum, em um fluxo somente humano: veja Trabalhar sem tradução automática). Um formato que ele não traz pode ser adicionado como adaptador personalizado (veja Escrever um adaptador de formato personalizado). As listas completas estão em Formatos e Provedores.

Os pacotes

Um motor, quatro formas de operá-lo.