From cd1372c6387cae53211137573b8952057b689574 Mon Sep 17 00:00:00 2001 From: MrS0m30n3 Date: Wed, 13 Dec 2017 22:20:45 +0200 Subject: [PATCH] Update localization_howto.md --- docs/localization_howto.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/localization_howto.md b/docs/localization_howto.md index 0017a91..3ad04c5 100644 --- a/docs/localization_howto.md +++ b/docs/localization_howto.md @@ -43,6 +43,7 @@ * [Git](https://git-scm.com/downloads) * [Transifex CLI client](https://docs.transifex.com/client/installing-the-client) * Some kind of text editor to edit some code (notepad++, nano, etc are sufficient) + * A Transifex account, [sign-up](https://www.transifex.com/signup/) ### Notes * The instructions below assume basic knowledge of the command line (OS independent). @@ -50,6 +51,7 @@ * You can locally edit the translation file (PO) by opening it using a simple editor and editing the **msgstr** fields. * You can find the translation file (PO) after downloading it under the `youtube_dl_gui/locale//LC_MESSAGES/` directory. + * In order to get the translations from Transifex **your account needs permissions to access the project**. ### Getting Started 1. Open a terminal @@ -57,7 +59,7 @@ 3. Test that Transifex CLI client works: `tx --version` 4. Clone upstream using Git: `git clone https://github.com/MrS0m30n3/youtube-dl-gui` 5. Change to project directory: `cd youtube-dl-gui` - 6. Pull the translation you want to test from Transifex: `tx pull --force -l ` + 6. Pull the translation you want to test from Transifex (**Auth needed**): `tx pull --force -l ` 7. Make the language appear under **Options>General** tab (only for new languages): 1. Open the **optionsframe.py** under the **youtube_dl_gui** directory 2. Search for the **LOCALE_NAMES** attribute @@ -89,6 +91,7 @@ * Read [Testers](localization_howto.md#testers) notes first. * Binary translation files (MO) are ignored and you should not push them upstream. * Don't forget to update the [ChangeLog](../ChangeLog) after adding a new language. + * You can gather all extra requirements below using **pip**. ### Getting Started @@ -109,13 +112,21 @@ #### Build the binary translation files (MO) 1. Just run the setup script: `python setup.py build_trans` -#### Automatically check translations using Google translate (Requires: polib & google_translate) +#### Automatically check translations using Google translate (Requires: polib & doodle_translate) 1. Change directory to `devscripts` 2. Run the check script: `python check-translation.py ` -#### Update source strings +#### Get translations from Transifex (Requires: Permissions to access project) + * Pull everything: `tx pull -a` + * Pull reviewed: `tx pull --mode reviewed -a` + * Pull everything (force): `tx pull -a -f` + * Pull specific language: `tx pull -l ` + * Pull only completed translations (100%): `tx pull -a --minimum-perc=100` + +#### Update source strings (Only Maintainers, Requires: python-gettext) 1. Change directory to `devscripts` 2. Run the `update-locales.sh` script (also builds MO files) + 3. Push changes to Transifex: `tx push --source --translations` #### Add support for new language locally (DEPRECATED, ONLY TESTING) 1. Change directory to `devscripts` @@ -127,6 +138,7 @@ * [PO file headers](https://www.gnu.org/software/gettext/manual/html_node/Header-Entry.html) * [GNU gettext manual](https://www.gnu.org/software/gettext/manual/html_node/index.html#SEC_Contents) * Transifex [user roles](https://docs.transifex.com/teams/understanding-user-roles) + * Transifex [CLI client introduction](https://docs.transifex.com/client/introduction) ## FAQs No faqs yet