Перекласти

Знайти й заповнити відсутні ключі react-i18next

Німецький common.json, що відстав від англійського, не ламає збірку. i18next підставляє англійський текст або виводить ключ, і ніхто цього не помічає, доки не помітить користувач. Нижче одна команда знаходить пропуски, інша їх заповнює.

KAERIS переклав цю сторінку та перевірив кожен рядок зворотним перекладом. Носій мови ще не переглядав її. Оригінал англійською

Приклад проєкту

Невеликий проєкт на react-i18next: англійський вихідний файл і німецький, що відстав. Команди нижче запускалися саме на цих файлах.

Вихідний файлpublic/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>."
  }
}
Німецька, доpublic/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. Знайти, чого бракує

kaeris check порівнює кожен переклад із вихідним файлом. Він працює офлайн, без ключа й акаунта, і завершується з кодом 1, якщо знаходить проблему, тож завдання CI може на ньому зупинитися.

Терміналexit 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. Перекласти лише відсутні ключі

--only-new надсилає лише ключі, яких немає в німецькому файлі, і вписує їх туди. Рядки, що вже є у файлі, лишаються як були, зламані теж. Команда входить до пакета Python: pip install kaeris.

Терміналexit 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.
Німецька, післяpublic/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. Перевірити ще раз

Відсутні ключі заповнено. Лишилося те, що було зламано до цього запуску: виправте ці рядки вручну або перекладіть увесь файл заново з --no-only-new.

Терміналexit 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

Запуск 2 листопада 2026 року на безкоштовному тарифі, без ключа: npx kaeris 0.2.42 для перевірки, kaeris 0.2.42 з PyPI для перекладу. Вивід як надруковано, крім рядків прогресу й локального шляху до теки.

Що kaeris check ловить у react-i18next

Скільки це коштує

Запитання

Чи знаходить він ключі, які є в коді, але відсутні у файлах?

Ні. kaeris check порівнює файли локалей між собою. Спершу запустіть екстрактор, наприклад i18next-cli, щоб в англійському файлі були всі ключі; далі працює перевірка.

Які структури тек підходять?

locales/en/common.json поряд із locales/de/common.json або en.json поряд із de.json. Перевірка шукає там, куди пише translate.

Чи може він працювати в CI?

Так. npx kaeris check завершується з кодом 1, якщо знаходить проблему. Рецепти: GitHub Actions, GitLab CI, pre-commit.

Продовжуйте

Довідка з check · Довідка з CLI · Безкоштовна перевірка в браузері · Переклад у браузері

Інші стеки: next-intl · vue-i18n · Flutter · iOS · Android