Traduzir

Encontrar e preencher traduções do vue-i18n que faltam

O vue-i18n avisa no console sobre uma chave que falta e mostra o idioma de reserva, então uma lacuna em de.json vai para produção em silêncio. Abaixo, um comando a encontra e outro a preenche.

KAERIS traduziu esta página e verificou cada linha traduzindo-a de volta. Um falante nativo ainda não revisou. Original em inglês

O projeto de exemplo

Um pequeno projeto vue-i18n: a origem em inglês e um arquivo alemão que ficou para trás. Os comandos abaixo rodaram exatamente nestes arquivos.

Origemsrc/locales/en.json
{
  "nav": {
    "greeting": "Hi, {name}!",
    "signOut": "Sign out"
  },
  "cart": {
    "items": "no items | {count} item | {count} items",
    "checkout": "Go to checkout",
    "help": "Questions? Write to {'@'}support"
  }
}
Alemão, antessrc/locales/de.json
{
  "nav": {
    "greeting": "Hallo, {Name}!",
    "signOut": "Abmelden"
  },
  "cart": {
    "items": "keine Artikel | {count} Artikel",
    "checkout": "Zur Kasse"
  }
}

1. Encontrar o que falta

kaeris check compara cada tradução com o arquivo de origem. Ele roda offline, sem chave nem conta, e termina com código 1 quando encontra um problema, então um job de CI pode parar nele.

Terminalexit code 1
$ npx kaeris check --source src/locales/en.json --langs de
✗ de: 1 missing key(s): cart.help
✗ de: 1 placeholder mismatch(es):
    nav.greeting: missing ['{name}'], added ['{Name}']
✗ de: 3 translation fault(s):
    nav.greeting: lost placeholder {name}
    nav.greeting: invented placeholder {Name} (not in source)
    cart.items: placeholder {count} appears 2× in source but 1× in translation
✗ 1 missing key, 1 placeholder mismatch, 3 translation faults

2. Traduzir só as chaves que faltam

--only-new envia só as chaves que faltam no arquivo alemão e as insere nele. As linhas que já estão no arquivo ficam como estão, inclusive as quebradas. O comando faz parte do pacote Python: pip install kaeris.

Terminalexit code 0
$ kaeris translate src/locales/en.json --langs de --only-new
→ no key: free demo limits 10,000 chars per file, 8 languages per run, get a key: kaeris.dev/developer
→ de: 1 new key(s) to translate
→ Run: openai/gpt-6-luna · Free · 1/1 languages · 1 strings · 2.3s
     32 charged
✓ Translation QA: no placeholder loss, no overflow risks
✓ de: merged 1 key(s) → src/locales/de.json
→ 4 key(s) already exist in de but nothing in kaeris.lock vouches for them, so they were left alone AND left unlocked. If the source changed after those files were made, those edits are NOT translated. Re-run once with --no-only-new to rebuild them, or with --assume-current if the files are known to match.
Alemão, depoissrc/locales/de.json
{
  "nav": {
    "greeting": "Hallo, {Name}!",
    "signOut": "Abmelden"
  },
  "cart": {
    "items": "keine Artikel | {count} Artikel",
    "checkout": "Zur Kasse",
    "help": "Fragen? Schreiben Sie an {'@'}support"
  }
}

3. Verificar de novo

As chaves que faltavam foram preenchidas. O que sobrou já estava quebrado antes desta execução: corrija essas linhas à mão ou traduza o arquivo inteiro de novo com --no-only-new.

Terminalexit code 1
$ npx kaeris check --source src/locales/en.json --langs de
✗ de: 1 placeholder mismatch(es):
    nav.greeting: missing ['{name}'], added ['{Name}']
✗ de: 3 translation fault(s):
    nav.greeting: lost placeholder {name}
    nav.greeting: invented placeholder {Name} (not in source)
    cart.items: placeholder {count} appears 2× in source but 1× in translation
✗ 1 placeholder mismatch, 3 translation faults

Executado em 2 de novembro de 2026 no plano gratuito, sem chave: npx kaeris 0.2.42 para a verificação, kaeris 0.2.42 do PyPI para a tradução. Saída como foi impressa, exceto as linhas de progresso e o caminho da pasta local.

O que o kaeris check detecta em vue-i18n

Quanto custa

Perguntas

Plurais com barra vertical são verificados?

Não na 0.2.42: as formas entre as barras não são contadas. Até uma versão fazer isso, conte-as à mão nos idiomas que você publica.

Literais como {'@'} são mantidos?

Sim. A tradução acima manteve {'@'}, e uma tradução que o perde falha na verificação.

Ele pode rodar em CI?

Sim. npx kaeris check termina com código 1 quando encontra um problema. Receitas: GitHub Actions, GitLab CI, pre-commit.

Continue

Referência do check · Referência da CLI · Verificação grátis no navegador · Traduzir no navegador

Outros stacks: react-i18next · next-intl · Flutter · iOS · Android