Translation

Available Translations are

Language Code Remark
English en default language
French fr
German de
Hungarian hu
Italian it
Polish pl
Romanian ro
Russian ru
Spanish es
Tamil ta not complete
Telugu te update required
Singalese si Only chart graphics

Language Setup

Windows: Open the configuration dialog/tab general. Chose the language from the choice box. Restart the program.

Linux/OS x, BSD: you must configure the environment variable LANG. The required command on the (Bash-) shell looks like

export LANG = de_DE.UTF-8

Examples for supported languages are

Language LANG
English (default) en_US.UTF-8
German de_DE.UTF-8
Polish pl_PL.UTF-8
Russian ru_RU.UTF-8
Telugu te_IN.UTF-8

Please restart the application after changing the language.

How to Translate the Program

Translation of the program is done with GNU gettext. There are free translation tools that make translation easy.

First Steps

Find out the correct language code (iso code) of your language. There is a 2 letter short code for almost every language, e.g. de for German language, etc. A list of these codes can be found in the Gettext Documentation.

Getting the PO File

The required PO file is

  • maitreya[version].pot: if you want to create a new translation
  • [lang].po: if you want to modify a translation that already exists

The PO file is part of the source code release. e.g. the file maitreya[version].zip that can be downloaded from the source code distribution. It can be found in the directory "po".

It can also be downloaded from the Github source code repository. The root URL of the repository is http://github.com/martin-pe/maitreya8/tree/master/po.

Configuration on Windows Systems

Quit the program if it is running.

Open the configuration file which is located in in the configuration directory, see the Directory Layout chapter. Find the key General/langList. Add the code of your language with space separation.

Start the program and open the configuration dialog. Your language should be visible in the language list.

Make a new directory named like the code of your language in the program's folder, e.g. c:Program FilesMaitreyaLANG.

Copy the file maitreya8.pot to that directory an rename it to LANG.po.

Configuration on Linux/Unix Systems

Go to the po directory of the source code tree. Edit the file LINGUAS and add the code of your language. Copy the file maitreya8.pot to lang.po. Go to the root or the source tree and type

automake && autoconf && configure && make

The compiler will complain about missing header entries. Add these entries and try again.

Note: if you want to test your translation from the source code tree: create a directory named like the language code in the gui directory. Go into that directory and link the gmo file to maitreya8.mo, e.g. ln -s ../../po/lang.gmo maitreya8.mo.

Write the Translation

Get a po file editor like poEdit or KBabel (available as package on most Linux/Unix systems).

Open the LANG.po file and translate the messages. There about 1000 messages. Compile the message catalogue to lang/maitreya8.mo (Windows) or lang.gmo (Linux/Unix) and test your translation.

You are encouraged to publish your translation for the benefit of the community.

Note: Non European languages should use a Unicode character set (UTF-8).