From f392f98bc210d41aafe3a62f763ee90aec7367ca Mon Sep 17 00:00:00 2001 From: "NGnius (Graham)" Date: Wed, 11 Jan 2023 02:31:34 +0000 Subject: [PATCH] Created Translations (markdown) --- Translations.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 Translations.md diff --git a/Translations.md b/Translations.md new file mode 100644 index 0000000..30c7828 --- /dev/null +++ b/Translations.md @@ -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) \ No newline at end of file