rmraya / javapm

Project management for localizing Java .properties files

JavaPM

Java Properties Manager

JavaPM is a set of scripts for localizing Java projects using XLIFF as an intermediate format.

JavaPM scans a source folder for all Java resource bundles and converts all source .properties files into a single XLIFF file.

After translating an XLIFF file created by JavaPM, import it to generate the .properties files corresponding to the target language.

Binary downloads

You can download compressed binary packages for Windows, macOS and Linux from https://maxprograms.com/products/javapm.html.

Convert .properties to XLIFF

Running .\createxliff.bat or ./createxliff.sh without parameters displays help for XLIFF generation.

Usage:

    createxliff.bat [-help] -src sourceFolder -xliff xliffFile -srcLang sourceLanguage [-tgtLang targetLanguage] [-reuse] [-2.0]

Where:

   -help:      (optional) display this help information and exit
   -src:       source code folder
   -xliff:     XLIFF file to generate
   -srcLang:   source language code
   -enc:       (optional) character set code for .properties files; default: ISO-8859-1
   -tgtLang:   (optional) target language code
   -reuse:     (optional) reuse existing translations
   -2.0:       (optional) generate XLIFF 2.0

Import translated XLIFF

Running .\mergexliff.bat or ./mergexliff.sh without parameters displays help for importing translated XLIFF files.

Usage:

    mergexliff.sh [-help] -src sourceFolder -xliff xliffFile

Where:

    -help:       (optional) display this help information and exit
    -src:        source code folder
    -xliff:      XLIFF file to merge
    -unapproved: (optional) accept translations from unapproved segments
    -export:     (optional) generate TMX file from approved segments

Build Requirements

• JDK 17 or newer is required for compiling and building.
• Apache Ant 1.10.12 or newer.

Pre-built binaries already include everything you need to run all options.

Building

• Checkout this repository.
• Point your JAVA_HOME variable to JDK 17
• Run ant to generate a binary distribution in ./dist

Steps for building

  git clone https://github.com/rmraya/JavaPM.git
  cd JavaPM
  ant

A binary distribution will be created in /dist folder.