[Looking for help!] Localization of WGDashboard

[donaldzou]

Hi all, I finally finished adding the support of localization, and currently WGDashboard support the following languages:

• Czech
• Chinese (Simplified)
• Chinese (Traditional)
• Dutch
• English
• German
• Italian
• Polish
• Spanish
• Swedish
• Russian
• Turkish
• Ukrainian

If anyone are willing to contribute, you can follow the instructions below:

1. git clone the main branch
2. Copy `language_template.json and rename them using the locale code in this list: https://www.science.co.il/language/Locale-codes.php
3. Start translate! Remember don't edit the key, just the value.

You might notice there are some Regex syntax in the existing locale files. Basically, the dashboard will match the key to the texts in the UI, and replace the value using regex. So you can adjust the position of matching groups to better fit your language.
For example: You can add up to (.*) peers have one matching group which is matching a number between to and peers, and you can use $1 in the value to represent the number.

After you're done translating:

1. Add your translation to active_languages.json by following this format

[
    {
        "lang_id": "zh-cn",
        "lang_name": "Chinese (Simplified)",
        "lang_name_localized": "中文 （简体）"
    }
]

2. Run the check script

python3 verify_locale_files.py

It will tell you if your translation have missing translation or deprecated one, and it will insert or remove them directly for you:

python3 verify_locale_files.py
 
========================================================
| WGDashboard Locale File Verification [by @donaldzou] |
========================================================

Active Languages

Czech | cs
German | de-de
English | en
Spanish | es-es
Italian | it-it
Dutch | nl-nl
Russian | ru
Turkish | tr-tr
Ukrainian | uk
Chinese (Simplified) | zh-cn
Chinese (Traditional) | zh-hk
Swedish | sv-se
Polish | pl

Please enter the language ID to verify: zh-cn

	[Missing Translations] 0 translation
	[Deprecated Translations] 0 translation
	[Note] All missing translations are added into zh-cn.json, all deprecated translations are removed from zh-cn.json

Please comment below if you have any questions 😄

[DaanSelen]

I can provide Dutch if you'd like, but how would I do that?

[donaldzou]

I can provide Dutch if you'd like, but how would I do that?

Hi @DaanSelen, I provided an instruction above :) Is fairly easy as I already have an example in the v4.1-dev branch. Basically the file looks like this:

{
	"Welcome to": "歡迎來到",
	"Username": "用戶名",
	"Password": "密碼",
	"OTP from your authenticator": "您多重身份驗證器的一次性驗證碼",
	"Sign In": "登錄"
...
}

Where the key is what you translating from, and the value is what you are translating to. The example provided is Chinese (Traditional)

[NOXCIS]

@donaldzou I can do the Spanish & Portuguese bit.

[orangeferdi]

@donaldzou I will support with German! :)

[donaldzou]

Hi @3vis97 ! Thank you for providing the Italian translation. Do you mind creating a PR to my v4.1-dev branch so I can merge your work to mine?

[3vis97]

Hi @3vis97 ! Thank you for providing the Italian translation. Do you mind creating a PR to my v4.1-dev branch so I can merge your work to mine?

Hi @donaldzou!
Yes i will do, but before I create the PR, I'd like to test the translation in a live instance to ensure the female, male and plural forms are correct and the translation sounds natural in the web interface.

I only need to find the time to do it. I hope to do it in the next few days 👍🏻

[donaldzou]

Hi @3vis97 ! Thank you for providing the Italian translation. Do you mind creating a PR to my v4.1-dev branch so I can merge your work to mine?

Hi @donaldzou! Yes i will do, but before I create the PR, I'd like to test the translation in a live instance to ensure the female, male and plural forms are correct and the translation sounds natural in the web interface.

I only need to find the time to do it. I hope to do it in the next few days 👍🏻

For sure! Please take your time and can't thank you enough for providing this ;)