Pootle

Contact: Xavier Alvarez —Rafael Ortiz, Alfonsodg IRC #olpc-pootle, #olpc-content

UPDATE

The test has gone forward and we are in the process of establishing the workflow to make it the Localization (L10N) platform of the XO.

WANTED

Volunteers both for translating and coordinating. If interested sign-up as a volunteer!

Some ways to find the translate server:

• dev.laptop.org/translate
• solar.laptop.org, port 5080 (old pootle server)

These are the notes taken and rough sketches for the processes involved in the localization effort in order to use Pootle as a more liberal L10n platform.

There are several scenarios that depend on the roles and their associated responsibilities (ie: translators, coders, administrators, etc). Below we outline the two most important ones from the POV of the translators that we could classify as either the opportunistic translator (fixing a typo or translating a few missing strings) and a registered translator (that is somehow more committed with the whole l10n reality).

If we consider that in the ultimate case children will be dealing with code (thus with gettext), we want things and processes to be as simple and straight forward as possible, so that in the end anybody, including children, will be able to translate or at least localize content to some degree. With this in mind, we aim for an environment that will:

• allow anybody to make suggestions,
• allow registered and trusted users to review and make translations, and
• administrators to commit.

i18n & L10n

Most people will argue that localization (L10n / l10n) concerns and issues should be tackled way before coding is finished, and quite a few will categorically say that it will be too late by then. Avoiding the philosophical and formal aspects, and taking a more pragmatic approach, L10n is usually an afterthought and internationalization (i18n) an annoying prerequisite... that has to be done.

In the context of the OLPC XO software and activities, and for practical purposes will avoid the debate on exactly where does L10n meets the code and start from the point where the output of i18n is used as the input for the l10n process. In other words, we'll elaborate based on the simplistic model that goes along the line:

1. programmer uses gettext function calls around human readable language in the source code
2. generate POT (gettext Portable Object Template) from the source code (output of the i18n process)
3. generate PO (gettext Portable Object) based on POT
4. translate / populate the PO with locale specific content
5. generate the final PO (or MO) (gettext Machine Object, output of the l10n process)
6. the executable code uses the PO (or MO) to comunicate with the final user

Developers

see Wikipedia's overview, Python internationalization,

the Translate project's guide, KDE i18n guide, GNU gettext manual and other sources

Developers willing to read a bit more about i18n & L10n, should review the links above. Regardless of how much or how good the i18n effort is, Pootle's needs one (or more) .POT files. Developers should be aware that localization is NOT just about instrumenting strings, as it includes plurals, numbers, dates, currencies, text-flow, scripts, fonts... and that it needs to be tested (ie: pseudolocalization testing) that needs to be considered in the overall development cycle. Also, if you want your activity to be properly localized, think about commenting your strings.

Translators

see L10n guide, translation guide, more links to come...

Being able to understand or grasp the intended meaning of some text in a language does not make you a translator, but "In the land of the blind, the one-eyed man is king." and all collaborations are welcome, although we also recommend reading some guidelines and documentation that may at least help you avoid some of the basic or typical errors and pitfalls.

Basic Scenarios

The basic idea is to allow the participation of anybody willing to put some effort while trying to keep a given quality of the translations.

• You can download the PO, so there's no forcing of the on-line UI (although you need the upload right to inject it back. So before going the offline road please coordinate with the admins.
• In the translation interface, fuzzy entries are grayed out and there's a gray vertical line separating the terms

Opportunistic translator

This user just wants to help. She/he doesn't want to get tangled in the administrative tasks. The only possible collaboration available is to suggest translations (which will be reviewed by users who have been granted the Review permission in a particular language).

After navigating to the olpc pootle server project: olpc language: spanish to finally reach a file (ie: TamTamSynthLab)

