wiki:TranslatingMuseeq

Translating Museeq


There are several tools needed to create or modify a translation for Museeq.


TS file

To translate museeq, you need to create or modify a .ts file.
Go to this page. There are several .ts file, each one for a specific language.
If you simply want to update an already existing translation, download the corresponding .ts file (for example, download museeq_it.ts if you want to update italian translation).
If you want to create a translation for a new language, download museeq_template.ts and then rename it with the correct country code (museeq_??.ts).


Qt Linguist

Run linguist and open the museeq_??.ts file.

linguist

Familarize yourself with the different modes. When you finish inputting a translation string, hit the green checkmark to complete it. If you do not, the translated string will not appear when you start museeq.

At this step, you can send us your .ts file (open a ticket for that). We'll include it into svn as soon as possible. If you want to test it before, see the following steps.

TS to QM conversion tool

If your translation is not in the list of languages in museeq/CMakeLists.txt (the list is TRANSLATIONS), you can either modify museeq/CMakeLists.txt to include it, or simply build the binary translation file (which has a .qm suffix) from the .ts file.

cd museek+/museeq/translations/
lrelease museeq_??.ts -qm museeq_??.qm

For example, if I wanted to convert the French translation's .ts to a .qm, I'd use this command:

lrelease museeq_fr.ts -qm museeq_fr.qm

If the Qt .ts file is available for your language, use it to translate the Qt dialogs.

lrelease museeq_fr.ts qt_fr.ts -qm museeq_fr.qm


Installing the translation

If your translation is not in the list of languages in museeq/CMakeLists.txt (the list is TRANSLATIONS), you can either modify museeq/CMakeLists.txt to include it and run make install, or copy it manually to your $PREFIX/share/museek/museeq/translations/ directory.


Using the translation

Museeq uses an internal locale-detecting function to decide with translation, if any, it should try to use. This function references the $LANG variable, so running:

LANG=fr museeq

Will start museeq with the French translation, if the museeq_fr.qm file is in $PREFIX/share/museek/museeq/translations/ directory.

Note: if you run museeq from the build directory, museeq will be unable to find the translations, just as it cannot find the default icon theme, as the build directory is $PREFIX.

Go back to DevelopingMuseekPlus | museeq | MuseeqTranslationSupport

Last modified 9 years ago Last modified on 18/11/2008 11:02:47