Language Resources

Owned by Kyle McEwan
Sept 14, 2023
2 min read

NOTE: Not all areas of JEMH currently allow the use of several language resources.

JEMH comes shipped with 1 initial language translation file, which is for the English language. However, it is now possible to add your own translation files for whatever languages you please.

How to change the language resource used for your profile

The language used for JEMH is user/profile independant and is defined in your Profile settings found at:

  • Profile > Summary > Preferences > Language

However, if you attempt to use a language that doesn’t have a resource file within your application JAR, then you will not be able to use JEMH in that language.

How to add your own language translations file

As new versions of JEMH are released, these translation keys may change and translation modifications are out of our support scope and therefore it is your responsibility to keep your custom translation files up to date and working.

Dont forget to add your custom translation property files to the JEMH jar every time you upgrade as it will not remain present when you upgrade due to the JAR being replaced, so store somewhere safe other than just the JEMH JAR!

  1. Find the jemh_resources.properties file within the JEMH JAR, found at:

  • /com/javahollic/jira/jemh/react-i18n/

  1. Add the Locale of the new language that you will be adding a translations file for, followed by the name of the properties file that will be added containing the translations. Below are a few examples such as “en_GB” which is the English, Great Britain Locale and “jemh_en_GB“ is the properties file that will contain the English translations.

https://www.oracle.com/java/technologies/javase/jdk8-jre8-suported-locales.html

en_GB=jemh_en_GB de_DE=jemh_de_DE

  1. Then create the new properties file which will contain all of the translations within the folder that you found the jemh_resources.properties file at, /com/javahollic/jira/jemh/react-i18n/. It MUST have the same name as you defined in the jemh_resources.properties file, i.e. jemh_en_GB.properties

  2. Within this file is where you add your translations, you MUST include all keys and their translations or JEMH wont be able to find what text to display within the UI and it will appear broken. Below are a few examples:

    1. English

com.javahollic.jira.emh.auditing.retentionSettings=Retention settings

b. German

com.javahollic.jira.emh.auditing.retentionSettings=Aufbewahrungseinstellungen

  1. The jemh_en_GB.properties file that is shipped with JEMH contains all keys that are used within JEMH that can have several translations, you must translate all of these keys if youd like your new translation file to work.