|
|
(38 intermediate revisions by 4 users not shown) |
Line 29: |
Line 29: |
| 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. | | 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 section [[#Interface_Translation]] for information on PO files. | | See [[http://wiki.inkscape.org/wiki/index.php/InterfaceTranslation#Interface_Translation InterfaceTranslation]] page for detailed information on the PO files. |
|
| |
|
| == Tutorials == | | == Tutorials == |
Line 35: |
Line 35: |
| 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. | | 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. |
|
| |
|
| See section [[#Tutorial_Translation]] for information on translating tutorials. | | See [[http://wiki.inkscape.org/wiki/index.php/DocumentationTranslation#Tutorial_Translation Document Translation]] page for detailed information on translating tutorials. |
|
| |
|
| == Windows installer == | | == Keyboard and mouse shortcuts == |
|
| |
|
| High value for users, even if the installation process of Inkscape is quite simple, translating the Windows installer helps a lot potential users feeling good with Inkscape.
| | Inkscape is proud of having keyboard and mouse shortcuts for almost any funtionality. Those shotcuts 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. |
|
| |
|
| == Templates ==
| | See [[http://wiki.inkscape.org/wiki/index.php/DocumentationTranslation#Keyboard_and_mouse_translation Document Translation]] page for detailed information on translating shortcuts. |
|
| |
|
| == Release notes == | | == Windows installer == |
| Translating [http://wiki.inkscape.org/wiki/index.php/Release_Notes release notes] helps giving a lot of visibility to Inkscape
| |
|
| |
|
| - give a general overview of the possibilities of the software to potential users
| | High value for users, even if the installation process of Inkscape is quite simple, translating the Windows installer helps a lot potential users feeling good with Inkscape. |
|
| |
|
| - can be used for local marketing (local Free Software/Linuw/Graphics oriented web sites, articles in fanzines, e-magazines and even magazines...)
| |
|
| |
|
| == News displayed on Inkscape web site ==
| | See [[http://wiki.inkscape.org/wiki/index.php/InterfaceTranslation#Windows_installer_translation Interface Translation]] page for detailed information on translating Windows installer. |
|
| |
|
| == Web pages == | | == Templates == |
| English is generaly the exchange-tongue of developppers, and developper/user documentation is mainly written in English.
| |
|
| |
|
| Translation efforts should be first oriented on user documentation.
| | The default template of Inkscape document can be localized to make the localization consistent. Localized can be size of the default document and also the name of default layer. |
|
| |
|
| See the main pages of Inkscape and of this wiki to get some exemple of the translations of websites. | | See [[http://wiki.inkscape.org/wiki/index.php/InterfaceTranslation#Default_template_translation InterfaceTranslation]] page for detailed information on default document's template. |
|
| |
|
| | == Man pages == |
| | The man pages consist in a standard user documentation, available from the command line on Unix systems simply type "man inkscape" from the prompt of a command window). |
|
| |
|
| == Others ==
| | Some distributions also generate a browsable (html) man page, accessible from dedicated help shortcut. |
| Templates (translation and localization)
| |
| Text files found in the inkscape directory
| |
| ...
| |
|
| |
|
| = Interface Translation =
| | The man page of Inkscape provides some insightful information about the software, aspecially foused on operations that do not require GUI (example: export to png from the command line, or extract one object from a svg file). |
|
| |
|
|
| |
|
| If you're interested in helping with providing interface translation for Inkscape,
| | See [[http://wiki.inkscape.org/wiki/index.php/DocumentationTranslation#Man_pages DocumentTranslation]] page for detailed information on translating man pages. |
| here are a few links to help you getting started:
| |
|
| |
|
| http://www.gtkmm.org/gtkmm2/docs/tutorial/html/ch20s03.html
| | == Release notes == |
| http://developer.gnome.org/projects/gtp/l10n-guide/
| | Translating [http://wiki.inkscape.org/wiki/index.php/Release_Notes release notes] helps giving a lot of visibility to Inkscape |
| http://developer.gnome.org/projects/gtp/style-guides/
| |
| http://developer.gnome.org/doc/tutorials/gnome-i18n/developer.html
| |
|
| |
|
| Download the .po file for your language from here:
| | - give a general overview of the possibilities of the software to potential users |
|
| |
|
| http://svn.sourceforge.net/viewcvs.py/inkscape/inkscape/trunk/po/
| | - can be used for local marketing (local Free Software/Linuw/Graphics oriented web sites, articles in fanzines, e-magazines and even magazines...) |
|
| |
|
| If a .po file for your language does not yet exist, then create one
| |
| by copying the inkscape.pot file that gets generated when you run make
| |
| in the codebase.
| |
|
| |
|
| Edit the file to add or correct translations of the English strings, and
| | See [[http://wiki.inkscape.org/wiki/index.php/WebSiteTranslation#Release_notes WebSiteTranslation]] page for detailed information on translating release notes. |
| then upload your work via the [[SourceForge]] patch tracker:
| |
|
| |
|
| http://sourceforge.net/tracker/?func=add&group_id=93438&atid=604308
| | == User manual == |
| | Some members of the Inkscape community are also focusing on an [[http://wiki.inkscape.org/wiki/index.php/UserManual user manual]]. This document can be read as a reference document for advanced users and as a good introduction to the functionalities of Inkscape by everyone. |
|
| |
|
| (Check the Upload checkbox and add your file or patch.)
| | See [[http://wiki.inkscape.org/wiki/index.php/DocumentationTranslation#User_Manual DocumentTranslation]] page for detailed information on translating the user manual. |
|
| |
|
| | == Web pages, News and Wiki == |
| | English is generaly the exchange-tongue of developppers, and developper/user documentation is mainly written in English. |
|
| |
|
| | Translation efforts should be first oriented on user documentation. |
|
| |
|
| Here's how to make an absolutely up-to-date translation (in case the PO file in SVN is not up-to-date enough):
| | You can take a look at the [[http://wiki.inkscape.org/wiki/index.php/WebSiteTranslation WebSiteTranslation]] page for detailed information about how to translate the web content of Inkscape |
|
| |
|
| 1. update your local copy of Inkscape in the usual way: "svn update"
| | See [[http://wiki.inkscape.org/wiki/index.php/WebSiteTranslation#Translation_of_web_site WebSiteTranslation]] page for detailed information on translating the web site, news and wiki. |
| 2. "./autogen.sh"
| |
| 3. "./configure"
| |
| 4. enter the "po" directory: "cd po"
| |
| 5. generate the current PO template: "intltool-update --pot"
| |
| 6. merge your existing translations into the new POT file (inkscape.pot):
| |
| "msgmerge your_latest_PO_file inkscape.pot > new_PO_file"
| |
|
| |
|
| Then you just need to complete the translations in the PO file that was
| | See the [[http://wiki.inkscape.org/wiki/index.php/Main_Page main wiki page of Inkscape]] to get some examples (Spanish and German) of the translation of this wiki |
| created in step 6.
| |
|
| |
|
| | | == Others == |
| If you want to update ALL .po files in po/, cd there and run:
| | Text files found in the inkscape directory |
| | | ... |
| make update-po
| |
| | |
| | |
| == Tools for translators == | |
| * emacs' po-mode (contained in the gettext distribution; the version in po-utils is old)
| |
| * kbabel (http://i18n.kde.org/tools/kbabel/)
| |
| * gtranslator (http://gtranslator.sourceforge.net/)
| |
| * poEdit (http://poedit.sourceforge.net/)
| |
| | |
| == A few important things to remember ==
| |
| * Some strings that can ambiguous or having several meanings according to different contexts may have a context prefix : "Context|Amibiguous string". In this case, simply translate "Ambiguous string", the "Context|" string is just a not to translate indication.
| |
| * 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. KBabel can do this automatically (see KBabel settings).
| |
| * Before publishing your work (after you have finished updating the PO file), please update the "PO-Revision-Date" and "Last-Translator" fields in the PO file header. KBabel can do this automatically.
| |
| | |
| == Review ==
| |
| This is the start of a list of places to get translation reviews done. So far:
| |
| http://www.linux.it/tp/
| |
| | |
| == Verification ==
| |
| Before submitting your file in the patch tracker, please 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 translationFile.po" from a command window
| |
| * Make sure it is correctly formatted: run "check-markup translationFile.po" from a command window and verify it doesn't output any error message. "check-markup" perl script can be found in the /po directory of Inkscape svn trunk
| |
| | |
| == Locale Testing ==
| |
| Before reporting that a locale doesn't work in Inkscape, you need to make sure that your system has that locale correctly set up. To do this, you need to generally find a way to run "locale-gen". (Under Debian/Ubuntu this is via "dpkg-reconfigure locales".) If you set both the LANG and LANGUAGE variables and check a regular tool, you should see the correct language for both the libc error (first line) and the tool error (second line):
| |
| | |
| LANG=es_MX LANGUAGE=es_MX ls -z
| |
| ls: opción inválida -- z
| |
| Pruebe `ls --help' para más información.
| |
| | |
| If it reports the regular C messages, your locale has not been correctly configured, and you'll need to find the right way to run "locale-gen" for your distribution:
| |
| | |
| LANG=es_ES LANGUAGE=es_MX ls -z
| |
| ls: invalid option -- z
| |
| Try `ls --help' for more information.
| |
| | |
| == Programmers ==
| |
| Please make sure you use [http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC150 dgettext] for any pluralized strings.
| |
| | |
| | |
| = Tutorial Translation =
| |
| | |
| Inkscape tutorial sources are in [[DocBook]] format, with illustrations in SVG. If you want to translate one or more tutorials, first download the [[DocBook]] source here:
| |
| | |
| http://svn.sourceforge.net/viewcvs.cgi/inkscape/doc-docbook/trunk/
| |
| | |
| Each tutorial is in its own subdirectory. You need the *.xml file, for example basic/tutorial-basic.xml. Get it and simply replace all English text in it with the text in your language, preserving all XML markup. See README at that location for some notes on markup.
| |
| | |
| * If there's already such a file in SVN, you can edit it instead :) If there's no xml file at the above location but there's a translation of this tutorial in SVG format (in share/tutorials in Inkscape distribution), you'll need to convert it to [[DocBook]] (and probably update). Conversion can be done simply by: select the text blocks of an SVG tutorial in Inkscape, Ctrl+C, and Ctrl+V in your text editor, then add the markup.
| |
| | |
| * Save your file as <original name>.<language suffix>.xml, for example basic/tutorial-basic.es.xml for Spanish.
| |
| | |
| * Do not use symbolic entities like &aacute; (they're not defined in XML without a DTD). Instead use either numeric entities such as &#225; or simply write your text in UTF-8.
| |
| | |
| * Most illustrations don't need translations, so you leave the references to them from English XML intact. If however an illustration has some text that you want to translate, open the illustration file in Inkscape (e.g. basic/basic-f12.svg), edit it as needed, and save under a different name (e.g. basic/basic-f12-es.svg). Then change the filename reference in the XML source appropriately.
| |
| | |
| * When finished, run [http://xmlsoft.org/xmllint.html xmllint] on your file to make sure it's well-formed.
| |
| | |
| * Send the file to Joshua Andler <scislac at users dot sf dot net>, and he'll convert it to SVG and HTML and upload it to SVN and the web site.
| |
| | |
| * If after that you want to make any changes, download the file from the above location again, because it may have changed compared to the one you have.
| |
| | |
| ==Tools==
| |
| * OmegaT - http://www.omegat.org/omegat/omegat_en/omegat.html
| |
| * Transolution - http://transolution.python-hosting.com/
| |
| | |
| ===Transforming XML into PO files===
| |
| One can also use xml2po to get PO files out of the XML sources, and also transform the PO files back to XML. After you have a PO file, follow the instructions for editing those files below.
| |
| | |
| xml2po is available in gnome-doc-utils (http://ftp.gnome.org/pub/gnome/sources/gnome-doc-utils/).
| |
| | |
| Here are some command lines that were used to translate a German tutorial (the de-locale), please adapt accordingly until we nicely integrate this into our Makefiles.
| |
| | |
| <pre>
| |
| ## use this at the very beginning, when there is no translation at all:
| |
| xml2po --output=basic/tutorial-basic.pot basic/tutorial-basic.xml
| |
| | |
| ## use this when there is a *.de.xml, but you want a de.po:
| |
| xml2po --output=basic/de.po --reuse=basic/tutorial-basic.de.xml basic/tutorial-basic.xml
| |
| | |
| ## xml2po is not happy when this directory doesn't exist:
| |
| mkdir .tmp.basic
| |
| | |
| ## use this when the tutorial-basic.xml has been updated and you
| |
| ## want the new stuff in your de.po:
| |
| xml2po --update-translation=basic/de.po basic/tutorial-basic.xml
| |
| | |
| ## use this to create a tutorial-basic.de.xml from your de.po (ScislaC
| |
| ## will use this file to create the final tutorial SVG file)
| |
| xml2po --po-file=basic/de.po basic/tutorial-basic.xml > basic/tutorial-basic.de.xml
| |
| | |
| </pre>
| |
| | |
| = Keyboard and mouse translation =
| |
| | |
| = Wiki and web site =
| |
|
| |
|
| = Status = | | = Status = |
| | | See this [[http://wiki.inkscape.org/wiki/index.php/TranslationStatus dedicated page]] |
| == Interface translation (po files) ==
| |
| | |
| The names and e-mail addresses of contributors and last translator can be found in the header of the po file (simply open it with your favorite text editor)
| |
| | |
| Total number of PO files: 38
| |
| Total number of strings to translate: 2142
| |
| | |
| | |
| '''Amharic''': am.po
| |
| | |
| translated: 77 ( '''3%''')
| |
| | |
| fuzzy: 592 ( 27 %), untranslated: 1473 ( 68%)
| |
| | |
| Date of last update: 2003-02-01
| |
| | |
| | |
| '''Azerbaijani/Turkic''': az.po
| |
| | |
| translated: 63 ( '''2%''')
| |
| | |
| fuzzy: 853 ( 39 %), untranslated: 1226 ( 57%)
| |
| | |
| Date of last update: 2001-12-04
| |
| | |
| | |
| '''Belarusian''': be.po
| |
| | |
| translated: 158 ( '''7%''')
| |
| | |
| fuzzy: 945 ( 44 %), untranslated: 1039 ( 48%)
| |
| | |
| Date of last update: 2003-07-20
| |
| | |
| | |
| '''Catalan''': ca.po
| |
| | |
| translated: 2039 ( '''95%''')
| |
| | |
| fuzzy: 24 ( 1 %), untranslated: 79 ( 3%)
| |
| | |
| Date of last update: 2006-05-08
| |
| | |
| | |
| '''Czech''': cs.po
| |
| | |
| translated: 2096 ( '''97%''')
| |
| | |
| fuzzy: 18 ( 0 %), untranslated: 28 ( 1%)
| |
| | |
| Date of last update: 2006-05-22
| |
| | |
| | |
| '''Danish''': da.po
| |
| | |
| translated: 100 ( '''4%''')
| |
| | |
| fuzzy: 980 ( 45 %), untranslated: 1062 ( 49%)
| |
| | |
| Date of last update: 2002-01-15
| |
| | |
| | |
| '''German''': de.po
| |
| | |
| translated: 2116 ( '''98%''')
| |
| | |
| fuzzy: 6 ( 0 %), untranslated: 20 ( 0%)
| |
| | |
| Date of last update: 2006-05-23
| |
| | |
| | |
| '''Greek''': el.po
| |
| | |
| translated: 44 ( '''2%''')
| |
| | |
| fuzzy: 998 ( 46 %), untranslated: 1100 ( 51%)
| |
| | |
| Date of last update: 2001-12-28
| |
| | |
| | |
| '''Spanish''': es.po
| |
| | |
| translated: 2125 ( '''99%''')
| |
| | |
| fuzzy: 6 ( 0 %), untranslated: 11 ( 0%)
| |
| | |
| Date of last update: 2006-05-25
| |
| | |
| | |
| '''Spanish/Mexico''': es_MX.po
| |
| | |
| translated: 337 ( '''15%''')
| |
| | |
| fuzzy: 930 ( 43 %), untranslated: 875 ( 40%)
| |
| | |
| Date of last update: 2004-04-05
| |
| | |
| | |
| '''Estonian''': et.po
| |
| | |
| translated: 9 ( '''0%''')
| |
| | |
| fuzzy: 778 ( 36 %), untranslated: 1355 ( 63%)
| |
| | |
| Date of last update: 2000-04-08
| |
| | |
| | |
| '''Basque''': eu.po
| |
| | |
| translated: 1548 ( '''72%''')
| |
| | |
| fuzzy: 340 ( 15 %), untranslated: 254 ( 11%)
| |
| | |
| Date of last update: 2006-03-16
| |
| | |
| | |
| '''French''': fr.po
| |
| | |
| translated: 2126 ( '''99%''')
| |
| | |
| fuzzy: 6 ( 0 %), untranslated: 10 ( 0%)
| |
| | |
| Date of last update: 2006-05-27
| |
| | |
| | |
| '''Irish''': ga.po
| |
| | |
| translated: 14 ( '''0%''')
| |
| | |
| fuzzy: 719 ( 33 %), untranslated: 1409 ( 65%)
| |
| | |
| Date of last update: 2000-08-24
| |
| | |
| | |
| '''Galician''': gl.po
| |
| | |
| translated: 82 ( '''3%''')
| |
| | |
| fuzzy: 963 ( 44 %), untranslated: 1097 ( 51%)
| |
| | |
| Date of last update: 2001-11-10
| |
| | |
| | |
| '''Hungarian''': hu.po
| |
| | |
| translated: 1564 ( '''73%''')
| |
| | |
| fuzzy: 327 ( 15 %), untranslated: 251 ( 11%)
| |
| | |
| Date of last update: 2006-05-29
| |
| | |
| | |
| '''Italian''': it.po
| |
| | |
| translated: 2008 ( '''93%''')
| |
| | |
| fuzzy: 65 ( 3 %), untranslated: 69 ( 3%)
| |
| | |
| Date of last update: 2006-05-15
| |
| | |
| | |
| '''Japanese''': ja.po
| |
| | |
| translated: 1294 ( '''60%''')
| |
| | |
| fuzzy: 423 ( 19 %), untranslated: 425 ( 19%)
| |
| | |
| Date of last update: 2005-11-16
| |
| | |
| | |
| '''Korean''': ko.po
| |
| | |
| translated: 180 ( '''8%''')
| |
| | |
| fuzzy: 18 ( 0 %), untranslated: 1944 ( 90%)
| |
| | |
| Date of last update: 2006-04-10
| |
| | |
| | |
| '''Lithuanian''': lt.po
| |
| | |
| translated: 1774 ( '''82%''')
| |
| | |
| fuzzy: 30 ( 1 %), untranslated: 338 ( 15%)
| |
| | |
| Date of last update: 2006-05-02
| |
| | |
| | |
| '''mk.po'''
| |
| | |
| translated: 0 ( '''0%''')
| |
| | |
| fuzzy: 606 ( 28 %), untranslated: 1536 ( 71%)
| |
| | |
| Date of last update: 2003-06-15
| |
| | |
| | |
| '''Norwegian/bokmål dialect''': nb.po
| |
| | |
| translated: 144 ( '''6%''')
| |
| | |
| fuzzy: 916 ( 42 %), untranslated: 1082 ( 50%)
| |
| | |
| Date of last update: 2003-01-25
| |
| | |
| | |
| '''Dutch: nl.po'''
| |
| | |
| translated: 1484 ( '''69%''')
| |
| | |
| fuzzy: 387 ( 18 %), untranslated: 271 ( 12%)
| |
| | |
| Date of last update: 2005-11-07
| |
| | |
| | |
| '''Norwegian/Nynorsk''': nn.po
| |
| | |
| translated: 1376 ( '''64%''')
| |
| | |
| fuzzy: 410 ( 19 %), untranslated: 356 ( 16%)
| |
| | |
| Date of last update: 2005-07-14
| |
| | |
| | |
| '''Punjabi''': pa.po
| |
| | |
| translated: 912 ( '''42%''')
| |
| | |
| fuzzy: 349 ( 16 %), untranslated: 881 ( 41%)
| |
| | |
| Date of last update: 2005-09-11
| |
| | |
| | |
| '''Polish''': pl.po
| |
| | |
| translated: 1503 ( '''70%''')
| |
| | |
| fuzzy: 374 ( 17 %), untranslated: 265 ( 12%)
| |
| | |
| Date of last update: 2005-10-29
| |
| | |
| | |
| '''Portuguese''': pt.po
| |
| | |
| translated: 183 ( '''8%''')
| |
| | |
| fuzzy: 1004 ( 46 %), untranslated: 955 ( 44%)
| |
| | |
| Date of last update: 2003-07-28
| |
| | |
| | |
| '''Portuguese/Brazillian''': pt_BR.po
| |
| | |
| translated: 1546 ( '''72%''')
| |
| | |
| fuzzy: 349 ( 16 %), untranslated: 247 ( 11%)
| |
| | |
| Date of last update: 2006-04-27
| |
| | |
| | |
| '''Russian''': ru.po
| |
| | |
| translated: 1542 ( '''71%''')
| |
| | |
| fuzzy: 339 ( 15 %), untranslated: 261 ( 12%)
| |
| | |
| Date of last update: 2005-11-08
| |
| | |
| | |
| '''Slovak''': sk.po
| |
| | |
| translated: 845 ( '''39%''')
| |
| | |
| fuzzy: 659 ( 30 %), untranslated: 638 ( 29%)
| |
| | |
| Date of last update: 2005-02-13
| |
| | |
| | |
| '''Slovenian''': sl.po
| |
| | |
| translated: 2055 ( '''95%''')
| |
| | |
| fuzzy: 27 ( 1 %), untranslated: 60 ( 2%)
| |
| | |
| Date of last update: 2006-05-12
| |
| | |
| | |
| '''Serbian''': sr.po
| |
| | |
| translated: 1359 ( '''63%''')
| |
| | |
| fuzzy: 414 ( 19 %), untranslated: 369 ( 17%)
| |
| | |
| Date of last update: 2005-07-08
| |
| | |
| | |
| '''Serbian/Latine''': sr@Latn.po
| |
| | |
| translated: 1359 ( '''63%''')
| |
| | |
| fuzzy: 414 ( 19 %), untranslated: 369 ( 17%)
| |
| | |
| Date of last update: 2005-07-08
| |
| | |
| | |
| '''Swedish''': sv.po
| |
| | |
| translated: 410 ( '''19%''')
| |
| | |
| fuzzy: 848 ( 39 %), untranslated: 884 ( 41%)
| |
| | |
| Date of last update: 2005-10-08
| |
| | |
| | |
| '''Turkish''': tr.po
| |
| | |
| translated: 907 ( '''42%''')
| |
| | |
| fuzzy: 567 ( 26 %), untranslated: 668 ( 31%)
| |
| | |
| Date of last update: 2005-11-26
| |
| | |
| | |
| '''Ukrainian''': uk.po
| |
| | |
| translated: 1518 ( '''70%''')
| |
| | |
| fuzzy: 371 ( 17 %), untranslated: 253 ( 11%)
| |
| | |
| Date of last update: 2005-10-21
| |
| | |
| | |
| '''Chinese/Simplified''': zh_CN.po
| |
| | |
| translated: 2134 ( '''99%''')
| |
|
| |
| | |
| fuzzy: 3 ( 0 %), untranslated: 5 ( 0%)
| |
| | |
| Date of last update: 2006-05-28
| |
| | |
| | |
| '''Chinese/Traditional''': zh_TW.po
| |
| | |
| translated: 1550 ( '''72 %''')
| |
| | |
| fuzzy: 340 ( 15 %), untranslated: 252 ( 11%)
| |
| | |
| Date of last update: 2006-03-24
| |
| | |
| == Tutorials ==
| |
| | |
| * Basic: ca, de, en, es, fr, ja, nn, ru, sl
| |
| * Shapes: ca, en, es, fr, ja, sl
| |
| * Advanced: ca, en, es, fr, ja, sl
| |
| * Tracing: ca, de, en, es, fr, sl
| |
| * Calligraphy: ca, en, es, fr, sl
| |
| * Elements of design: en, es, fr, sl
| |
| * Tips and tricks: de, en, es, fr, sl
| |
| | |
| | |
| == Keys (shortcuts) ==
| |
| Already available in svn :
| |
| * en
| |
| * fr
| |
| * sl
| |
| | |
| | |
| == Windows installer ==
| |
| | |
| Already available in svn :
| |
| * czech.nsh
| |
| * english.nsh
| |
| * german.nsh
| |
| * italian.nsh
| |
| | |
| == Wiki translation ==
| |
| | |
| == Website ==
| |
| | |
| == News ==
| |
Introduction
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 software, which implies that software developpers/contributors are generaly users. It also implies that the translation efforts are also user oriented, with a strong focus on interface, user documentation and website.
Guidelines/workflow
- Contact to a local translation group, to get support and help on your language. Rather than working alone, you should work with an experienced translation team for your language. Thus you will benefit from their knowledge, as well as being able to communicate with them on your own mother tongue. Moreover, translation teams use to have style guidelines and a standarized vocabulary for technical terms that you should be aware of. There may be many communities working on translations for your own language, but a good start point is subscribing to your local GNOME translation team or KDE translation team.
- 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 svn repository web interface. Besides getting files from web interface, you can obtain the full repository; instructions on how to do this are found here. 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 Sourceforge.net account to commit patches to Inkscape's patch tracker. Before sending a file, remember to check that the file 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
Best case for a good translation : translate from English to your mother tongue.
Test the behavior of the interface before starting translation
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, ordered by priority.
These tasks, rather than being for hackers only, can be achieved by most software enthusiasts, whether they have a technological background or just plain users. The main requirement is the wish to provide support for Inkscape on your language: the technology required for do that has been developed in a simple approach, and it involves mainly text files and applications used to verify its syntax. Supporting applications exists to make this tasks even 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 [InterfaceTranslation] 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.
See [Document Translation] page for detailed information on translating tutorials.
Keyboard and mouse shortcuts
Inkscape is proud of having keyboard and mouse shortcuts for almost any funtionality. Those shotcuts 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.
See [Document Translation] page for detailed information on translating shortcuts.
Windows installer
High value for users, even if the installation process of Inkscape is quite simple, translating the Windows installer helps a lot potential users feeling good with Inkscape.
See [Interface Translation] page for detailed information on translating Windows installer.
Templates
The default template of Inkscape document can be localized to make the localization consistent. Localized can be size of the default document and also the name of default layer.
See [InterfaceTranslation] page for detailed information on default document's template.
Man pages
The man pages consist in a standard user documentation, available from the command line on Unix systems simply type "man inkscape" from the prompt of a command window).
Some distributions also generate a browsable (html) man page, accessible from dedicated help shortcut.
The man page of Inkscape provides some insightful information about the software, aspecially foused on operations that do not require GUI (example: export to png from the command line, or extract one object from a svg file).
See [DocumentTranslation] page for detailed information on translating man pages.
Release notes
Translating release notes helps giving a lot of visibility to Inkscape
- give a general overview of the possibilities of the software to potential users
- can be used for local marketing (local Free Software/Linuw/Graphics oriented web sites, articles in fanzines, e-magazines and even magazines...)
See [WebSiteTranslation] page for detailed information on translating release notes.
User manual
Some members of the Inkscape community are also focusing on an [user manual]. This document can be read as a reference document for advanced users and as a good introduction to the functionalities of Inkscape by everyone.
See [DocumentTranslation] page for detailed information on translating the user manual.
Web pages, News and Wiki
English is generaly the exchange-tongue of developppers, and developper/user documentation is mainly written in English.
Translation efforts should be first oriented on user documentation.
You can take a look at the [WebSiteTranslation] page for detailed information about how to translate the web content of Inkscape
See [WebSiteTranslation] page for detailed information on translating the web site, news and wiki.
See the [main wiki page of Inkscape] to get some examples (Spanish and German) of the translation of this wiki
Others
Text files found in the inkscape directory
...
Status
See this [dedicated page]