Follow us on:

Home » Contribute » Translations

How to contribute in translation

Community based, user oriented

The translations of the various documents focusing on Inkscape rely on the work of volunteers. Motivation for this work can range from the simple pleasure to contribute to take the opportunity of learning a lot about Inkscape and translation processes. It is very important not to forget that Inkscape is an open source, community based and user oriented project, which implies that software developers/contributors are generally users. It also implies that the translation efforts are user oriented, with a strong focus on interface, user documentation and website.

Guidelines/workflow to translate the software

Subscribe to Inkscape translator mailing list. By subscribing on Inkscape's translator list you will be able to ask for help on some questions more related to Inkscape issues to other Inkscape translators, as well as the mantainers.

Get files for your language. If you only want to translate the interface messages, you can get the files from Inkscape's bazaar repository web interface. Besides getting files from web interface, you can obtain the full repository (see Working with Bazaar). See section #Translatable_content for which files you have to modify to translate each part of Inkscape.

Submit finished work to patch tracker. Finished translations must be sent to patch tracker and/or mailing list in order to be integrated into the trunk. You will need a Launchpad account to commit patches to Inkscape's patch tracker. Before sending a file, remember to check that the file(s) you are submitting doesn't have syntax errors that would break the building process. Send a mail on the translator mailing list. Your contribution will be reviewed/commited as soon as possible.

Best practices

Polishing Translations - Microtypography

Here are some things to note in order to achieve good microtypography (typography at the word or character level).

Links

Translatable content

Inkscape's translation effort covers many areas, from aplication UI itself to web pages and tutorials. This is a summary of all those areas, sorted by priority.

These tasks, rather than being for hackers only, can be achieved by most software enthusiasts, whether they have a technological background or were just plain users. The main requirement is the wish to provide support for Inkscape on your language: the technology required for you to do that has been developed in a simple approach, and it involves mainly text files and applications used to verify its syntax. Supporting applications were existing to make these tasks much easier.

User interface

PO files contain the strings for the Inkscape user interface (main software and extentions). A PO file is a text file which contains the original English message and its translation. That's why it is obviously the translation to start with.

See Interface translation page for detailed information on the PO files.

Tutorials

As you know, Inkscape comes with some very nice SVG tutorials. By translating them, users will learn how to use the application, as well its tips and tricks. It is even a good opportunity for you to become more acquainted with Inkscape.

See Documentation Translation page for detailed information on tutorial translation.

Keyboard and mouse shortcuts

Inkscape is proud for having keyboard and mouse shortcuts for almost all of its functionality. Those shortcuts can help you increase your drawing productivity/efficiency. The map of the default shortcuts is embedded in the interface (help menu) next to the tutorials, and can also be accessed from the web site.

Windows installer

High value for users, even if the installation process of Inkscape is quite simple, translating the Windows installer helps potential users a lot to get a good feeling when they use Inkscape.

See Interface translation page for detailed information for Windows installer translation.

Templates

The default template of the Inkscape document can be localized to make the localization consistent. Localized can be the (size?) of the default document and also the name of the default layer.

See Interface translation page for detailed information on default document's template.

Man pages

The man pages consist of a standard user documentation, available from the command line. On Unixbased systems simply type "man inkscape" from the prompt of a command window.

Some distributions also generate a browsable (html) man page, accessible from a dedicated help shortcut.

The man page of Inkscape provides some insightful information about the software, especially focused on operations that do not require GUI (example: export to png from the command line, or extract one object from a svg file).

See Documentation Translation page for detailed information for man page translation.

Release notes

Translating release notes helps the "normal user" to get a lot of insight into the capabilities of Inkscape.

See WebSite Translation page for detailed information on translating release notes.

Web pages and News

To know how to contribute in translating or posting news and articles on the website, see this our dedicated page.