diff --git a/locale_build/HOWTO.md b/locale_build/HOWTO.md index bb196cf..9d65e02 100644 --- a/locale_build/HOWTO.md +++ b/locale_build/HOWTO.md @@ -1,15 +1,35 @@ ## ADD SUPPORT FOR NEW LANGUAGE -**Requires**: [GNU GetText](https://www.gnu.org/software/gettext/) (Only if you want to build the MO files on your own) +**Requires**: [GNU GetText](https://www.gnu.org/software/gettext/) (If you want to build the MO files on your own) -1. Clone or Fork the repository -2. Copy **youtube-dl-gui/youtube_dl_gui/locale/en_US/LC_MESSAGES/youtube_dl_gui.po** to **youtube-dl-gui/locale_build/** -3. Go to **youtube-dl-gui/locale_build** directory -4. Edit the PO file with your favorite text editor (See *EDIT* section) -5. After you have finished the file editing save the file -6. Now you have two options - 1. Send me the translated PO file to this email address: ytubedlg@gmail.com - 2. Build the binary translation file (MO) on your own using the build scripts (See *BUILD* section) +###You have two options in order to add a new translation on youtube-dlg. + +1. Translate the files and send them to me via email. +2. Fork youtube-dlg and push changes on your own. + +####1st Way + +1. Download the source code + 1. Either download & extract the source from [here](https://github.com/MrS0m30n3/youtube-dl-gui/archive/master.zip) + 2. Or run `git clone https://github.com/MrS0m30n3/youtube-dl-gui youtube-dl-gui-master` +2. Change directory into **youtube-dl-gui-master** +3. Copy **youtube_dl_gui/locale/en_US/LC_MESSAGES/youtube_dl_gui.po** -> **locale_build/** +4. Change directory into **locale_build** +5. Edit the PO file with your favorite text editor (See *EDIT* section) +6. Send me the translated PO file via email to: ytubedlg@gmail.com + +####2nd Way + +1. Fork youtube-dlg project (See [Fork A Repo](https://help.github.com/articles/fork-a-repo/)) +2. Clone your repository `git clone https://github.com//youtube-dl-gui` +3. Change directory into **youtube-dl-gui** +4. Copy **youtube_dl_gui/locale/en_US/LC_MESSAGES/youtube_dl_gui.po** -> **locale_build/** +5. Change directory into **locale_build** +6. Edit the PO file with your favorite text editor (See *EDIT* section) +7. Build the binary translation file (MO) using the build scripts (See *BUILD* section) +8. Push changes: +`git add -A; git commit -m "Your commit message here"; git push origin master` +9. Now you can open a new pull request ### EDIT PO file headers informations: @@ -33,9 +53,9 @@ msgstr "Add the translation here" **Example** - Usage: *build_locale.sh* <*language code*> <*translated PO file*> + Usage: `build_locale.sh ` - $ ./build_locale.sh *gr_GR* *gr.po* + `./build_locale.sh gr_GR gr.po` 2. Now you also need to add the corresponding language option under the options frame localization tab 1. Open optionsframe.py @@ -47,8 +67,7 @@ msgstr "Add the translation here" ``` python LOCALE_NAMES = twodict([ ('en_US', 'English'), - ('gr_GR', 'Greek') + + ('gr_GR', 'Greek') ]) ``` - -3. Save the file and now you can make a new pull request after you push your changes to your remote +