youtube-dl-gui/locale_build/HOWTO.md

ADD SUPPORT FOR NEW LANGUAGE

Requires: GNU GetText (If you want to build the MO files on your own)

###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
2. Either download & extract the source from here
3. Or run git clone https://github.com/MrS0m30n3/youtube-dl-gui youtube-dl-gui-master
4. Change directory into youtube-dl-gui-master
5. Copy youtube_dl_gui/locale/en_US/LC_MESSAGES/youtube_dl_gui.po -> locale_build/
6. Change directory into locale_build
7. Edit the PO file with your favorite text editor (See EDIT section)
8. Send me the translated PO file via email to: ytubedlg@gmail.com

####2nd Way

1. Fork youtube-dlg project (See Fork A Repo)
2. Clone your repository git clone https://github.com/<your-username>/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: https://www.gnu.org/software/gettext/manual/html_node/Header-Entry.html

To translate the PO file just edit the msgstr fields

Example

#: mainframe.py:78
msgid "Download"
msgstr "Add the translation here"

BUILD

1. To build the MO file you need to run the corresponding build script for your OS

   Windows: build_locale.bat

   Linux: build_locale.sh

   Usage

   build_locale.<sh-bat> <language code> <translated PO file>

   Example

   ./build_locale.sh gr_GR gr.po

2. Now you also need to add the corresponding language option under the options frame localization tab

3. Open optionsframe.py

4. Locate the LocalizationTab class

5. Find the LOCALE_NAMES attribute

6. Add your language to the LOCALE_NAMES

Example

LOCALE_NAMES = twodict([
  ('en_US', 'English'),
 + ('gr_GR', 'Greek')
])