Solarus quests 1.5
Quest maker's reference
We describe here how to translate a Solarus quest. If you wish to contribute translate one of our games, feel free to contact us.
Several files have to be translated so that a quest works in a new language:
All these language-specific data files are in the directory
languages/xx of the quest data (where
xx is the code of the language, for instance
Some images used by the game engine contain text. They all are in the directory
languages/xx/images If you are making a translation of one of our games, we can do the pixel work for you, just give us the textual translations. We can give you explanations about all these images so that you can know when they are used.
The engine displays some text in the menus, before and during the game. All these strings are loaded from the file
languages/xx/text/strings.dat. The file must be encoded in UTF-8 and respect the syntax specified in the Translated strings page.
Dialogs are all messages displayed to the player in the dialog box during the game. They represent the biggest part of the translation work. All dialogs are defined in the file
languages/xx/text/dialogs.dat. The syntax of this file is specified in the Translated dialogs page. However, this is a very extensible syntax because the dialog box system is entirely customizable. Each game extends the syntax of
dialogs.dat in its own way by adding custom properties.
If you want to translate one of our games, we give translation instructions and describe precisely these custom properties in the comments of the
dialogs.dat file itself.