Localization using spreadsheets

Spreadsheets are one of the most common formats for localizing games. In Godot, spreadsheets are supported through the CSV format. This guide explains how to work with CSVs.

The CSV files must be saved with UTF-8 encoding without a byte order mark.

Avertissement

By default, Microsoft Excel will always save CSV files with ANSI encoding rather than UTF-8. There is no built-in way to do this, but there are workarounds as described here.

We recommend using LibreOffice or Google Sheets instead.

Formatage

Les fichiers CSV doivent être formatés comme suit :

clés	<lang1>	<lang2>	<langN>
KEY1	chaîne	chaîne	chaîne
KEY2	chaîne	chaîne	chaîne
KEYN	chaîne	chaîne	chaîne

Les balises "lang" doivent représenter une langue, qui doit être une des locales valides supportée par le moteur, ou doivent commencer avec un tiret du bas (_), qui signifie que la colonne liée sert de commentaire et ne va pas être importée. Les balises "KEY" doivent être uniques et représenter une chaîne universellement (elles sont généralement en majuscules, pour se différencier des autres chaînes). Ces clés seront remplacées à l'exécution par la chaîne traduite correspondante. Notez que la casse est importante, "KEY1" et "Key1" seront des clés différentes. La cellule en haut à gauche est ignorée et peut être laissée vide ou avoir un contenu quelconque. En voici un exemple :

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

Le même exemple est présenté plus bas comme un fichier texte dont les données sons séparées par des virgules, qui devrait être le résultat obtenu lorsqu'on édite les données précédentes dans un tableur. Lorsque vous éditez la version texte, assurez-vous d'ajouter des guillemets autour des messages qui contiennent des virgules, des sauts de lignes ou des guillemets, pour que les virgules ne soient pas considérées comme des délimiteurs, que les sauts de lignes ne créent pas de nouvelles entrées et que les guillemets ne soient pas considérés comme des caractères de fin. Sinon, vous pouvez désigner un autre délimiteur que la virgule dans les options d'import.

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

Import CSV

Par défaut, Godot traitera les fichiers CSV comme des traductions. Il les importera et générera un fichier ressource ou plus de traduction.

L’importation ajoutera aussi la traduction à la liste des traduction à charger lorsque le jeu s’éxécute, spécifiée dans project.godot (ou dans les configurations du projet). Godot permet le chargement et la suppression de traduction pendant l’éxécution également.

Sélectionnez le fichier .csv puis allez dans le dock Import pour choisir les options d'import. Vous pouvez activer la compression des traductions importées et choisir le délimiteur que le logiciel utilisera en analysant le fichier CSV.

N'oubliez pas de cliquer sur Réimporter pour appliquer les changements.