Skip to content

Translate

Giorgos Retsinas edited this page Oct 10, 2021 · 1 revision

At the time of writing, muCommander is available in 27 languages:
American & British English, French, German, Spanish, Czech, Simplified & Traditional Chinese, Polish, Hungarian, Russian, Slovenian, Romanian, Italian, Korean, Brazilian Portuguese, Dutch, Slovak, Japanese, Swedish, Danish, Ukrainian, Arabic, Turkish, Catalan, Belarusian and Norwegian.

If you wish to add your language to this list or to improve an existing translation, it is greatly welcome!

General

The translations of muCommander are stored in properties files that are encoded in the UTF-8 character encoding [1]. You can find these files at the code repository in the src/main/resources folder. There are two source files:

  • languages.properties: this file contains the list of supported languages, with their localized names.
  • dictionary.properties: this file contains the list of entries that need to be translated with their English translation.

As from version 0.9.2 the translation is done using Zanata, a web-based translation platform for translators, content creators and developers to manage localization projects. The web interface significantly simplifies the translation process and management.

Language maintainer

Every modification of a translation needs to be approved by a maintainer of the language. The language maintainers are defined in the Zanata.

Initially, all the languages are maintained by Arik. However, each language is supposed to be maintained by one or more maintainers that speak the language. If you wish to maintain a language, please file an issue or contact a project maintainer.

Language maintainer that will not be committed to review and modify the language translation could be replaced.

Improving existing translations

If you have spotted a typo or would like to suggest a better wording or found a term that is was not translated into your language, you can propose a change in the Zanata. Find your language in the latest version of muCommander and browse its entries. Changing or adding the translation of specific entries is easy through the web interface.

Translating into a new language

If you intend to introduce a new translation, you should first verify that there is no existing translation into your language in the Zanata. Then, you will need to file an issue. The issue needs to include the name of the language that is to be translated in English and its localized name. One of the project maintainers will then add your language to the Zanata and add you as the language maintainer. At this point, you will be able to translate the required entries in the Zanata. Once the translation is done, a project maintainer will add the language to the languages.properties file [2] and close the issue.

When will your modifications be available?

Modifications that are approved by a language maintainer would be available in the next stable release. From time to time the development branch is updated with the up-to-date translation and then modifications are available in development builds. If you wish to ensure that your modifications are applied to development builds sooner, please contact a project maintainer.

Credits

Language maintainers are recognized in the About dialog of muCommander.

[1] Important: Please ensure that you use UTF-8 when saving the properties files, otherwise muCommander will not be able to load it properly.
[2] The file languages.properties is modified directly, and not through Zanata.