Traducir

Encontrar y rellenar claves de react-i18next que faltan

Un common.json alemán que se quedó atrás respecto al inglés no rompe el build. i18next recurre al inglés o muestra la clave, y nadie lo nota hasta que lo nota un usuario. Abajo, un comando encuentra los huecos y otro los rellena.

KAERIS ha traducido esta página y revisado cada línea traduciéndola de vuelta. Un hablante nativo aún no la ha revisado. Original en inglés

El proyecto de ejemplo

Un pequeño proyecto react-i18next: la fuente en inglés y un archivo alemán que se quedó atrás. Los comandos de abajo se ejecutaron exactamente sobre estos archivos.

Fuentepublic/locales/en/common.json
{
  "header": {
    "greeting": "Hi, {{name}}!",
    "signOut": "Sign out"
  },
  "cart": {
    "items_one": "{{count}} item in your cart",
    "items_other": "{{count}} items in your cart",
    "checkout": "Go to checkout",
    "terms": "By paying you accept the <1>terms</1>."
  }
}
Alemán, antespublic/locales/de/common.json
{
  "header": {
    "greeting": "Hallo, {{name}}!",
    "signOut": "Abmelden"
  },
  "cart": {
    "items_one": "{{count}} Artikel im Warenkorb",
    "checkout": "Zur Kasse",
    "terms": "Mit der Zahlung akzeptieren Sie die AGB."
  }
}

1. Encontrar lo que falta

kaeris check compara cada traducción con el archivo fuente. Funciona sin conexión, sin clave ni cuenta, y termina con código 1 si encuentra un problema, así que un job de CI puede detenerse en él.

Terminalexit code 1
$ npx kaeris check --source public/locales/en/common.json --langs de
✗ de: 1 missing key(s): cart.items_other
✗ de: 2 translation fault(s):
    cart.terms: lost inline tag </1>
    cart.terms: lost inline tag <1>
✗ 1 missing key, 2 translation faults

2. Traducir solo las claves que faltan

--only-new envía solo las claves que le faltan al archivo alemán y las añade. Las líneas que ya están en el archivo se quedan como están, incluidas las rotas. El comando está en el paquete de Python: pip install kaeris.

Terminalexit code 0
$ kaeris translate public/locales/en/common.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 · 4.4s
     28 charged
✓ Translation QA: no placeholder loss, no overflow risks
✓ de: merged 1 key(s) → public/locales/de/common.json
→ 5 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án, despuéspublic/locales/de/common.json
{
  "header": {
    "greeting": "Hallo, {{name}}!",
    "signOut": "Abmelden"
  },
  "cart": {
    "items_one": "{{count}} Artikel im Warenkorb",
    "checkout": "Zur Kasse",
    "terms": "Mit der Zahlung akzeptieren Sie die AGB.",
    "items_other": "{{count}} Artikel in Ihrem Warenkorb"
  }
}

3. Comprobar de nuevo

Las claves que faltaban están rellenas. Lo que queda ya estaba roto antes de esta ejecución: corrija esas líneas a mano o vuelva a traducir todo el archivo con --no-only-new.

Terminalexit code 1
$ npx kaeris check --source public/locales/en/common.json --langs de
✗ de: 2 translation fault(s):
    cart.terms: lost inline tag </1>
    cart.terms: lost inline tag <1>
✗ 2 translation faults

Ejecutado el 2 de noviembre de 2026 en el plan gratuito, sin clave: npx kaeris 0.2.42 para la comprobación, kaeris 0.2.42 de PyPI para la traducción. Salida tal como se imprimió, salvo las líneas de progreso y la ruta de la carpeta local.

Qué detecta kaeris check en react-i18next

Cuánto cuesta

Preguntas

¿Encuentra claves usadas en el código pero ausentes de los archivos?

No. kaeris check compara los archivos de idioma entre sí. Ejecute antes un extractor como i18next-cli para que el archivo inglés tenga todas las claves; a partir de ahí sigue la comprobación.

¿Qué estructuras de carpetas funcionan?

locales/en/common.json junto a locales/de/common.json, o en.json junto a de.json. La comprobación busca donde escribe translate.

¿Puede ejecutarse en CI?

Sí. npx kaeris check termina con código 1 si encuentra un problema. Recetas: GitHub Actions, GitLab CI, pre-commit.

Seguir adelante

Referencia de check · Referencia de la CLI · Comprobación gratuita en el navegador · Traducir en el navegador

Otros stacks: next-intl · vue-i18n · Flutter · iOS · Android