Bluegrams/ScreenRuler

Add & update translations

alxnull opened this issue · 10 comments

alxnull commented

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 commented

As promised, will do the Portuguese translation.
Thanks.

  • 👍1
3t8 commented

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

SvA1 commented

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

minna-xD commented

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

  • 👍1
alxnull commented

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

  • 👍1
sentiww commented

Hey, I'd like to add a Polish translation

michelvosje commented

Will try to do the Dutch (NL) translations.

  • 👍1
michelvosje commented

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.
  • 👍1
alxnull commented

@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 commented

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