Diplomacy Map by Joe Campbell: fnord@evilgeniuses.org Ankara Armenia Constantinople Moscow Sevastapol St. Petersburg Syria Ukraine Livonia Warsaw Prussia Silesia Berlin Kiel Ruhr Munich Rumania Bulgaria Greece Smyrna Albania Serbia Budapest Galacia Vienna Bohemia Tyrolia Trieste Finland Sweden Norway Denmark Holland Belgium Venice Piedmont Tuscany Rome Apulia Naples Burgandy Marseilles Gascony Picardy Paris Brest Spain Portugal North Africa Tunis London Wales Liverpool Yorkshire Edinburgh Clyde North Atlantic Ocean Norwegian Sea Barents Sea Gulf of Bothnia Baltic Sea Skagerrak Helgoland Bight North Sea English Channel Irish Sea Mid-Atlantic Ocean Western Mediterranean Gulf of Lyon Tyrrhenian Sea Adriatic Sea Ionian Sea Aegean Sea Eastern Mediterranean Black Sea Switzerland swi adr aeg alb ank apu arm bal bar bel ber bla boh bre bud bul bur cly con den eas edi eng fin gal gas gre bot lyo hel hol ion iri kie lon lvn lvp mar mao mos mun naf nap nao nth nwy nwg par pic pie por pru rom ruh rum ser sev sil ska smy spa stp swe syr tri tun tus tyr tys ukr ven vie wal war wes yor jDip

in Work - Internationalization (i18n, Localization)

All text (including dialog text) in jDip is kept in separate files, organized by language. This allows editing and translation of text without recompiling any of the source code.

Some translation resources are available on the Links page.

How to Change the Language jDip Uses

From the command line: java -jar jdip.jar -lang xx where xx is the ISO 2-digit language specifier. For example, “en” for English, “fr” for French, “nl” for Dutch, etc. jDip will print out the language it is attempting to use on the command line. If a particular language is not found, it will default to English.

How to Get the Text

The easiest way to find, modify, and test the text required to translate is by:

  1. Locate the directory where jdip.jar is kept
  2. Copy jdip.jar to a backup file, such as jdip.jar.bak
  3. Rename jdip.jar to jdip.zip
  4. Unzip jdip.zip to the current directory.
  5. Now, jdip can be started by the following command: (test and see) java dip.gui.splash or with a language via java dip.gui.splash -lang fr
  6. The resource files to translate are under the resource directory, specifically il8n. There will be several “.properties” files, with the language codes seen before. There will also be a directory called dialog which contains dialog text.
  7. Open one of the properties files with a text editor. You will see text, which can be translated.

Property Files

Property files have the following structure:

  • Lines that start with # are comments
  • Text on the left side of the = is the “key” by which jDip gets the text on the right side. The right sided text (never the left-side text) is what is language-dependent. The left side text must stay the same.
  • You may see parameters surrounded by curly braces (e.g., {0}). These indicate to jDip where it should insert certain data.
  • Sometimes, you will see a reference to a path, such as: resource/il8n/dialog/en/GameEndDlg.html. This means that jDip will use the GameEndDlg.html file, which is in the en/ directory.

Dialog Files

(TODO). Most are in HTML.

Tools Needed

(TODO). dicuss native2ascii, needed for accent-mark translation

Translating Parameterized Messages

(TODO). dicuss parameterized messages, choice messages, and MessageFormat.

Search