Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate openITCOCKPIT in as many languages as possible #1573

Open
ibering opened this issue Oct 9, 2023 · 9 comments
Open

Translate openITCOCKPIT in as many languages as possible #1573

ibering opened this issue Oct 9, 2023 · 9 comments
Labels
hacktoberfest https://hacktoberfest.digitalocean.com help wanted

Comments

@ibering
Copy link
Member

ibering commented Oct 9, 2023

Hacktoberfest 2023

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

Currently in progress

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?

@ibering ibering added help wanted hacktoberfest https://hacktoberfest.digitalocean.com labels Oct 9, 2023
@protob
Copy link
Contributor

protob commented Oct 9, 2023

Hi, I can add Polish locale. Can you assign me?

@nook24
Copy link
Member

nook24 commented Oct 9, 2023

Hi @protob that's awesome!
Not sure how to assign you to this but I have added a Currently in progress section to the description and also created a new Issue for Polish: #1574

@protob
Copy link
Contributor

protob commented Oct 9, 2023

@nook24 OK. Thank you.

@mRuggi
Copy link
Contributor

mRuggi commented Oct 14, 2023

Last year I was working on the IT locale, can it be assigned to me so I continue?

@kshjessica
Copy link

kshjessica commented Oct 15, 2023

@ibering
Hello! I'd like to add a Korean tranlation but it seems that there isn't Korea in the country list. Would it be available to add Korea and progress the translation?

@ibering
Copy link
Member Author

ibering commented Oct 16, 2023

Hi @mRuggi this sounds very good!

I created a new Issue for Italian: #1574

@ibering
Copy link
Member Author

ibering commented Oct 16, 2023

Hi @kshjessica that's awesome!

Would it be available to add Korea and progress the translation?

Of course :)

I created a new Issue for Korean: #1582

@chriscarnold
Copy link
Contributor

Hi @ibering, I can add Spanish and Indonesian if needed, would love to contribute!

@ibering
Copy link
Member Author

ibering commented Oct 30, 2023

Hi @chriscarnold,

Spanish would be awesome but honestly you are free to pick any language you want :)

#1592
#1593

Feel free to pick one of the issues

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
hacktoberfest https://hacktoberfest.digitalocean.com help wanted
Projects
None yet
Development

No branches or pull requests

6 participants