« Previous - Version 15/19 (diff) - Next » - Current version
Andreas Burchert, 03/23/2011 02:33 pm


Howto: translate HALE with TapiJI

This howto describes how you can translate HALE into your language using TapiJI.

Preparations

Getting TapiJI

At first you should download TapiJI .
I recommend the standalone version as the eclipse update site didn't work for me TapiJI_Translator.zip

Extract all files and start TapiJI.

Creating needed files

Translation in HALE is done with .properties files. You can find them in:

src/eu.esdihumboldt.hale*/messages.properties
OSGI-INF/l10n/bundle.properties

I recommend to create your files with eclipse as I encountered problems with TapiJI doing this.
Created files should contain your country code as prefix.

messages_de.properties
bundle_de.properties

messages_en.properties
bundle_en.properties

TapiJI

Overview

As you start TapiJI you will see an overview like this:

[Source: http://code.google.com/a/eclipselabs.org/p/tapiji/wiki/TapiJITools]

Start translating

To finally get started open File > Open Resource-Bundle and navigate to any .properties file.
For example I used

hale/eu.esdihumboldt.hale/OSGI-INF/l10n/bundle.properties

You will see a new tab with all available strings in the entry overview.
Click on the first item and choose the target language in the editing area.

After the message is translated you can either click on the next entry or press ENTER to jump to the next item in the right field.
If you jumped too far (or just want to go back) press shift+ENTER to get back.

You should save (ctrl+s) your editing from time to time as TapiJI is in version 0.0.1 .

Checking your translation in HALE

If you start HALE using the HALE.product it will automatically use your platform locale and should display all available translated strings. Sometimes your locale might be different then your language but you can configure eclipse to run it with your desired language.
Therefore go to Run > Run Configuration > HALE > Arguments and add

-nl en_US # for example

Problems

Open several properties files

You better should not open different properties files. After you finished one file, close it and open the next. I lost some translated files due to this feature. Maybe it was just my mistake but you never know...

package_explorer.png - Package Explorer (7.8 kB) Andreas Burchert, 03/24/2011 08:13 am

example.png - Example hale/eu.esdihumboldt.hale/OSGI-INF/l10n/bundle.properties (24.8 kB) Andreas Burchert, 03/24/2011 08:40 am