Skip to content

Latest commit

 

History

History
25 lines (21 loc) · 2.52 KB

i18n.md

File metadata and controls

25 lines (21 loc) · 2.52 KB
Raw

Add new translation

Adding new languages to the launcher's portfolio or helping out with translating single labels or messages is quite easy. You only need to decide on the target language you want to translate to and find the appropriate language code for your target language. In the following steps, <code> will represent the associated language code for your target language <language>.

  1. Copy the English labels LabelsBundle_en.properties to a new file LabelsBundle_<code>.properties in 
    src/main/resources/org/terasology/launcher/bundle/
  2. Translate everything to your target language. The property files need to be valid Java properties files (ISO 8859-1 character encoding).
  3. Repeat (1) and (2) for the messages in MessageBundle_en.properties.
  4. Add a settings_language_<code>=... entry to each LabelsBundle_*.properties file for other languages. This is used to display the new translation in the settings. The value of this entry is the translated name of your target language (e.g., in when translating to German, the entry in LabelsBundle_en.properties would be settings_language_de=German, while in LabelsBundle_de.properties it would be settings_language_de=Deutsch.
  5. Modify src/main/java/org/terasology/launcher/util/Languages.java: create a new locale, add your target language to the supported locales and select the settings label.
  6. Add a flag icon to represent your target language in the settings menu. To do this, download the appropriate icon from the famfamfam.com icon pack into src/main/resources/org/terasology/launcher/images/flags (or create your own 16x11 icon!)
  7. Add a flag_<code>=... entry to the ImageBundle.properties file located in the same folder as the LabelsBundle_*.properties file you've edited previously.

To keep everything nice and clean, we advise you to use a feature branch:

  • git checkout master
  • git checkout -b <language>-translation
  • Add/Change files
  • git commit ....
  • git push
  • Open pull request