1. Fork the repository

Fork our repository into your personal GitHub account by pressing on Fork in the top right corner of our github repository page

https://github.com/it-novum/openITCOCKPIT

Clone the repository (replace YOUR_ACCOUNT_NAME)

git clone -b development https://github.com/YOUR_ACCOUNT_NAME/openITCOCKPIT
cd openITCOCKPIT/

IMPORTANT! Please make sure to clone the development branch!

2. Go to the locales folder

cd resources/locales

3. Choose a language you want to translate to

Step 3.1: The language folder does not exist yet

Copy the template folder en_US and rename it like your chosen language.

e.g.

cp -r en_US de_DE

If it is done continue with step 3.2

Step 3.2: The language folder already exists

e.g.

cd de_DE

4. Translate

Translate the content of *.po files (e.g. default.po)

The translation must be done line by line.

The msgid contains the original english content and should not be touched!

The translated message goes to msgstr.

If you haven´t done an openITCOCKPIT translation yet, please read the Important notes section!

Example:

msgid "Week"
msgstr "Woche"

5. Commit, push & create PR

Replace YOUR_ACCOUNT_NAME with your GitHub account name.

git checkout -b development_translation_YOUR_ACCOUNT_NAME
git add .
git commit -m "Added translation for de_DE"
git push origin development_translation_YOUR_ACCOUNT_NAME

To contribute your changes, you need to send a pull request:

Please notice: You need to select development as base branch while you create your pull request.

Important notes

Don´t translate en_US, that´s our source language :)

• Special words are not to translate
  • openITCOCKPIT, Statusengine, CakePHP, Gearman, GearmanWorker
  • LDAP, OpenLDAP, PHP, SSO, NRPE, NDO, UUID, ARO, ACO, ACL,
  • Nagios, Naemon, NPCE, NDOUtils
  • .....
• Don´t touch placeholders, escape characters, classes, values or html (style) code
  • % prefixed characters are used for replacements. (e.g. %s replaces a string or %1$s)
  • \ escapes "
  • CrudAuthorize::authorize() is an example for an internal class. (Needed for error messages)
  • $ prefixed words are variables (e.g. $PATH, $USER1$, $ARG1$)
  • use <b>This is bold</b> to generate bold characters
  • use <success>Green text</success> to generate green characters
• Keep length of strings that are using blank characters to get an uniform length

msgid  "User:         %s"
msgstr "Benutzer:     %s"

Need help?

Join #openitcockpit on freenode.net for any questions