This page gathers useful information about translation.
Links and docs
- How to contribute in translation
- Translations statistics
- Using Inkscape's repositories
- Subscribe to the translator mailing list
- Translator mailing list archives
- Interface translation
- Documentation translation
- Website translation
PO translation files
Add a new translation file
If the PO file for your language does not exist yet, then you must create it as a copy of the translation template. This template is a file whose name ends with .pot. It contains the strings to translate without any translation. Create a copy and put it to the right place (just see how other languages are managed).
Tools for translators
You can edit PO files from any plain text editor, since they are simple text files. However, many useful tools have been developed to provide a simple experience translating PO files.
You might also try:
- Emacs' po-mode (contained in the gettext distribution; the version in po-utils is old);
- gedit — text editor for GNOME desktops, has a syntax highlight mode for PO file syntax;
- Virtaal — cross-platform PO editor that is clean, simple to use yet powerful;
- Gtranslator (GNOME).
And last but not least, gettext utils, which are installed on every Linux distribution. You can see a complete reference too from installed info pages by running the command:
If you open a PO file with a text editor for the first time, you will find its syntax very simple. The PO format is a really simple format, which probably at least partly explains its success and widespread use. The format is basically a hash list consisting of msgid and msgstr pairs, with the msgid being the original English string and key, and the msgstr being the translated value of it. Below is an example of a message.
#: gedit/dialogs/gedit-plugin-program-location-dialog.c:78 #: gedit/dialogs/program-location-dialog.glade2.h:2 msgid "Set program location..." msgstr "Ställ in programplats..."
In addition to the msgid and msgstr parts, a message usually also has lines starting with
#: that tell what source files and what lines the string used as msgid was extracted from. These lines have no syntactic value. They are only there as a help for translators and developers to know where a message came from.
A message in a PO file can be in one of essentially three different states. The message can be translated, fuzzy, or untranslated. A message counts as translated as soon as the msgstr part of it is non-empty. In a similar manner, an untranslated message is one where the msgstr is empty. The fuzzy state is special and essentially means that there is a translation in the msgstr part, but that this translation is most likely not entirely correct, and that it thus needs manual attention by a translator. A message can become fuzzy in one of two ways:
- The original string that the msgid represents was changed in the source code. A typo in the string may have been fixed or the string altered in some other way. The translator needs to check that the msgstr is still valid and make changes if necessary.
- A new string has been added to the source, and the string is similar (but not identical) to the msgid of an already existing, translated message. Then the msgstr of that message will be automatically reused for the new message, but the new message will also at the same time be marked fuzzy so that the translator knows there is some difference that he or she needs to adapt the translation to match.
A few important things to remember
- Some strings that can be ambiguous or having several meanings according to different contexts may have a context prefix : ‘Context|Ambiguous string’. In this case, simply translate ‘Ambiguous string’, the ‘Context|’ part is just a not to translate indication (some info on how to disambiguate a string can be found here).
- After translating a fuzzy string (one that is marked with a
", fuzzy"comment), please remove its fuzzy tag — otherwise this translation will be discarded by the build process, meaning that this string will show up untranslated.
- Before publishing your work (after you have finished updating the PO file), please update the
"Last-Translator"fields in the PO file header.
If you use a translation software, it may automatically deal with the last two points for you (see its preferences).
Before submitting your file to the project, you should make sure it is valid.
- Make sure the file is encoded in UTF-8.
- Make sure it is a valid PO file and obtain some statistics about it: simply run
msgfmt --statistics -cv translation_file.pofrom a command window.
- Make sure it is correctly formatted: run
check-markup translation_file.pofrom a command window and verify it doesn't output any error message. The ‘check-markup’ Perl script can be found in the /po directory of Inkscape trunk.
If your translation software can compile PO files to .mo, it should detect any errors when you save your translations so you don't need to do any further verifications.
There is always one special message in each valid PO file: the PO file header. It is encoded with the msgid for the empty string (
"") as the key, and the actual header values are in the msgstr part. This unfortunately means that if you mark an empty string for translation, you will get the entire PO file header back as the ‘translation’. In almost all cases this is probably not what you want. Hence, do not mark empty strings for translation.
Please make sure you use dgettext for any pluralized strings.
Submit finished work
To submit your work, you need an account on Launchpad.
When you translated a file, upload it via the Launchpad bug tracker for the proper repository: interface, docs, website. Open a new bug report entitled ‘Translation to <your language>’ and attach the files you created or modified to it.
Alternatively, if you use Bazaar, you can make a merge request on Launchpad:
- Commit your changes to your own branch (put the right information instead of the <placeholders>):
bzr commit --local -m "Translated <file> for <language>, <xx>% complete"
bzr push lp:~<your-launchpad-name>/<proper-inkscape-repository>/translation-<language>
- Visit your branch on the Launchpad website and make a merge request to ask for your changes to be included in the main branch.
Additionally, you may send a message to Inkscape's translators mailing list.
Much thanks for your work!
This is the start of a list of places to get translation reviews done. So far: