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

Eredita: ResourceImporter < RefCounted < Object

Importa valori separati da virgole sotto forma di Translation.

Descrizione

I valori separati da virgole sono un formato per memorizzare tabelle in testo semplice. La semplicità del formato lo rende facile da modificare in qualsiasi editor di testo o di fogli di calcolo. Ciò lo rende una scelta comune per la localizzazione dei videogiochi.

Nel file CSV utilizzato per la traduzione, la prima colonna contiene identificatori di stringa e la prima riga funge da intestazione. L'intestazione della prima colonna può contenere qualsiasi valore. Le intestazioni rimanenti indicano la lingua per quella colonna. Le colonne le cui intestazioni iniziano con un trattino basso (_) saranno ignorate.

File CSV di esempio:

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.",「こんにちは」男は言いました

Sebbene le chiavi nella prima colonna in genere utilizzino identificatori di stringhe in maiuscolo, non è raro utilizzare direttamente le stringhe che appaiono nel gioco come chiavi. Per evitare ambiguità tra le stringhe, è possibile usare una colonna speciale ?context per specificare il contesto da utilizzare con Object.tr().

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

Per impostare la forma plurale di una stringa da usare con Object.tr_n(), aggiungei una colonna speciale ?plural. Dopo aver impostato la forma plurale della stringa sorgente in questa colonna, è possibile aggiungere ulteriori righe per fornire traduzioni per altre forme plurali. La prima colonna e tutte le colonne speciali in queste righe contenenti le forme plurali devono essere vuote.

Godot include regole predefinite per il plurale per alcune lingue. È anche possibile personalizzarle tramite una riga speciale ?pluralrule. Consulta GNU gettext per esempi e ulteriori informazioni.

en,?plural,fr,ru,zh,_Comment
?pluralrule,,nplurals=2; plural=(n >= 2);,,,Customize the plural rule for French
There is %d apple,There are %d apples,Il y a %d pomme,Есть %d яблоко,那里有%d个苹果,
,,Il y a %d pommes,Есть %d яблока,,
,,,Есть %d яблок,,

Tutorial

Proprietà

int

compress

1

int

delimiter

0

bool

unescape_keys

false

bool

unescape_translations

true

Descrizioni delle proprietà

int compress = 1 🔗

  • Disabled: Crea un Translation.

  • Auto: Crea un OptimizedTranslation se possibile. Ciò rende il file risultante più piccolo a costo di un piccolo sovraccarico della CPU. Utilizza Translation per le traduzioni con contesto o forme plurali.

int delimiter = 0 🔗

Il delimitatore da usare nel file CSV. Il valore predefinito corrisponde alla comune convenzione di CSV. I valori separati da tabulazione sono talvolta chiamati file TSV.

bool unescape_keys = false 🔗

Se true, le chiavi dei messaggi nel file CSV vengono decodificate tramite String.c_unescape() durante il processo di importazione.

bool unescape_translations = true 🔗

Se true, le traduzioni dei messaggi nel file CSV vengono decodificate tramite String.c_unescape() durante il processo di importazione.