Pootle crash course
From LXDE.org
Contents |
[edit] Pootle, the basics
Pootle (PO-based Online Translation / Localization Engine) is an easy to use and fast way to get translations done in the GNU Get Text environment. LXDE uses these PO files for localization of the user interface. The official web page is http://translate.sourceforge.net, it holds all kind of documentation about the projects involved.
[edit] pootle.lxde.bsnet.se
The hardware is donated by Blekinge student union (https://www.bthstudent.se), Blekinge Institute of Technology (http://www.bth.se) and the Internet connection is provided by the Blekinge student network (http://www.bsnet.se). The machine is supported by the student union infrastructure team. Big thanks to all involved!
[edit] Crash course
This guide is not intended to be a complete lesson in all parts and features of Pootle. It is here to make you going with the interface and start the translation effort.
[edit] Prerequisits
0. Point a web browser to http://pootle.lxde.bsnet.se.
1. Check that your language exists, otherwise contact the administrator(s) (see below)
2. Create an account and make sure it is activated and you can login.
3. Get proper priviliges to "your" language. Prepare and execute:
- Click My Account
- Click Settings
- Select your language(s) in the multi select box, click save changes at the bottom of the page.
- Select LXDE in My Projects, click Save changes at the bottom of the page.
- Contact an administrator to get added to the language. There must be at least one "maintainer" for each language to submit the translations.
4. All set, read on for the real stuff.
[edit] The workflow
This is the some what illustrated guide to get started doing translations via http://pootle.lxde.bsnet.se.
[edit] Get an account
At the top right corner, click "Register" and fill the form out. Wait for the activation e-mail and click the link to activate your account. Get privliges (as stated above), then continue on in this guide.
[edit] LXDE project
At the main page you could either choose "LXDE" under the projects menu and then your language. Or you choose language and then the LXDE project. Either will end you up in the same view.
The project overview, choose your language:
An example of a started but not completed translation effort (this is for Finnish).
- Name - The name of the file
- Progress - Graphic representation of the progress. Green for done, purple for strings needing review and red for empty strings (gpicview.po is a good example in the picture above).
- Summary - Number of words that needs to be checked to complete the translation.
- Total Words - A sum of the number of words in the file.
[edit] Edit mode
Click the filename to start edit the translation of the file.
Click the number next to a string to start translate it.
Editing a string marked as Fuzzy:
Editing a string marked as Translated:
Editing a string marked as Untranslated:
- To send the translation to the repository click the button marked Submit (it only shows if you have privileges in the current language).
- The back and skip buttons will jump to the previous/next translatable string.
- Mark the checkbox next to Fuzzy to make the translation appear as "half done", these strings will NOT be used when the program runs at the users' environment. This is a major issue, a translation effort is not complete if any fuzzy strings are not cleared.
[edit] Shortcuts and useful side features
If you just want to grab the latest PO files go to the tab "Review", you could either get the individual files or a complete archive file with all files.
[edit] Who to contact
- Martin Bagge (brother@bsnet.se) is the main administrator of the Pootle server.
- Issues with the activation of accounts, and all other stuff is his first attention.
- brother@jabber.org for jabber/gtalk
- brother- in #lxde @ irc.oftc.org
- Martin is based in Lund, Sweden and thus follows CET (UTC+1).
- Christoph Wickert is an Pootle administrator and can add priviliges and do tasks via the web interface.
- Mario Behling (mb@lxde.org) is an Pootle administrator and can add priviliges and do tasks via the web interface.
- Mario is based in Singapore and follows SST (UTC+8)
- Og Maciel (ogmaciel@gnome.org) is an Pootle administrator and can add priviliges and do tasks via the web interface.
- Og is based in the USA and follows ET (UTC-5)
- The translation mailing list (translation@mailinglist.lxde.org).
- The mailing list can be used for all issues with the Pootle, if you have generic how do I do this or that it is always a good idea to post it to the mailing list for others to see. Special cases of issues listed above are welcome at the list too but could be directed to the apropriate person directly.
- The IRC channel #lxde at irc.oftc.net
- As always IRC is a good source for help. Be patitient, the correct people is not always at hand to answer your question.
