-
Notifications
You must be signed in to change notification settings - Fork 172
Translator instructions
This page explains the translation process for the Hydrogen GUI and the Hydrogen Manual. These are 2 quite different things that require different approaches so make sure you read the info on this page carefullyIf you want to translate the manual/tutorial, skip the Gui translations part and continue reading at the end of this page. (info about the language codes can be found here : http://www.iana.org/assignments/language-subtag-registry)
IMPORTANT TIPS :
-
Make sure you run a git pull before you begin to translate !
-
If you are working with multiple translators on the same part (both working on the manual or gui) it is very important that you all agree on 'who does what'. eg translator A does chapter1 and B does chapter2 That way it will be easier to merge the file coming from A and the file from B during the commit. If only translator B has an git account he can help translator A to commit his changes.
The translations are made with a program called "linguist" which is part of QT development package (qt4-dev-tools on Ubuntu).
NOTE : to be able to see your translation of the GUI you must set your system 'locale' to your language. GNOME : System > Administration > Language Support KDE : System Settings > Regional & Accessibility > Country/Region? & Language
Steps needed to create a new translation (or update an old one..) :
-
install linguist and git
-
learn how to use linguist
-
get the hydrogen git sources
-
translate your .ts file
-
build Hydrogen and see how the translated gui looks
-
fix issues
-
mail your final .ts file to the devel mailing list or create a git pull request
-
enjoy the look of your name on the credits list :-)
In detail :
- install Linguist and git :
Linguist is a translation tool that is part of the QT development tools.
-
ubuntu : install via software center (search for 'qt4 Linguist')
-
debian based distro's : install via Synaptic (search for qt4-dev-tools) or in a terminal type apt-get install qt4-dev-tools
-
other distro's : search your package manager for QT4 Linguist
Git is a sourcecode management system that allows you to get code from the Hydrogen development server (and put code on it)
-
ubuntu : install via software center (search for 'git')
-
debian based distro's : install package git-core apt-get install git-core
-
other distro's : search your package manager for git
- learn how to use Linguist
The Linguist manual can be found here : general info : http://doc.qt.nokia.com/latest/linguist-manual.html
translator chapter : http://doc.qt.nokia.com/latest/linguist-translators.html
- get the latest sourcecode
it's best to create a working directory somewhere (doesn't really matter where), open a terminal and cd into that directory example :
$ mkdir /home/myname/workdir $ cd /home/myname/workdir now get the sourcecode :
$ git clone git://github.com/hydrogen-music/hydrogen.git This will create a directory called 'hydrogen' in the current dir and put all sourcecode in that directory (approx 13MB of files)
- translate your .ts file
goto /home/myname/workdir/hydrogen/data/i18n, and run the updatescript :
$ cd /home/myname/workdir/hydrogen/data/i18n $ ./updateTranslations.sh now open the .ts file in Linguist that you want to translate (hydrogen.it.ts for Italian, hydrogen.ru.ts for Russian ...) and start translating
- build Hydrogen from source
When you are done with your translation, or you want to see the intermediate result of all your hard labour you will need to build Hydrogen from source. Dont worry ! It's not that difficult and remember that you can always ask questions on the devel mailing list (and you will get an answer quickly from the famous hyper-fast-responding-developers!)
You can find more info about building here (linux) : http://trac.assembla.com/hydrogen/wiki/development:qt4compile and for mac here : http://trac.assembla.com/hydrogen/wiki/development:compileOSX
- fix issues
There is a chance that your translated strings are shorter or longer than the original English string. In some cases this can mess up the gui. If that is the case you should take a screenshot of the issue and mail it (+ an explanation of the problem) to the devel mailing list. Then we can see what the options are (change the text or the gui, or ...)
- mail the .ts file
Once you are happy with the result of your work (all strings have been translated + the complete gui looks good) you can mail your .ts file to the devel list. The file will be checked in and your work will be added to the next build !
If you are comfortable with git and github, create a git pull request.
Gui Translations status for 0.9.5 (updated 2011/07/29)
| row 1, cell 1 | row 1, cell 2 |
| row 2, cell 1 | row 2, cell 2 |
| hydrogen.cs.ts | 515/719 | 100% |
Gui Translations status for 0.9.6 (updated 2011/09/12)
------------------|-----------|----
hydrogen.cs.ts | [515/719] | 71%
hydrogen.de.ts | [502/719] | 69%
hydrogen.ca.ts | [554/555] | 99%
hydrogen.fr.ts | [682/719] | 94%
hydrogen.it.ts | [481/719] | 66%
hydrogen.nl.ts | [443/719] | 61%
hydrogen.pt_BR.ts | [1/719] | 0%
hydrogen.sv.ts | [1/719] | 0%
hydrogen.es.ts | [696/719] | 96%
hydrogen.hu_HU.ts | [1/719] | 0%
hydrogen.ja.ts | [1/719] | 0%
hydrogen.pl.ts | [363/719] | 50%
hydrogen.ru.ts | [675/719] | 93%
hydrogen.hr.ts | [513/719] | 71%
hydrogen.el.ts | [306/311] | 98%
------------------|-----------|----
Gui Translators (updated 2011/05/11)
| language | 0.9.4 translators | 0.9.5/6 translators |
| it | Alessandro Cominu & Journeyman | |
| es | Daniel Tonda C & Daryl O'Hara | Chema Martin & Daryl O'Hara |
| ru | Alexandre Prokoudine | Alexandre Prokoudine & Nitro |
| fr | Yan Morin | Olivier Humbert & DYP |
| pt_BR | - | |
| hu_HU | - | |
| pl | - | |
| nl | aikie & Pieter Van Isacker | Dave Stikkolorum |
| ja | - | |
| de | Simon Donike | |
| sv | - | |
| hr | Mario Kozjak | |
| ky | - | Ualmaz |
| cs | - | Adam Radimersky (Aidamos) |
| el | - | Nikos Papadopoylos |
The manual (and tutorial) uses a new format since it was rewritten for the 0.9.4 release. We're now using a PO-based translation system which is based on the docbook xml files.
Steps needed:
-
install the tools
-
get the latest sources via git
-
translate the .po file(s)
-
transform the docbook xml files into html
-
email the .po file to the hydrogen-devel mailing list.
In detail :
- install the tools You will need xmlto, po2xml, xml2po and the DocBook? XML DTD's. These are part of the following packages : xmlto poxml docbook-xml libxml2-utils. Instal via synaptic or command-line :
$ sudo apt-get install xmlto poxml docbook-xml libxml2-utils
-
get the latest git sources see the Gui section above (item 3)
-
translate the .po file First of all goto the doc directory and check if a .po file exists for your language :
$ cd /home/myname/workdir/hydrogen/data/doc $ ls *.po If you dont see a file called manual_XX.po (replace XX by your language code) you can create a .po-file for your language like this :
$ cp manual.pot manual_XX.po
(replace XX by your language code)
Now you can open your .po file in your favorite .po file editor (Kbabel, Gtranslator, PoEdit? to name just a few) and start translating (For the tutorial you need to work with the tutorial_XX.po files)
- execute "make" to transform the docbook xml files into html do this by executing this command :
$ make manual_XX.html
this will generate a html so you can see the result of your work
- email the *.po file to the hydrogen-devel mailing list.
See data/doc/README.DOCUMENTATION.txt for more info http://svn.assembla.com/svn/hydrogen/trunk/data/doc/README.DOCUMENTATION.txt