Created Translations (markdown)

NGnius (Graham) 2023-01-11 02:31:34 +00:00
parent c7c25f8ec5
commit f392f98bc2

29
Translations.md Normal file

@ -0,0 +1,29 @@
Want to use PowerTools in a language other than English? Tired of the British monarchy? Then look no further than this page! Here's how to get started translating the user interface.
# Quick Tutorial
1. Copy the [template](https://raw.githubusercontent.com/NGnius/PowerTools/dev/translations/pt.pot) to a file editor
2. Save the file with the four-letter (and dash) locale name of your language (e.g. `fr-CA` for Canadian French)
3. Familiarize yourself with the `po` format:
```po
# comment
msgid "english string"
msgstr "translated string"
# and so on...
```
4. For each pair of lines starting with msgid and msgstr (respectively), write the translated version of the phrase in quotes from the msgid line into the msgstr line (in the quotes).
![image](https://user-images.githubusercontent.com/19637329/211704042-ac5ee48b-51e1-4044-9abe-85c6d5a09dd3.png)
5. From the [translations](https://github.com/NGnius/PowerTools/tree/dev/translations) folder, upload your new translations file.
![image](https://user-images.githubusercontent.com/19637329/211703540-4f232d04-e0a8-4bd2-abf5-a0b38b563762.png)
6. Create a Pull Request (PR) so NGnius sees it and can add it into PowerTools
![image](https://user-images.githubusercontent.com/19637329/211703709-295a390f-647f-4152-9b1d-cb37fb7b749d.png)
7. Feel good for helping people
# RTFM
If all else fails read the reference manual for [gettext translation](https://www.gnu.org/software/gettext/manual/gettext.html#Translators)