Difference between revisions of "Interface translation"
(→Windows installer: Removed redundent sentence) |
|||
(14 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
Go back to the main [[Translation information]] page. | Go back to the main [[Translation information]] page. | ||
== Main translation | == 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 [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]. | |||
=== 3. Test === | |||
If you | # 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. | ||
# Compile your PO file to .mo. Some translation tools (e.g. Poedit) have an option for that. | |||
# 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. <br>''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.'' | |||
# 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! | |||
=== 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. | |||
In the form, check 'Allow commits from members who can merge to the target branch' and also 'squash commits'. | |||
Submit the merge request. | |||
<!-- | |||
== Windows installer == | == Windows installer == | ||
# Get the file according to your language [ | # Get the file according to your language [https://gitlab.com/inkscape/inkscape/tree/master/packaging/win32/languages here]. If there's no such file, copy the ‘English.nsh’ file and rename it to ‘YourLanguage.nsh’ (make sure someone updates the file [https://gitlab.com/inkscape/inkscape/blob/master/packaging/win32/languages/_language_lists.nsh _language_lists.nsh] in this case). | ||
# Translate the strings in the file. | # Translate the strings in the file. | ||
# Change header information in ‘YourLanguage.nsh’ (language name, [https://msdn.microsoft.com/en-us/goglobal/bb895996.aspx | # Change/update header information in ‘YourLanguage.nsh’ (language name, [https://msdn.microsoft.com/en-us/goglobal/bb895996.aspx locale ID] and authors list) to proper values. | ||
# Save the file. (Translation files should always use Unicode, encoded as UTF8!). | |||
# Optionally, test your translation as described below. | # Optionally, test your translation as described below. | ||
# [[Translation information#Submit finished work|Submit your work]] (specify whether you tested it or not). | # [[Translation information#Submit finished work|Submit your work]] (specify whether you tested it or not). | ||
=== | === Test === | ||
# [[Compiling Inkscape|Compile Inkscape]] (you'll probably want to [[Compiling Inkscape on Windows|Compile Inkscape on Windows]]) and run <code>make install</code> to create the binary distribution directory of Inkscape. | |||
# Install [http://nsis.sourceforge.net/Main_Page NSIS]. | # Install [http://nsis.sourceforge.net/Main_Page NSIS]. | ||
# Right-click on the ‘inkscape.nsi’ file and choose ‘Compile NSIS Script’. The installer compilation will start. | # Right-click on the ‘inkscape.nsi’ file and choose ‘Compile NSIS Script’. The installer compilation will start. | ||
# When the installer is | # When the installer is ready, run it to test your translations for the installer and the uninstaller. | ||
== Default template == | == Default template == | ||
To translate the default template: | To translate the default template: | ||
* Modify the ‘default.svg’ file and save it as ‘default.xx.svg’ where ‘xx’ is the ISO code of your language. You will find the current template [ | * Modify the ‘default.svg’ file and save it as ‘default.xx.svg’ where ‘xx’ is the ISO code of your language. You will find the current template [https://gitlab.com/inkscape/inkscape/tree/master/share/templates here]. | ||
* Modify your PO translation to use your localized default template. Look up for a ‘default.svg’ string and translate it accordingly to the file name of the localized template. | * Modify your PO translation to use your localized default template. Look up for a ‘default.svg’ string and translate it accordingly to the file name of the localized template. | ||
* To test your template, save it as well as the compiled PO file (.mo) to the proper location for your system and restart Inkscape. New documents should now be based on your localized template (this is valid if your system is properly set to your locale). | * To test your template, save it as well as the compiled PO file (.mo) to the proper location for your system and restart Inkscape. New documents should now be based on your localized template (this is valid if your system is properly set to your locale). | ||
Line 50: | Line 79: | ||
To translate the default template, you can use Inkscape as well as any UTF-8 encoding capable text editor. | To translate the default template, you can use Inkscape as well as any UTF-8 encoding capable text editor. | ||
--> | |||
[[Category:Translation]] | [[Category:Translation]] |
Revision as of 21:40, 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
- 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.
- Compile your PO file to .mo. Some translation tools (e.g. Poedit) have an option for that.
- 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. - 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!
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.
In the form, check 'Allow commits from members who can merge to the target branch' and also 'squash commits'.
Submit the merge request.