Resources for providing different languages for the Web UI of dcm4chee-arc-light

There are two different types of language specific resources:

  • a key/value map in JSON format used by the UI for labeling UI components, and
  • various JSON Schema files, specifying the name, type, description, default value of configuration attributes of various configuration entities.

First are located under src/main/webapp/assets/locale/##.json, with ## as the ISO 639-1 two-letter code of the language (e.g. es for Spain, pt for Portuguese, ru for Russian).

The second are located under src/main/webapp/assets/schema/. For other languages than English, a subdirectory with the ISO 639-1 two-letter code of the language has to be created, including copies of that JSON Schema files with translated values for "title" and "description" JSON properties.

Alternatively to directly editing that JSON files, you may translate title and description separated by | in corresponding key/value properties files, located in src/props, and committing the modified files under a subdirectory named with the ISO 639-1 two-letter code of the language:

  1. The English version of the key/value properties files are created/updated from the JSON Schema files by invoking dcm4che's utility json2props:

    $ json2props src/main/webapp/assets/schema src/props
    src/main/webapp/assets/schema/hl7ExportRule.schema.json=>src/props/hl7ExportRule.properties
    src/main/webapp/assets/schema/hl7OrderScheduledStation.schema.json=>src/props/hl7OrderScheduledStation.properties
    ...
    src/main/webapp/assets/schema/metrics.schema.json=>src/props/metrics.properties
    
  2. Translated versions of the key/value properties files for one language can be converted back to JSON Schema files by invoking (e.g.)

    $ json2props src/main/webapp/assets/schema src/props/hi src/main/webapp/assets/schema/hi
    src/props/hi/hl7ExportRule.properties=>src/main/webapp/assets/schema/hi/hl7ExportRule.schema.json
    src/props/hi/hl7OrderScheduledStation.properties=>src/main/webapp/assets/schema/hi/hl7OrderScheduledStation.schema.json
    ...
    src/props/hi/metrics.properties=>src/main/webapp/assets/schema/hi/metrics.schema.json
    

    If the translated key/value properties files miss some (new) entries already defined in the English version of the JSON Schema files in src/main/webapp/assets/schema, the created language specific JSON Schema file are supplemented with the entries from the English version.

  3. Converting the so created JSON Schema files back to the language specific key/value properties files by invoking (e.g.)

    $ json2props src/main/webapp/assets/schema/hi src/props/hi
    src/main/webapp/assets/schema/hi/hl7ExportRule.schema.json=>src/props/hi/hl7ExportRule.properties
    src/main/webapp/assets/schema/hi/hl7OrderScheduledStation.schema.json=>src/props/hi/hl7OrderScheduledStation.properties
    :
    src/main/webapp/assets/schema/hi/metrics.schema.json=>src/props/hi/metrics.properties
    

    will add the previous missing entries in the key/value properties files, where title and description in English separated by | can be replaced by translated terms.

  4. After the replacement of the supplemented new properties, the language specific JSON Schema files can be updated with the new translated terms by converting the updated key/value properties files back to JSON Schema files as described in 2..