Перевести файлы локализации CSV

CSV-файл для локализации игр имеет столбец с ключами и по одному столбцу на язык. KAERIS считывает ключ и исходный столбец и добавляет столбец для каждого целевого языка.

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

Перевести ваш файл Проверить ваши файлы бесплатно

Как устроен CSV-файл для локализации

Первый столбец — это ключ, второй — исходный текст; заголовки называют столбцы (keys,en). Ячейки с запятыми или переносами строк заключаются в кавычки. Полностью пустые строки игнорируются.

Исходный файлtranslations.csv

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 о нем.

Результат на немецкомtranslations/translations.csv

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 checkexit code 0

$ 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