1. Install the latest package of the JKI Simple Localization Toolkit
2. Extract the .zip file which you have received from HSE
3. Copy the folder hse-i18n_Source\Libraries\hse-i18n into your project folder /APP-NAME_Source\Libraries
4. Add the Translator.ini to your existing Config/Unit_XYZ folder
5. In your project explorer, include the new folder APP-NAME_Source\Libraries\hse-i18n

1. Run the Test Translator API.vi of the Translator to test if it is working
2. Run the Test Translator-UI API.vi of the Translator-UI to test, if it is working

1. Within the Translator-UI, create a new JSON Dictionary file on your hard disc
2. Update Translator.ini located in your Config/Unit_XYZ folder so that the config key dictionary points to the new JSON Dictionary file
3. Once per application: Make sure to start the Translator module before any other modules by adding it to the front of the modules list in config.ini

   • e.g. list = “Libraries\hse-i18n\Translator;Modules\Dummy”

1. For each VI that should be translated:

   1. Use the Translator-UI to define all identifiers and translation phrases which should be used for that VI.
   2. Within that VI, call the Register VI-Request of the Translator and pass the VI reference.

If no language is set, the toolkit will use the current system locale.

Don't forget to set Caption Visible for the controls instead of Labels!

IMPORTANT: For this library to work, you must first set the “Language for non-Unicode Programs” to the target language you wish to translate into. See instructions here

For Windows 11 the setting can be found under Settings > Time & Language > Language & Region:

1. The Toolkit makes use of our Project Structure. At least create two folders where APP-Name can be a name of your choice.
2. Create a Config-Folder /APP-NAME_Config
3. Create a Source-Folder /APP-NAME_Source
4. Copy the the content of the folder hse-i18n_Config into your project folder /APP-NAME_Config
5. create a config.ini which points to your Config/Unit

The repository contains a small example DQMH Module called Dummy in the \Modules subdirectory.

Send the VI reference to the Translator module:

… in the Language Changed event: