Creating a localization

Hyunjin Song edited this page Aug 19, 2017 · 7 revisions

Why create a localization?

A lot of people prefer to use a program in their own language. Therefore localizations for each language are required. As LMMS isn't available in all common languages, there's a need for people creating new or improving already available translations of LMMS. If there's no translation for your language yet, you can create a new one. The following short article will guide you through the process of creating a translation.

How to create a translation

The easiest way to create and submit translations is by joining our Transifex LMMS team. You'll need to create a Transifex account for this. Then you can send a request to join the language team. Please wait patiently while we reviewing your request, this could take from several seconds to several days. After joining the language team, you can contribute to the LMMS localisations. If you are unfamiliar with Transifex, you can refer to their comprehensive guide to get started. When translating, Do not translate sentences that you're not sure how to translate. Often it's more clear to just leave the English string. It isn't bad at if your translation is not complete. One day someone else may add the missing translations.

If you want to download the translation to work offline or don't want to use Transifex editor, you can work in our traditional way: First checkout a recent (stable) version of LMMS from Git repository. Afterwards you need to create a new empty file called "XX.ts" where XX are two characters identifying your localization, e.g. de for Germany, fr for France, it for Italy and so on. Example:

 touch data/locale/de.ts

In the next step we actually create the localization file:

 mkdir build
 cd build
 cmake ..
 make XX.ts
 cd ..

Now look into directory "data/locale" where you should find the according ts-file. You can open this file using Qt Linguist, which is usually part of Qt-development-packages. The usage of Qt Linguist doesn't require any explanations as you just have to translate the current string and hit <enter></enter> to process next one.

After you're done with Qt Linguist, it's time to integrate your translation into LMMS. Either directly send the translation maintainer or language coordinator an email and attach your ts-file or do the following: open the "file"-menu in Qt Linguist and select "release". Qt Linguist automatically fills in the correct output filename, so just click on "OK" and that's all. All you have to do now is running

 make install

for installing LMMS to an appropriate location. Then run it and it should speak your language ;-) If not either your locale environment variable is incorrect or you did something wrong at another place. So if you can't figure it out, send the maintainer your ts-file, but if you have a Transifex account, you can upload the ts-file to corresponding language instead. Click your language, then click "lmms.ts", and it will popup a menu, you need to click "upload file" and select your ts-file. and very soon you'll be able to checkout a version of LMMS containing also your translation ;-)

Currently supported languages

  1. [Poor] Arabic
  2. Catalan
  3. Chinese (Simplified)
  4. Chinese (Traditional)
  5. Czech
  6. Dutch
  7. English
  8. [Poor] Farsi
  9. French
  10. Galician
  11. German
  12. Italian
  13. Japanese
  14. Korean
  15. Polish
  16. Portuguese (Brazilian)
  17. Russian
  18. Spanish
  19. Swedish
  20. Ukrainian
source
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.