Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add & update translations #14

Open
alxnull opened this issue Oct 4, 2020 · 10 comments
Open

Add & update translations #14

alxnull opened this issue Oct 4, 2020 · 10 comments
Labels
good first issue Good for newcomers hacktoberfest help wanted Extra attention is needed

Comments

@alxnull
Copy link
Member

alxnull commented Oct 4, 2020

This project is always looking for help with translation to non-English languages. If the translation to your language is missing, incomplete or has errors, you're very welcome to contribute!

Where are the files to translate?

This project uses Microsoft's .resx file format to store app resources such as UI string. In the repo, every translation has its own .resx file, all of the form <resource-file-name>.<language-code>.resx.

Additionally, there is a help file that needs translation.

How to contribute?

Important: Before contributing a new translation, make sure no open pull request for this language already exists & no one has commented on adding this translation below. Then comment below that you want to add this language.

Start by forking this repository. Resx files are best edited with some additional tooling:

With Visual Studio

  1. Clone your forked repository
  2. ResX Resource Manager is a great tool to edit .resx files. Install the Visual Studio extension and open it via the "Tools" menu.
  3. ResX Resource Manager shows a table of all strings available for translation. Edit them or add a column for a new language via the toolbar.
  4. Translate the help file.
  5. Commit your changes, push and create a pull request. Link this issue in your PR.

Without Visual Studio

  1. Clone your forked repository
  2. ResX Resource Manager is a great tool to edit .resx files. Install the standalone version, run it and select the directory containing your cloned repository.
  3. The tool should now show all the strings available for translation in a table. Edit them or add a column for a new language via the toolbar.
  4. Translate the help file.
  5. Commit your changes, push and create a pull request. Link this issue in your PR.

P.S.: Don't forget to star this repo if you like it!

@Joaolfelicio
Copy link
Contributor

As promised, will do the Portuguese translation.
Thanks.

@3t8
Copy link
Contributor

3t8 commented Oct 4, 2020

I edited the Italian translation (a few things were off)

@SvA1
Copy link
Contributor

SvA1 commented Oct 5, 2020

Hi, I'd like to add Russian translation, haven't found one in repos.

alxnull pushed a commit that referenced this issue Oct 5, 2020
* Added Portuguese pt-PT translation. #14

* Added help.pt.html translated in portuguese. #16
alxnull pushed a commit that referenced this issue Oct 5, 2020
* added Russian translation #14

* minor fixex in Russian translation
@minna-xD
Copy link
Contributor

minna-xD commented Oct 6, 2020

Hello! I'd like to help add Finnish translation.

alxnull pushed a commit that referenced this issue Oct 6, 2020
@alxnull
Copy link
Member Author

alxnull commented Oct 7, 2020

@minna-xD Great, tell me if you need any help.

@sentiww
Copy link
Contributor

sentiww commented Oct 8, 2020

Hey, I'd like to add a Polish translation

@michelvosje
Copy link
Contributor

Will try to do the Dutch (NL) translations.

@michelvosje
Copy link
Contributor

michelvosje commented Oct 10, 2020

Note that some existing languages might currently not be visible from the about page.

Tips for other developers:

  • Do install this ResX Resource Manager. It makes your life a lot easier.
  • After creating your resource files you can select your language from the About page and restart the app.
  • It's of course also possible to just change your UI thread culture info from the program.cs.

@alxnull
Copy link
Member Author

alxnull commented Oct 11, 2020

@michelvosje Thanks for the tips and the hint regarding missing languages. I just removed the need for the explicit list of available language in AssemblyInfo to make all languages visible from the About page automatically.

@FrejBjornsson
Copy link
Contributor

FrejBjornsson commented Oct 12, 2020

Hello! I would like to help with a Swedish (sv) translation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue Good for newcomers hacktoberfest help wanted Extra attention is needed
Development

No branches or pull requests

8 participants