Howto: translate HALE with TapiJI¶

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

• Howto: translate HALE with TapiJI
  • Preparations
    • Getting TapiJI
    • Creating needed files
  • TapiJI
    • Overview
    • Start translating
    • Checking your translation in HALE
    • List of items
  • Problems
    • Open several properties files

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

List of items¶

Bundle properties files

eu.esdihumboldt.hale/OSGI-INF/l10n/bundle.properties
eu.esdihumboldt.hale.rcp.wizards.functions.core/OSGI-INF/l10n/bundle.properties

Messages properties files

eu.esdihumboldt.cst/src/main/java/eu/esdihumboldt/cst/transformer/messages.properties
eu.esdihumboldt.cst.corefunctions/src/main/java/eu/esdihumboldt/cst/corefunctions/messages.properties
eu.esdihumboldt.hale/src/eu/esdihumboldt/hale/messages.properties
eu.esdihumboldt.hale.rcp.wizards.functions.core/src/eu/esdihumboldt/hale/rcp/wizards/functions/core/messages.properties
eu.esdihumboldt.hale.rcp.wizards.functions.generic/src/eu/esdihumboldt/hale/rcp/wizards/functions/generic/messages.properties
eu.esdihumboldt.hale.schemaprovider/src/eu/esdihumboldt/hale/schemaprovider/messages.properties

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...