User Tools

Site Tools


localization

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
localization [2017/06/04 15:03]
justin
localization [2017/09/06 11:14] (current)
justin
Line 6: Line 6:
 =====Translation Format===== =====Translation Format=====
  
-In order to add support for multiple languages you will first need to create a spreadsheet containing any applicable text strings. As shown below, the header row (starting in the second column) should contain the locale code for each language that your game will support. Each row after that should contain a unique ID to identify the string (all uppercase) followed by each translation of the string.+In order to add support for multiple languages you will first need to create a spreadsheet containing any applicable text strings. [[https://​www.google.com/​sheets/​about/​|Google Sheets]] is a great (and free) tool you can use to accomplish this. As shown below, the header row (starting in the second column) should contain the locale code for each language that your game will support. Each row after that should contain a unique ID to identify the string (all uppercase) followed by each translation of the string.
  
 ^ ^language1^language2^language3^ ^ ^language1^language2^language3^
Line 17: Line 17:
 </​WRAP>​ </​WRAP>​
  
-A simple example shown below contains ​a translation ​for the game title and some greeting dialogue.+A simple example shown below contains ​English and French translations ​for the game title and some greeting dialogue.
  
-^ ^en^fr^ +{{:​wiki:​translations_spreadsheet.png?nolink|}}
-|GAME_TITLE|Example Game|Exemple de jeu| +
-|GREETING|Hello! My name is Justin.|Salut! Je m'​appelle Justin.|+
  
 =====Importing Translations===== =====Importing Translations=====
  
-Once you've populated your translations spreadsheet,​ save it as a .CSV (comma-separated values) file. You can then import it into your project using the "Import Resources" ​tool located on the main toolbar.+Once you've populated your translations spreadsheet,​ save it as a .CSV (comma-separated values) file. You can then import it into your project using the [[Import Resources]] tool located on the main toolbar.
  
 {{:​wiki:​import_translations.png?​nolink|}} {{:​wiki:​import_translations.png?​nolink|}}
Line 34: Line 32:
  
 =====Using Translations===== =====Using Translations=====
 +
 +Once you have imported the translations into our project, you can reference them within dialogue or message text by using the placeholder syntax shown below (specifically,​ the string'​s unique ID enclosed by percent symbols).
  
 {{:​wiki:​translation_placeholder.png?​nolink|}} {{:​wiki:​translation_placeholder.png?​nolink|}}
 +
 +At game runtime, any occurrences of these placeholders will be replaced with the translated text string corresponding to the active language.
  
 =====Built-In Strings===== =====Built-In Strings=====
Line 62: Line 64:
 |SAVE_GAME|Save Game|Sauvegarder| |SAVE_GAME|Save Game|Sauvegarder|
 |CREDITS|Credits|Crédits| |CREDITS|Credits|Crédits|
 +|INVENTORY|Inventory|Inventaire|
 +|REMAINING_USES|Remaining uses:| |
 +|UNLIMITED_USES|Unlimited uses| |
 +|RIGHT_CLICK_TO_USE|Right-click to use| |
  
 ~~NOTOC~~ ~~NOTOC~~
localization.1496613822.txt.gz · Last modified: 2017/06/04 15:03 by justin