The interface will display a series of PO entries (one will have the focus—if it doesn't, you can double click the entry, or hovering over one will make an 'Edit' link appear that enables it—showing an entry field, and the following controls:

a picture is worth 1000 words

• Back & Skip buttons — jump to the previous or next entry
• Copy button — copies the original (msgid) value and continues in edit mode
• Suggest button — the actual collaboration of suggesting a translation
• Fuzzy checkbox — denotes that the suggested translation is/is not 100% trustworthy
• Special characters specific to the language (see #Languages)
• grow / shrink — allows growing and shrinking of the entry field (see #User options
• Translator comments field — comments either extracted from the source code, or added by other translators

The opportunistic translator then proceeds to navigate the file/s entering suggestions (to be processed later by the reviewers).

---

Admin notes

The Suggest permission must be granted on a per-language-project basis.

Each language may have specific or special characters that are may not be available in the user's keyboard, but can be provided for in the #Language specification.

Registered translator

Except for the mandatory pre-condition to register, which enables the extra [Submit] button when translating, the overall process is quite similar to that of the #Opportunistic translator. On the other hand, several user-specific permissions may apply (ie: off-line translation) and the GUI will adapt and offer them. Also, as a registered translator, you may be assigned specific files or strings to translate and/or review, allowing to better coordinate the overall effort.

---

Admin notes

In a collaborative and low-entry-barrier process, the administrator/s should enable the default user to actually translate — Navigation: admin | projects | project_name | language | permissions +Translate.

The default #user permissions apply to any registered user (unless they are overridden in a case-by-case approach). In the out-of-the-box install they include: View, Suggest, Archive & Compile PO files

User Scenarios

Register as a translator

1. Head towards the pootle site

The right link for Pootle seems to be this one so I don't know what to do with the previous line or how it got here. Yamaplos 22:12, 26 May 2008 (EDT)

1. Follows the register link where you fill the following fields: Username, Password, Confirm password, Full Name & Email Address, clicking on the [Register Account] button that will send a confirmation message to the email address with the activation code.
2. Following the link in the email will activate the newly created account. After which it will ask you to login and take you to your user page.

User options

In your user page there's a link to Change options that will allow you define some things:

• Projects you wish to participate (for the moment only olpc should be considered a valid option)
• Languages you wish to collaborate in. If you don't find your language, as an administrator you can associate it to the project (see #Languages) or as a mere mortal, you should contact an administrator.
• Other options like personal data & translation UI are present.

After configuring, don't forget to hit the [Save changes] button to make them effective, after which you can return to your #user page by means of the Home Page link.

User page

aka: 'Home', or 'My account' page.

You can reach your user page following the Home or My account link (depending on where you are) and it will show the appropriate links to the selected projects grouped by languages:

• The language link takes you to the statistics page per project
• the project-in-a-language link takes you the the statistics page displaying all its files

Advanced User Scenarios

Reviewer

A user who has been granted the Review permission, may accept or reject the suggestions made by users (who must have the Suggest permission). The way to do this is there another? is to go to a language/project combination (ie: spanish-olpc) and follow the Show Editing Functions. Here you have two alternatives: review the whole set of suggestions in the language-project set, or work on the suggestions present in a specific file (ie: all suggestions or TamTamSynthLab suggestions).

Once in the review UI, the reviewer has four options: Accept, Reject, Back or Skip which are self evident, but nevertheless will mention:

Accept	the reviewer translator accepts the suggestion and is registered
Reject	the suggested translation is rejected does that mean erased for the user or the file?
Back	goes to the previous suggestion assume a previous non-accepted/rejected suggestion
Skip	goes to the next available suggestion

In the case where multiple suggestions have been made, each one has its Accept & Reject buttons, while only the last will have the Back & Skip buttons.

Regardless of the multiplicity of suggestions, each suggested string will be diffed with the current string highlighting the changes. It also displays (if available) the name of the user that made the suggestion.

Editing functions

This section of the UI displays on a per-file basis several functionalities that depend on the permissions of the user:

Translate All	Goes to each string individually no matter what their state, across all files
Quick Translate	Only go to strings that are fuzzy or untranslated, across all files
Translate My Strings	As Translate All but only go to strings that are assigned to you.
Quick Translate My Strings	As with Quick Translate but only go to fuzzy and untranslated strings that are assigned to you.
PO file	used for off-line translators in order to retrieve the whole .PO file.
XLIFF file	used for off-line translators and interfaces to retrieve the whole file in said format. explore
Qt .ts file	explore
CSV file	explore

Show checks

For more information on the quality checks, see the documentation.

This functionality is a real helper (at least for latin scripts) as it runs a series of checks on the translations. So Pootle besides the obvious verification of translated+fuzzy+untranslated check, it verifies:

• simplecaps — for extra capital letters
• startcaps — initial capital letter matches between source & translation
• startpunc — if the original doesn't start with a letter, the translation probably shouldn't either
• unchanged — the source & translation are the same
• others — for a total of 44 checks. The most important being the critical tests: accelerators, escapes, newlines, nplurals, printf, tabs, variables and xmltags

Obviously, these checks, as any automated language process, are to be taken as a guidance and not as a rule. The check behaviour can be adjusted for a language, e.g. simplecaps could be disabled for a language that does not have a concept of capitals, doublequoting can be made aware of quote characters used in a language. These are changed by providing a lang module e.g. Japanese and French.

Zip of folder

Actually, any 'grouping' of PO files may be downloaded as a ZIP file if the user has the archive right. In other words, you can download the files in a language, goal, file, etc. It may be possible that Pootle extracts and recombines from several files in order to provide the zip with say 'My Strings' for offline work.

Administration

See Pootle/Administration

User permissions

See Pootle/Administration#User permissions

Sign-up

If interested in the Localization effort, please sign up below. Although we are focusing on Amharic, Arabic, English, Spanish, French, Hausa, Hindi, Igbo, Nepali, Portuguese, Romanian, Russian, Kinyarwanda, Thai, Urdu, & Yoruba and Give One Get One languages, any other language is welcome. If you are not subscribed to localization@lists.laptop.org we strongly suggest you do so. This is not consistent with http://dev.laptop.org/~sayamindu/teams.html

Role Name Comments [am] — Amharic language — አማርኛ OTR tegegne tefera Pootle: Teferra [ar] — Arabic language — عربي TR Khaled Hosny Pootle: khaled [ay] — Aymara — aymar aru A Yamandú Ploskonka Pootle: yamaplos [bg] — Bulgarian language — български OTRA Alexander Todorov Pootle: atodorov [bn] [bn-IN] — Bengali language — বাংলা OTRA Jamil Ahmed Pootle: jamil OTR Khandakar Mujahidul Islam Pootle: suzan OTR Mahay Alam Khan Pootle: mak [ca] — Catalan language — català Jaume Nualart Pootle: jaume [cs] — Czech language — česky TR Jakub Guttner Pootle: Kuba [de] — German language — deutsch O Adricnet Pootle: O Michael Reschke Pootle: [dz] — Dzongkha — ཇོང་ཁ none Pootle: [el] — Greek language — ελληνικά TRA Simos Xenitellis Pootle: simosx [en] — English language — english OTRA SJ Klein Pootle: sj [es] — Spanish language — español OTRA Xavier Alvarez Pootle: Xavi TRA Mauro Parra-Miranda Pootle: mauropm OTR Alexander Dupuy Pootle: Dupuy OTR Yamandú Ploskonka Pootle: yamaplos OTR Pilar Saenz Pootle: PilarSaenz [fa] — Persian — فارسی unknown Pootle: [fa-AF] — Dari — دری TRA Sohaib Obaidi Pootle: [fi] — Finnish language — suomi none Pootle: [ff] — Fula language — fulfulde unknown Pootle: [fr] — French language — français OTRA Samy Boutayeb Pootle: samybt TRA Dominique Eav Pootle: domeav OTR Pierre Métras Pootle: pierre TRA Lionel Laské Pootle: llaske OT Alexander Dupuy Pootle: Dupuy OT Yamandú Ploskonka Pootle: yamaplos [gl] — Galician language — galego none Pootle: [gu] — Gujarati language — ગુજરાતી none Pootle: [ha] — Hausa language — Hausa none Pootle: [hi] — Hindi language — हिन्दी OTR Shikhar Bhushan Pootle: shikhar OTRA Rahul Jain Pootle: rahulthewall3000 [ht] — Haitian Creole language — kreyòl ayisyen TA Edward MokuraiCherlin Pootle: mokurai TR Jude Augusma Pootle: jude O Alexander Dupuy Pootle: Dupuy TRA MasterChes Pootle: Masterches [ig] — Igbo language — igbo unknown Pootle: [is] — Icelandic language — íslenska O Steinninn Pootle: [it] — Italian language — italiano OTRA Carlo Falciola Pootle: carlo [ja] — Japanese language — 日本語 OTRA Yoshiaki Sonoda Pootle: Spiky OTR Taizo Shiozaki Pootle: Taizo1969 OTR Korakurider Pootle: Korakurider OTRA Takashi Yamamiya Pootle: Takashi OTR KIRYU Yasuo Pootle: Kiryu OTR Kazuhiro Abe Pootle: Abee [km] — Khmer language — ភាសាខ្មែរ A Edward Mokurai Cherlin Pootle: mokurai T Rit Lim Pootle: Lirit [ko] — Korean language — 한국어 O Cymacyma Pootle: [mk] — Macedonian language — македонски OTRA Arangel Angov Pootle: Arangel [ml] — Malayalam language — മലയാളം OTRA Ani Peter Pootle: anipeter [mn] — Mongolian language — монгол OTRA Enkhzul Gombodorj Pootle: Enkhzul O Cris Anderson Pootle: anderson [mr] — Marathi language — मराठी OTRA Swapnil Hajare Pootle: swapnil [ne] — Nepali language — नेपाली OTRA Prabhas Pokharel Pootle: prabhas OTR Anjali Lohani Pootle: anjali OTR Tsering Lama Sherpa Pootle: tlsherpa TRA Shankar Pokharel Pootle: shankar [nl] — Dutch language — nederlands OT Bastiaan Bakker Pootle: bastiaan [pa] — Punjabi language — ਪੰਜਾਬੀ unknown Pootle: [pl] — Polish language — polski OTRA Wiktor Idzikowski Pootle: idzikow OT Michal Hobot Pootle: ohm [ps] — Pashto language — پښتو TR Usman Mansour Pootle: usman1982 [pt] — Portuguese language — português unknown Pootle: [pt-BR] — Portuguese language — português do Brasil OTA Juliano Bittencourt Pootle: juliano OT Eduardo H. Silva Pootle: HoboPrimate OT Alexander Dupuy Pootle: Dupuy [qu] — Quechua language — runa simi unknown Pootle: [ro] — Romanian language — română AT Adi Roiban Pootle: adiroiban1 [ru] — Russian language — русский T Aleksey Bragin Pootle: fireball T Maxim Osipov Pootle: Maxim [rw] — Kinyarwanda language — kinyarwanda O Carine Umutesi Pootle: [sd] — Sindhi language — سنڌي none Pootle: [si] — Sinhala language — සිංහල unknown Pootle: [sl] — Slovenian language — slovenščina none Pootle: [sr] — Serbian language — српски O Goran Rakić Pootle: [sv] — Swedish language — svenska none Pootle: [te] — Telugu language — తెలుగు OTRA Satyanarayana Murthy Saladi Pootle: satya T Veeven Pootle: veeven [th] — Thai language — ไทย OT Manatsawin Hanmongkolchai Pootle: willwill [tr] — Turkish language — türkçe OTR Tom Hannen Pootle: tomhannen [ur] — Urdu language — اردو OT Farhan Khan Pootle: ??? OTRA Huda Sarfraz Pootle: Huda [vi] — Vietnamese language — tiếng việt none Pootle: [yo] — Yoruba language — yorùbá unknown Pootle: [zh-TW] — Chinese language — 繁體中文 OTRA Yuan Chao Pootle: YuanChao [zh-CN] — Chinese language — 中文 TA Yuan Chao Pootle: YuanChao TA Elly Liu Pootle: Elly Liu

Role key O-pportunistic if you would be willing to make suggestions only to the translations (ie: fixing typos or alternative wordings that would be reviewed) T-ranslator actually translate strings R-eviewer process suggestions made by opportunistic volunteers and overall checking of translated strings. A-dministrate a particular language (or a particular project in a given language). It involves reviewing and other tasks (like determining #user permissions, interfacing with d.l.o, etc). localization@lists.laptop.org subscription to this list is strongly recommended especially for possible administrators (even mandatory). Other roles should also consider joining it in order to keep track of eventual notifications and news.

See also

• Pootle User Guides — af, cs, de, en, es, eu, fa, fr.
• Administrator guide
• Site administrator guide
• http://wiki.creativecommons.org/Translating_with_Pootle
• http://www.ohloh.net/projects/3285?p=Pootle+and+Translate+Toolkit
• http://en.wikipedia.org/wiki/Pootle
• http://www.wordforge.org/drupal/en/projects/wordforge/tools/localegen — locale generator for OO (may give some ideas about what is not fixed)