# Почему файлы локализации вызывают ошибки при импорте в движок
Таблицы переводов легко редактировать, но в них легко допустить ошибку. Запятая внутри текста или пропущенная кавычка могут сместить столбцы языков.Импортер CSV в Godot и пакет Unity Localization требуют строгой структуры. Этот инструмент проверяет файлы перед импортом.# Что проверяет инструмент
Обнаружение перед импортом
Ошибки, незаметные в больших файлах
- Пустые ячейки перевода
- Повторяющиеся ключи
- Строки с неверным числом столбцов
- Некорректный синтаксис кавычек
Нормализация при экспорте
Безопасные автоматические исправления
- Заполнение недостающих столбцов
- Объединение лишних полей в последний столбец
- Сохранение первого вхождения ключа
- Исходный файл не изменяется
# Как проверить очищенный файл
Структурная очистка не заменяет языковую вычитку. Используйте список замечаний для заполнения пропущенных переводов.| Замечание | Значение | Рекомендуемое действие |
|---|---|---|
| Пустая ячейка | Столбец языка не содержит текста | Перевести или подтвердить намеренность |
| Дубликат ключа | Несколько строк используют один ключ | Сравнить строки и оставить первую |
| Поврежденная строка | Число столбцов не совпадает с заголовком | Проверить объединенный столбец |
| Ошибка чтения | Некорректный JSON | Исправить синтаксис перед импортом |
# Правила CSV для видеоигр
Текст, содержащий запятые или переносы строк, должен заключаться в двойные кавычки.Сохраняйте оригинал
Всегда сохраняйте исходный файл от переводчика для сравнения.- Ключ перевода
- Уникальный идентификатор, используемый в коде игры.
- Поле CSV
- Отдельное значение между разделителями.
- Экранирование
- Использование кавычек для сохранения знаков препинания.
- Локаль
- Код языка и региона, например ru, en или ja.