Thursday, 19 June 2014

LiteDevelop - Multilingual User Interface Tutorial

Hello everyone,

In this post I would like to make clear how the Multilingual User Interface (MUI) system works in LiteDevelop, so if you feel you want to contribute to the project, you can make a translation of the program in your language!

First you need an account on github and be sure you have a fork of the project:
https://github.com/JerreS/LiteDevelop

After that in your fork, go to /Main/LiteDevelop.Framework/Mui/languages.xml and make sure your language is added to that list. If not, add a line in the following format:

<Language name = "Display name" id = "identifier" />
Next step is finding all locations of the Mui directories that hold translations of the application. The main application and every extension do have a Mui folder. Currently there are three extensions, so that makes four folders in total by the time writing this, but there might be more in the future. The structure however stays the same so this would apply for any extension that is being added.

Here are the four folders that are currently available:
Create a new xml file and give it the same name as the identifier specified in the languages.xml mentioned before. You can use the english.xml file as a template. Now start translating!

Be sure to include this file in the project and be sure the file will be copied to the output directory. You can use Visual Studio for this by setting the "Copy to output directory" property to either "Copy always" or "Copy if newer".


That's it! If you did everything correctly, you should be able to select the language in LiteDevelop's options dialog and you'd be good to go.

If you are finished, make sure you send me a pull request on github so I can merge your changes with the main repository.

Happy translating ;)