FreeCol internationalisation
This package contains the FreeCol support for internationalisation
(translation).
The {@link net.sf.freecol.client.gui.i18n.Messages} class provides the API to
the translations. Client code might include:
new AbstractAction( Messages.message("cancel") )
..whereupon the Messages class will look for a file called:
FreeColMessages[_la[_CO]].properties
..where _la and _CO are the language and country codes from the locale. The
most specific file will be loaded. With a US locale, Messages will
look for FreeColMessages_en_US.properties first, then
FreeColMessages_en.properties and finally
FreeColMessages.properties if neither of the other two are found.
FreeColMessages.properties contains a line like this:
cancel=Cancel
..while FreeColMessages_hu.properties has a corresponding line:
cancel=Mégse
MessageMerge
Only FreeColMessages.properties is updated as new messages are added
so a tool is required for translators to keep their translations up to date when
new messages are added.
At the console, type:
ant compile-test
java -cp src/classes net.sf.freecol.client.gui.i18n.MessageMerge src/net/sf/freecol/client/gui/i18n/FreeColMessages.properties src/net/sf/freecol/client/gui/i18n/FreeColMessages_hu.properties
..where the red message file is the one to merge from (typically the one shown
above) and the black message file is the one to merge to.
The screen shot shows "players" and "gameState" messages have been added. Select
the added messages from the left and press the [insert in right] button.
To remove obselete or over-zealously inserted messages, select a range from
the right and press the [delete from right] button.
Press the [save right] button to write the changes to the message file shown
on the right hand side. Doing so will destroy your translation file without
warning so ensure that the file on the right-hand side is committed to CVS
before pressing the button or you risk losing your work.
|
$Revision: 1185 $ $Date: 2006-01-05 19:19:51 +1030 (Thu, 05 Jan 2006) $