Переклад локалізаційних CSV-файлів
CSV-файл локалізації гри має стовпець ключів і по одному стовпцю на кожну мову. KAERIS читає ключ і стовпець джерела та додає стовпець для кожної цільової мови.
KAERIS переклав цю сторінку та перевірив кожен рядок зворотним перекладом. Носій мови ще не переглядав її. Оригінал англійською
Як побудований CSV для локалізації
Перший стовпець — це ключ, другий — текст джерела; заголовок іменує стовпці (keys,en). Комірки з комами або розривами рядків беруться в лапки. Повністю порожні рядки ігноруються.
keys,en GREETING,"Welcome back, %s!" ITEMS,"You have {count} items, %d of them new" QUIT,Quit game
На що звертати увагу в перекладах CSV
Один стовпець на мову
Вивід має стовпець ключів, стовпець джерела, потім
de,jaтощо. Ваші імена стовпців ключів і джерела зберігаються.Формули
Комірка, що починається з
=,+,-або@, записується з провідним апострофом, щоб Excel показував текст замість виконання формули.Printf та змінні в дужках
%s,%dта{count}у комірці порівнюються з джерелом. У реальному запуску нижче всі три повернулися.Кавички
Коми та лапки всередині комірки беруться в лапки CSV-записувачем, тому одна перекладена комірка не може розлитися на наступний стовпець.
Реальний запуск: перекладено німецькою та перевірено
Реальний запуск, 27 жовтня 2026, нічого не редагувалося вручну: kaeris translate translations.csv --langs de з kaeris 0.2.35, 2,5 секунди, модель google/gemini-2.5-flash-lite, стандарт безкоштовного рівня. Нижче — німецький файл, який він записав, і що kaeris check про нього каже.
keys,en,de GREETING,"Welcome back, %s!","Willkommen zurück, %s!" ITEMS,"You have {count} items, %d of them new","Sie haben {count} Artikel, davon %d neu" QUIT,Quit game,Spiel beenden
$ kaeris check --source translations.csv --langs de ✓ de: complete & placeholder-safe ✓ all locales complete & placeholder-safe
Що KAERIS робить з цим
Ті ж стовпці, більше мов
Стовпці ключів і джерела зберігаються; кожна цільова мова — новий стовпець. У терміналі результат записується у
translations/localization.csvпоруч із джерелом, аkaeris checkчитає його звідти.Безпечні для електронних таблиць комірки
Комірки, що виглядають як формули, записуються як текст. Див. сторінку ігор для сторони ігрового рушія.
Безкоштовна перевірка для цього формату
Безкоштовна перевірка на /check читає цей формат і працює без ключа чи акаунта. Команда терміналу
kaeris checkтакож його читає: вона підтримує всі 13 форматів з kaeris 0.2.35, з тими ж правилами і нічого нікуди не відправляє.
Запустіть у три кроки
Встановіть CLI
Виконайте
pip install kaeris.Перекладіть таблицю
Запустіть
kaeris translate localization.csv --langs de,ja,fr.Перевірте результат
Запустіть
kaeris check --source localization.csv --langs de,ja,frабо завантажте файл на сторінці безкоштовної перевірки: обидві перевірки читають стовпець кожної мови.
pip install kaeris kaeris translate localization.csv --langs de,ja,fr --verify
Запитання
Чи працює це для Godot і Unity?
Формат — стовпець ключів, стовпець джерела, стовпці мов, як очікують ці рушії. Див. сторінку ігор.
Чи буде комірка, що починається з =, виконуватися як формула?
Ні. Такі комірки записуються так, щоб таблиця показувала їх як текст.
Це безкоштовно?
Так, без облікового запису: 10 000 символів на файл і до 8 мов за один запуск. Безкоштовний API-ключ збільшує ліміт файлу до 50 000 символів. Довічна ліцензія коштує $79 один раз, за вашим власним ключем OpenRouter; місячні плани починаються від $19. Ціни
Чи можу я запускати його з терміналу або в CI?
Так. pip install kaeris, потім kaeris translate localization.csv --langs de,ja. GitHub Action виконує той самий переклад у pull request. Документація CLI · GitHub Action
Продовжуйте
Довідник CLI · Довідник перевірки · Переклад у браузері · Безкоштовна перевірка · Конвертація форматів · Псевдолокалізація
Інші формати: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML