ScreenRuler icon indicating copy to clipboard operation
ScreenRuler copied to clipboard

Add & update translations

Open alxnull opened this issue 3 years ago • 10 comments

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!

alxnull avatar Oct 04 '20 21:10 alxnull

As promised, will do the Portuguese translation. Thanks.

Joaolfelicio avatar Oct 04 '20 21:10 Joaolfelicio

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

3t8 avatar Oct 04 '20 22:10 3t8

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

SvA1 avatar Oct 05 '20 10:10 SvA1

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

minna-xD avatar Oct 06 '20 20:10 minna-xD

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

alxnull avatar Oct 07 '20 19:10 alxnull

Hey, I'd like to add a Polish translation

sentiww avatar Oct 08 '20 18:10 sentiww

Will try to do the Dutch (NL) translations.

michelvosje avatar Oct 10 '20 19:10 michelvosje

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.

michelvosje avatar Oct 10 '20 20:10 michelvosje

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

alxnull avatar Oct 11 '20 08:10 alxnull

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

FrejBjornsson avatar Oct 12 '20 18:10 FrejBjornsson