Translator

We want to adapt Freeseer for as many non-native environments as possible. There should be no language barrier between Freeseer and our users. Help us in our localization efforts.

Add a Translation

  1. Open the Qt Linguist tool – it should come with your installation of PyQt
  2. Translation files are located in freeseer/src/freeseer/frontend/qtcommon/languages/
  3. Using Qt Linguist, open translation (.ts) files for languages you wish to add
  4. Once the translation is complete, send a pull request

See also

Qt Linguist manual for translators

Update Translation Resources

For new translations to appear in Freeseer, you need to update the translation resources. This task is typically left to a developer, not a translator. If you feel uncomfortable doing these steps, please ask a developer to update the translation resources.

1. Update Translation Files

This step only needs to be completed if a developer wrote code that contains new translation strings in the user-interface. To update translation files:

$ cd freeseer/src/freeseer/frontend/qtcommon/languages
$ pylupdate4 freeseer.pro

The freeseer.pro file specifies which source files contain translation strings, as well as which translation files need to be updated and/or created. If you want to translate to a new language, add a new locale for that language.

2. Add Qt Translation Files to Freeseer-monitored List

Next, you need to update the list of monitored translations by editing freeseer/src/freeseer/frontend/qtcommon/resource.qrc.

Add the following line:

<file alias="languages/tr_LANGUAGE_LOCALE.qm">languages/tr_LANGUAGE_LOCALE.qm</file>

where LANGUAGE and LOCALE are specific to your translation. For example, for an American English translation:

<file alias="languages/tr_en_US.qm">languages/tr_en_US.qm</file>

3. Update Qt Resource Files

When translations are ready to be used, they need to be imported into Qt’s resource files. We included a script to automate the process. Simply run:

$ cd freeseer/src/freeseer/frontend/qtcommon
$ make

You should now see your translations the next time you run Freeseer.