Локалізація за допомогою електронних таблиць

Електронні таблиці є одним із найпоширеніших форматів для локалізації ігор. У Godot електронні таблиці підтримуються у форматі CSV. У цьому посібнику пояснюється, як працювати з CSV-файлами.

CSV-файли повинні бути збережені в кодуванні UTF-8 без позначки порядку байтів.

Попередження

За замовчуванням Microsoft Excel завжди зберігатиме файли CSV із кодуванням ANSI, а не UTF-8. Вбудованого способу зробити це немає, але є способи вирішення проблеми, описані тут. <https://stackoverflow.com/questions/4221176/excel-to-csv-with-utf8-encoding>`__.

Ми рекомендуємо використовувати LibreOffice або Google Таблиці.

Форматування

Файли CSV повинні бути відформатовані таким чином:

Ключі	<мова1>	<мова2>	<моваN>
КЛЮЧ1	текст	текст	текст
КЛЮЧ2	текст	текст	текст
КЛЮЧN	текст	текст	текст

Теги «lang» мають представляти мову, яка має бути однією з дійсних локалей, підтримуваних механізмом, або вони мають починатися з підкреслення (_), що означає, що відповідний стовпець є служить як коментар і не буде імпортовано. Теги "KEY" мають бути унікальними та універсально представляти рядок (зазвичай вони написані у верхньому регістрі, щоб відрізнити їх від інших рядків). Ці ключі буде замінено під час виконання на відповідний перекладений рядок. Зауважте, що регістр важливий, «KEY1» і «Key1» будуть різними ключами. Верхня ліва комірка ігнорується, її можна залишити порожньою або мати будь-який вміст. Ось приклад:

Ключі	en	es	ja
ПРИВІТАТИ	Привіт, друже!	Привіт, аміго!	Добрий день
ЗАПИТАТИ	Як ти?	Як справи?	Як справи
ПРОЩАННЯ	Прощавай	Адіос	до побачення
ЦИТАТА	"Привіт", - сказав чоловік.	«Привіт», — сказав чоловік.	«Привіт», — сказав чоловік

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

keys,en,es,ja
GREET,"Hello, friend!","Hola, amigo!",こんにちは
ASK,How are you?,Cómo está?,元気ですか
BYE,Goodbye,Adiós,さようなら
QUOTE,"""Hello"" said the man.","""Hola"" dijo el hombre.",「こんにちは」男は言いました

Імпортування CSV

Godot, за замовчуванням, розглядає файли CSV, як переклади. Він імпортує їх і генерує один, або кілька, стислих файлів ресурсів перекладу поруч.

Імпорт також додасть переклад до списку перекладів, який завантажуватиметься під час запуску гри, як зазначено у project.godot (або в налаштуваннях проєкту). Godot дозволяє також завантажувати та видаляти переклади під час виконання.

Виберіть .csv файл та перейдіть до панелі Імпорт, щоб визначити параметри імпорту. Ви можете переключити стиснення імпортованих перекладів та вибрати роздільник, який використовуватиметься при розборі файлу CSV.

Не забудьте натиснути Reimport (Переімпортувати) після будь-яких змін цих параметрів.