openITCOCKPIT icon indicating copy to clipboard operation
openITCOCKPIT copied to clipboard

Published 20 hours ago • verified publisher icon it-novum

Translate openITCOCKPIT in as many languages as possible

Open ibering opened this issue 2 years ago • 2 comments

Hacktoberfest 2021

Celebrate Hacktoberfest by getting involved in the open source community. We would like to ask you to help us translate openITCOCKPIT in as many languages as possible.

As many as you want - as long as you want

About the project

openITCOCKPIT is a modern web interface to manage Nagios, Naemon or Prometheus based monitoring environment.

For more information please see the projects home page: https://openitcockpit.io/

How to contribute

  1. Fork this repository

  2. Add a comment to this issue, which language you want to translate.

  3. Clone your forked repository (replace YOUR_ACCOUNT_NAME)

git clone https://github.com/YOUR_ACCOUNT_NAME/openITCOCKPIT.git
cd openITCOCKPIT/
  1. Go to the Locale folder
cd resources/locales/
  1. Choose a language you want to translate to
  • 5.1. The language folder does not exist yet: Copy the template folder en_US and rename it like your chosen language. 
    cp -r en_US it_IT

If it is done continue with step 5.2

  • 5.2. The language folder already exists: e.g. 
    cd de_DE/
  1. Translate the content of default.po file 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.

But before you start, please read our Important notes section!

Example:

msgid "Week"
msgstr "Settimana"
  1. If done, please send a pull request

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 it_IT"
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 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 or have any question?

  • Please join our community discord server: https://discord.gg/G8KhxKuQ9G

ibering avatar Oct 06 '21 10:10 ibering

Hello there, I'd like to contribute to this project for Hacktoberfest 2021 by translating default.po to Bahasa Melayu / Malay. Made a PR https://github.com/it-novum/openITCOCKPIT/pull/1257 :)

Paddlepop25 avatar Oct 12 '21 14:10 Paddlepop25

Hello, I'd like to contribute to this project i found on the Hacktoberfest 2021 reddit, i'm currently working on the Italian translation made a first PR in #1261

mRuggi avatar Oct 16 '21 19:10 mRuggi