Skip to end of metadata
Go to start of metadata


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:

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:
    1. Store the working copy of your language files in folder outside of the JOC Cockpit installation.
    2. Start the JOC Cockpit service/daemon.
    3. Copy the modified version of your language file and of the translations.js file to the target folder as indicated with the above chapter.
    4. 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.
    5. Test your changes to the language file.
    6. Any modifications to the language file are not immediately considered but require a restart of JOC Cockpit as in step 2).

Language File Build Integration

  • No labels
Write a comment…