How to translate OpenJUMP into another language

From OpenJUMP Wiki
Jump to navigation Jump to search

The steps on how to translate OpenJUMP

This in an example for translation into Brazilian Portuguese.

NOTE The steps below show the translation on the operating system windows. The steps however are pretty much generally the same for every operating system.

Translation process
  1. download the last nightly built from
  2. unpack it e.g. to 'C:\OJfolder' (used in the subsequent steps)
  3. if your operating system is configured to use the language you want to translate you can skip this step
    • edit the start script for your platform
    • locate the following lines in the file OJfolder\bin\oj_windows.bat, a similar line exists in for MacOS and Unix os's
     rem --- uncomment and change your language/country here to overwrite OS locale setting ---
     rem set JAVA_OPTS=%JAVA_OPTS% -Duser.language=de
    • uncomment the line
    • add your language and optionally country code
     set JAVA_OPTS=%JAVA_OPTS% -Duser.language=pt 
  4. extract the folder language from 'OJfolder\lib\openjump-core-*.jar' (where * are nightly built specific name) into 'OJfolder' resulting in 'OJfolder/language' containing lots of jump_*.properties files
  5. look in language folder for a file called "". If it does not exist see #On new translations and come back here thereafter.
  6. open the file with your favorite editor and translate the strings
    HINT if it appears like one line of text try an editor that supports unix line breaks e.g. wordpad
  7. you will see that on left side is an identifier string while on the right side of the "=" (equal sign) is the translated text
    HINT new strings have a date line just before like [sstein 7 march 2007]
  8. when you are finished editing, save the file
NOTE you should verify your changes by running OpenJUMP now and doublechecking your changes
  1. start openjump with the start script for your platform
  2. check the translated strings
  1. send me the modified properties file to sstein@geo(....) or
to the development mailing list

After adding it, the nightly built of the next day should include your Portuguese translation. I hope that is detailed enough :o) If questions appear please don't hesitate to contact me (Stefan/sstein)

On new translations

  • please simply make a copy of the file file and rename the copy to your language abbreviation (e.g. the swedish one should be like:
  • translate everything
  • put the properties file into language folder

Useful tools

Translation of non latin languages like Chinese, Vietnamese, Japanese etc.

  1. Use an editor (notepad or notepad++) to do the translation and save it as UTF-8 format as
  2. Convert the utf-8 to unicode using native2ascii.exe (part of the java development kit, e.g. C:\Program Files\Java\jdk<version>\bin\native2ascii.exe
    C:\>native2ascii -encoding utf8 
ATTENTION characters such as chinese may not be shown properly in the splash image.