Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

ResourceImporterCSVTranslation

Успадковує: ResourceImporter < RefCounted < Object

Імпортує значення, розділені комами, як Translations.

Опис

Значення, розділені комами, – це формат зберігання таблиць у звичайному тексті. Простота формату дозволяє легко редагувати його в будь-якому текстовому редакторі або програмному забезпеченні для роботи з електронними таблицями. Це робить його поширеним вибором для локалізації ігор.

У файлі CSV, який використовується для перекладу, перший стовпець містить ідентифікатори рядків, а перший рядок служить заголовком. Заголовок першого стовпця може бути будь-яким значенням. Решта заголовків вказують на локалізацію для цього стовпця. Стовпці, заголовки яких починаються з символу підкреслення (_), будуть ігноруватися.

Приклад файлу CSV:

ключі,en,es,ja

GREET,"Привіт, друже!","Hola, amigo!",こんにちは

ЗАПИТАЙТЕ,Як справи?,Cómo está?,元気ですか

BYE, Goodbye, Adiós,さようなら

ЦИТАТА,"""Привіт"" сказав чоловік.","""Hola"" dijo el hombre.",「こんにちは」男は言いました



Хоча для ключів у першому стовпці зазвичай використовуються ідентифікатори рядків у верхньому регістрі, нерідко безпосередньо використовувати рядки, які з’являються в грі як ключі. Щоб уникнути неоднозначності рядків, ви можете використовувати спеціальний стовпець ``?context``, щоб вказати контекст для використання з :ref:`Object.tr()<class_Object_method_tr>`.

en,?context,fr,ja,zh
Letter,Alphabet,Lettre,字母,字母
Letter,Message,Courrier,手紙,信件

Щоб встановити форму множини рядка для використання з Object.tr_n(), додайте спеціальний стовпець ?plural. Після встановлення форми множини вихідного рядка в цьому стовпці ви можете додати додаткові рядки, щоб надати переклади для більшої кількості форм множини. Перший стовпець та всі спеціальні стовпці в цих рядках форми множини мають бути порожніми.

Godot містить вбудовані правила множини для деяких мов. Ви також можете налаштувати їх за допомогою спеціального рядка ?pluralrule. Перегляньте GNU gettext для прикладів та додаткової інформації.

en,?plural,fr,ru,zh,_Коментар

?pluralrule,,nplurals=2; plural=(n >= 2);,,,Налаштуйте правило множини для французької мови

Є %d яблуко,Є %d яблуко,Il y a %d pomme,Есть %d яблоко,那里有%d个苹果,

,,Il y a %d pommes,Есть %d яблока,,

,,,Єсть %d яблок,,

Посібники

Властивості

int

compress

1

int

delimiter

0

bool

unescape_keys

false

bool

unescape_translations

true

Описи властивостей

int compress = 1 🔗

  • Вимкнено: Створює Translation.

  • Автоматично: Створює OptimizedTranslation, коли це можливо. Це зменшує розмір результуючого файлу ціною невеликого навантаження на процесор. Повертається до Translation для перекладів з контекстом або формами множини.

int delimiter = 0 🔗

Для використання в файлі CSV. Значення за замовчуванням відповідає поширеному конвенції CSV. Вкладка-розділені значення іноді називають TSV файлами.

bool unescape_keys = false 🔗

Якщо значення true, ключі повідомлень у CSV-файлі не екрануються за допомогою методу String.c_unescape під час процесу імпорту.

bool unescape_translations = true 🔗

Якщо значення true, переклади повідомлень у CSV-файлі не екрануються за допомогою методу String.c_unescape під час процесу імпорту.