Scope
JOC Cockpit ships with language files that include translations for the following languages:
- English
- French
- Japanese
- German
Additional languages can be added for new releases. SOS accepts community contributions for language files provided that the contributor
- provides quality assurance for a correct translation and
- commits to on-going language support in subsequent releases for a minimum of one year.
Language File Location
Language files are included with the JOC Cockpit .war archive file that is extracted on start-up of the service. The extraction is performed to the temp
folder that can be found in the following directory hierarchy:
- When starting JOC Cockpit a temporariy directory is created with the
temp
folder: - Within the temporary directory hierarchy find language files in the following folder structure:
Manage Language File Development
Adding new Language Files
- Open the
translations.js
file to find a single function to which you can add a new language by specifying country code, language code and name. - Create a new language files - preferably by starting from a copy of the English language file - for the naming convention
language_<language code>.json
.
Editing Files
- Language files use a JSON format and can be modified with any text editor.
- Be careful when it comes to use of quotes and commas that have to be in place as visible from the examples. A missing quote or comma invalidates a language file.
Development Cycle
- Language files are read by JOC Cockpit on first use. Any changes to a language file after this point in time are not considered.
- Therefore the following development cycle applies:
- Store the working copy of your language files in folder outside of the JOC Cockpit installation.
- Start the JOC Cockpit service/daemon.
- Copy the modified version of your language file and of the
translations.js
file to the target folder as indicated with the above chapter. - Log in to JOC Cockpit and optionally modify your user profile to use the newly added language. Any new language added to
translations.js
should become available with your profile. - Test your changes to the language file.
- Any modifications to the language file are not immediately considered but require a restart of JOC Cockpit as in step 2).