Difference between revisions of "Interface translation"

From Inkscape Wiki
Jump to navigation Jump to search
(Don't lie to users (starting with 1.0 the Windows installer is not translatable anymore and default templates are auto-generated))
(Update translation instructions)
Line 1: Line 1:
Go back to the main [[Translation information]] page.
Go back to the main [[Translation information]] page.


== Main translation file ==
== Main translation files ==


[https://gitlab.com/inkscape/inkscape/tree/master/po Download] the PO file for your language (or the .pot template). See [[Translation information#PO translation files|here]] to get information about how to deal with PO files.
=== 1. Get the file ===
Get the most up-to-date translation files from GitLab's automatic builds:


When you are done with your translation and enjoyed testing it, [[Translation information#Submit finished work|submit your work]].
For the 1.0.x branch:
https://gitlab.com/inkscape/inkscape/-/jobs/artifacts/1.0.x/download?job=translations
 
For the main development branch:
https://gitlab.com/inkscape/inkscape/-/jobs/artifacts/master/download?job=translations
 
In some cases, this will give a 'Page not found' error. In that case, visit the [https://gitlab.com/inkscape/inkscape/ main Inkscape repository page on GitLab], select the correct branch at the top, then on the right side, click on the download icon and select to download the 'translations' artifact.
 
Unzip the downloaded file and select the po file for your language from it.
 
=== 2. Translate ===
 
Translate the file for your language from the archive above with your [https://wiki.inkscape.org/wiki/index.php/Translation_information#Tools_for_translators favorite translation software].


=== Test ===
=== 3. Test ===


# Make sure you have the release of Inkscape you are translating installed. If you're translating the coming release, pick a pre-release and compile it.
# Make sure you have the release of Inkscape you are translating installed. If you're translating the coming release, pick a pre-release and compile it.
Line 14: Line 27:
# Rename the original inkscape.mo file to inkscape.mo.bak and save your compiled .mo file into its place as inkscape.mo instead
# Rename the original inkscape.mo file to inkscape.mo.bak and save your compiled .mo file into its place as inkscape.mo instead
# Then start Inkscape and you'll see your strings!
# Then start Inkscape and you'll see your strings!
=== 4. Get a GitLab account ===
If you don't have an account yet, now is the time to [https://gitlab.com/users/sign_up create one]
=== 5. Exchange the file on GitLab ===
For Inkscape 1.0.x, visit
<code><nowiki>https://gitlab.com/inkscape/inkscape/-/blob/1.0.x/po/<your_locale>.po</nowiki></code>
For the main development branch, go to
<code><nowiki>https://gitlab.com/inkscape/inkscape/-/blob/master/po/<your_locale>.po</nowiki></code>
Click on the "Replace" button and upload your translated file.
Enter your commit message below (something like "Update <your_locale>").
=== 6. Make a merge request ===
Click on the "Create merge request" button.
When you are done with your translation and enjoyed testing it, [[Translation information#Submit finished work|submit your work]].


<!--
<!--

Revision as of 21:33, 17 August 2020

Go back to the main Translation information page.

Main translation files

1. Get the file

Get the most up-to-date translation files from GitLab's automatic builds:

For the 1.0.x branch: https://gitlab.com/inkscape/inkscape/-/jobs/artifacts/1.0.x/download?job=translations

For the main development branch: https://gitlab.com/inkscape/inkscape/-/jobs/artifacts/master/download?job=translations

In some cases, this will give a 'Page not found' error. In that case, visit the main Inkscape repository page on GitLab, select the correct branch at the top, then on the right side, click on the download icon and select to download the 'translations' artifact.

Unzip the downloaded file and select the po file for your language from it.

2. Translate

Translate the file for your language from the archive above with your favorite translation software.

3. Test

  1. Make sure you have the release of Inkscape you are translating installed. If you're translating the coming release, pick a pre-release and compile it.
  2. Compile your PO file to .mo. Some translation tools (e.g. Poedit) have an option for that.
  3. Find and replace your language's .mo file. It is a file named ‘locale/your_language/LC_MESSAGES/inkscape.mo’, in the directory listed under Edit > Preferences > System > Inkscape Data in Inkscape.
    Note: This will not work with the snap, .dmg, AppImage or flatpak version of Inkscape, but only with a version that has been properly installed on your system and with extracted binary archives (zip files for Windows) or self-compiled versions. In some cases, you may need administrator privileges to edit files in said directory.
  4. Rename the original inkscape.mo file to inkscape.mo.bak and save your compiled .mo file into its place as inkscape.mo instead
  5. Then start Inkscape and you'll see your strings!

4. Get a GitLab account

If you don't have an account yet, now is the time to create one

5. Exchange the file on GitLab

For Inkscape 1.0.x, visit https://gitlab.com/inkscape/inkscape/-/blob/1.0.x/po/<your_locale>.po

For the main development branch, go to https://gitlab.com/inkscape/inkscape/-/blob/master/po/<your_locale>.po

Click on the "Replace" button and upload your translated file.

Enter your commit message below (something like "Update <your_locale>").

6. Make a merge request

Click on the "Create merge request" button.

When you are done with your translation and enjoyed testing it, submit your work.