Pootle User Guide

Pootle User Guide for Translators

Localized documents

JapaneseTranslation - 日本語で読む

Registration and login

Register in Pootle (http://www.sunvirtuallab.com:32300/register.html)

Fill in your username, password and a valid e-mail account, Click 'Register Account' button and an activation code will be sent to the e-mail address you've provided.

Activate account

When you receive the activation code and login details by e-mail go to the activation page and fill them in. Click 'Activate Account' button and you can login Pootle.

Setting user option

If you login for the first time, you have to configure your user option.

Click on 'Change options' in 'My account' page which has a link on the right upper side.
Select desired projects and languages from the lists, then save changes. You can select mutiple projects and languages.

Once you set the option, you will be presented with your user page which includes links to your selected languages and projects.

Searching files

There are two ways to reach the files for translation.

Once your user page is set up, you can reach the files directly through the links in it.
Another way to find the file you wish to translate is through the the main page. The main page displays two categories - Languages and Projects. Choosing a language will give you the list of projects available for translation into this language; choosing a project will give you the list of languages to which it can be translated. Once you have choose both the project and the language, you'll be presented with the files available for translation.

When you get the translation page, you'll see a two-column table, with the strings to be translated on the left, and the current translation on the right. The current edited entry appears as a text box with the options 'Skip' and 'Suggest' or 'Submit' below it. Naturally you can enter text in the text box and submit it or skip to the next entry.

If you want to jump to another entry, you can get there by selecting the row you want. You can see the 'Edit' link next to the column of the current translation.

Translating with Pootle

Each file available for translation is accessible in two ways - 'Quick Translate' and 'Translate All'. 'Quick Translate' shows only the fuzzy and untranslated entries, while 'Translate All' shows all the entries in the file regardless of translated or not.

Select the project you want.
Click on 'Show Editing Functions'
You can see all the files listed.
Click on 'Quick Translate' or 'Translate All'.

If particular tasks are assigned to you, you can see the strings which are only assigned to you.

Select a project you want.
Click on 'Show Editing Functions' on the top navigation bar.
You can see the '(Quick) Translate My Strings' links of the files(or folders) which you're assigned are active.
Click on '(Quick) Translate My Strings' for the file(or folder) you want to work. It'll show you the strings which are assigned to you.

Note: Before starting to translate, you should make sure that you have proper permission of the projects. If you don't have permissions to submit, please ask your language lead to give you the permission.

Translating Off-line

If you want to translate off-line than on Pootle, you need to download files and upload translated files back to Pootle.

1. Download files
You can download files by file, folder or goal.

Select a project you want and go to the folder of files which you want to download.
Click on 'Show Editing Functions' on the top navigation bar.
If you want to download all the files in the current folder, Click on 'ZIP of folder' on the top navigation bar.
If you want to download a specific file in the current folder, click on the 'PO file' of the file, and and select 'save as other name'.
If you're working with a goal and want to download only the files of the goal, select 'Show Editing Functions-Show Goals'. Then you can see a goal list and 'ZIP of goal' link for each goal.

Note: You need to make sure that you have 'archive' permissionf for zip downloading. If you don't have proper permission, please ask your language lead to set the permission for you.

2. Work Off-line
You can work with a preferred editor. Most commonly used editors by community are:

Poedit
[www.omegat.org OmegaT]

3. Upload translated files
Once translation is completed, you need to upload your work to Pootle.
Important! During uploading, you should make sure that you're located in the right folder. If you upload a file to a wrong location, please contact Pootle admin.

There are two options of upload.

merge

Default option for user who has 'translate' privilege. Previously untranslated strings are submitted and the modifications to already translated strings are marked as 'suggestion', which means they can be submitted after review. If you make some modifications to existing translations (e.g., bug fixing), please make sure that they are reviewed and accepted by reviewer. Unless, the modifications won't be applied.

overwrite

User who has 'overwrite' privilege can select between overwrite and merge options. The uploaded file overwrite the existig file in Pootle.

Important! This option should be cafully used as it has possibility to lose existing data.

Pootle Userguide for Reviewers

How to review

Usually, translation lead has the right of review. However, a dedicated reviewer is also helpful for your project.
If you have 'review' privilege, you're able to accept or reject suggestions from translators.

Select a project (or even a specific folder or file) you want.
Click on 'Show Editing Functions'
Click on 'Show Suggestions'
It shows the strings with suggested translation one by one.
Review the suggested string and accpet or reject. If the suggestion is accepted, it is submitted. If it is rejected, existing translation has no change.
Click 'Skip' button for next string.

Please remember that pending translation can't be applied. You should accept if the suggestion is valid.

Pootle Userguide for Translation Leads

Registeration and getting administrator privilege

Register in Pootle (http://www.sunvirtuallab.com:32300/register.html)

Please refer to the user guide for translator.

Configure user option. - Please refer to the user guide for translator.
Send a mail to the L10n dev mailing list with the project and language which you'll manage. Then Pootle admin will give you an administrative privilege for the project.

Once all the work is done by Pootle admin, you can see 'Administrative' link beside your project in 'My account' page.

Setting permissions for users

To allow translators to participate in the project, you need to give them proper permissions. You should make sure that the user who you want to give a permission to has configured his/her user option selecting the project and language before your work.

Choose the 'Administrative' link of your project in 'My account' page.
Select the user who you want to add from a drop-down list and give him/her proper rights. Usually, you need to give 'Translate' right besides default values.

In the page, the current rights are listed as they are assigned. The user 'nobody' refers to any user that is not logged in (an anonymous, unidentified user). The user 'default' refers to the rights that all logged in users who are not specified.

For more detail about each permission, please see here.

Assigning work to translators

1. Cteate goals
For assignment, you need to create one of more goals first.

Select the project you have administrator privilege.
Click 'Show Editing Functions' on the menu list.
Click 'Show Goals'.
Create a goal by entering the name of a new goal on the right hand side of the page. After you click 'Add Goal' button, you can see the new goal is in the list.

If you already have goals to be used, you can skip the above steps.

2. Include selected files into the goal
All the files are under 'Not in a goal' by default. You need to move the files which you want to add to the new goal.

Select 'Not in a goal' - You can see all the files which aren't included in any goal.
Select the goal from the drop-down list for the files you want and click 'Set Goal' button.
Go back to the project page which lists all the goals and select the new goal.
Check if all the files that will be part of this goal are listed inside the page.

3. Add user to the project
You can add users who will work on the goal.

In the page of the goal, select user from the drop-down list and click 'Add User' button.

Note: You should make sure that the users you want to add has configured their language and project setting. Otherwise, you can't see the user from the list.

4. Assign work to translators
Now you can see the 'Assign To' button for each file in the goal. Each file can be assigned to one or more users.

Assigning a file to one user

Selecte an user and strings to be assigned from the drop-down lists and click 'Assign To' button.

Assigning a file to multiple users

Click on 'Select multiple' next to the user selection list for the file you want to assign. The dropdown list will now become a list where you can select multiple people (usually by holding down shift or control while selecting).

Selecte users and strings to be assigned from the drop-down lists and click 'Assign To' button.

To see all the assignments inside a goal, click on 'Show assigns' in the top navigation bar.