murrty / youtube-dl-gui

Download/Convert videos from websites without needing to learn command line
GNU General Public License v3.0
422 stars 45 forks source link

[HELPERS NEEDED] Adding non-English languages & Localization information #20

Open murrty opened 4 years ago

murrty commented 4 years ago

As of youtube-dl-gui version 2.2, support for multiple languages was added to the program which allow non-English speakers to use the application given that the language file is present... which is where I need help from anyone willing to participate in building this program. I will appreciate it a tremendous amount for anyone helping with translating.

The default English template used within the program is located here (raw link here). This is the template that should be followed when translation.

Modifying the localization is like editing an .ini file, the key is located to the left of the equals = sign, and the value is to the right. An example translation key would be like this: btnRedownloadYoutubedl=(Re)download youtube-dl. Any values that contain an equal sign will show the equal sign as well, unless issues arise where this is not respected. More information about translating can be found within the English template.

There are 2 known places that are not translatable:

When forking the repository to add or modify the languages, be sure all localization files are location at the Languages folder in the root of the master repository (if forks are present). Be sure to include your name in the localization file when translating for credits with the translation. If you do this, do not remove other peoples' names either as it's an aggregated list of people who helped translate that language.

Found a value that isn't represented? Open an issue with details about it. If it is acknowledged as "not translatable", the issue will be closed as wontfix.

bovirus commented 1 year ago

@murrty

Could be usefukl to change the issue thread to a titke that explain better your request, Ex.

"How to add a new language to the program"

I propose to add these infos "How to translate" in a section" Translation" in home page of your github reposiory.

murrty commented 1 year ago

You're right, I'll refactor some of the pinned issues for better legibility.

maboroshin commented 1 year ago

If the translated version have an internal string style like chkUseSelection, no new strings are added. Please add the English.ini changes to your language ini. If have a lot of this internal string, just adding English will useful even if you are not a translator.

Change History of English.ini : https://github.com/murrty/youtube-dl-gui/commits/master/Languages/English.ini

For each change, click on the 7-digit hash string from the history (View commit details)