Difference between revisions of "Translating with Pootle"

From Creative Commons
Jump to: navigation, search
(Setting up your account: This content has moved)
(Making translations and suggestions: This content has moved)
Line 31: Line 31:
= Making translations and suggestions =
This section covers the steps needed to make basic use of the Pootle translation service once you have registered.
== Starting from the front page: Choosing what to translate ==
Be sure that you are logged in when you start translating.
When you load the Pootle front page, you will see a list of available projects and languages.
[[Image:Project_list.png|frame|Project list displayed after logging into Pootle.]]
Every table on the front page has a neat feature: Click on a column, and the table will be sorted by that column. For example, after one click on "Overall completion" in the projects table, we see:
[[Image:Sorted_projects_list.png|frame|Projects list sorted by overall completion]]
One more click would reverse the order of the sort.
You can approach the task of translating either by starting with the languages you want to translate into, or by starting with the project you wish to translate.
=== The project page ===
We'll start by clicking on the ''cc_org'' project. Pootle presents us with the list of available languages for the project.
[[Image:Project_lang_list.png|frame|List of available languages for the cc_org project.]]
Click on the language you would like to work on translating. If you do not see the language you want to work on listed, see the instructions below on adding a new language.
=== Permissions ===
Note that by default, all you can do is make suggestions. If you want to be able to contribute translations without having someone else approve them, or if you want the ability to grant those privileges to tohers, please email us at webmaster@creativecommons.org.
=== The message catalogs page ===
When you click on the language you'll be shown a list of message catalogs (.po files) for the selected project.  (Most projects have a single message catalog; [[CcPublisher|ccPublisher]] has two; in that project, each is listed, along with links for translating them.)
[[Image:Project_language_details.png|frame|Translation details and links for the project language.]]
=== The translation screen ===
If you want to edit or view all strings, you can simply click on the .po file you wish to edit. If you wish to view only the untranslated strings, click the link showing how many words are not yet translated. For this demonstration, we will review the untranslated strings.
[[Image:Quick_translate.png|frame|Quick translating untranslated strings.]]
You can double-click any entry to quickly modify it (but note that your alternative source language will not appear). An untranslated string will be marked with ''Add translation''. Once you have written a translation, you can ''Submit'' it (or ''suggest'' if you do not have translate privileges). The standard editing interface is always available from the ''Edit'' link on the right-hand side.
= Language administrator tasks =
= Language administrator tasks =

Revision as of 22:48, 13 April 2009

Creative Commons uses the online tool Pootle to manage translations of our software projects. NOTE: To translate pages on this wiki, see CcWiki:Translate.

The Creative Commons installation of Pootle is maintained at http://translate.creativecommons.org. This page describes how to use Pootle to edit translations, make suggestions, and see what the changes look like.

Applications currently managed by translate.creativecommons.org are:

Video tutorials

There are three video tutorials available:

Be sure to select the one you want to watch.

Language administrator tasks

There are a few things that only administrators of the language can do: accepting suggestions as translations, and committing translations to see how they look at staging.creativecommons.org.

Accepting suggestions

Handling suggestions in Pootle is very easy. If on in the translation screen you see a message reading, View Suggestions, you can click it to show the suggestions that have been made as well as the name of the user who made the suggestion.

The View Suggestions option available next to a message.

If you want to act on those suggestions, click the Edit link at the end of the row. This will bring you to the full edit screen with that message selected.

The edit screen with a suggestion visible.

You can click on the green check-mark or the red X; they will accept or reject the suggestion respectively. If you want to accept a modified version of the suggestion, you can click the green check-mark to accept the suggestion and then edit it in the translation field. Be sure to hit submit afterwards.

Creative Commons' "Staging" website

We run an experimental clone of the Creative Commons website at http://staging.creativecommons.org/. The cc_org translation catalog is made available in near-real-time in two places.

For both of these, appending ?lang=no lets you see the Norwegian translation; that should work for any short language code.

Committing translations

Language editors can use the commit facility in Pootle to permanently store their changes. Each commit is a permanent snapshot of the PO file. In addition, we only update staging.creativecommons.org once you commit.

As a result, the commit feature is very useful as as "preview" feature. To use it, you must have the commit privilege to a language in Pootle.

Start at the message catalogs page, as seen below:

The message catalogs page with Show Editing Functions highlighted

Follow the link to 'Show Editing Functions, and you arrive at a page like this:

The editing functions page

Click on "Commit," and after a somewhat substantial wait, you will see a message indicating that some files were committed. (If there are no changes, then Pootle will not actually perform a commit.) You can then expect that staging.creativecommons.org is up-to-date with respect to the language you are working on.

Pushing to the live site

WHen you are happy with your changes as they appear on staging.creativecommons.org, email webmaster@creativecommons.org to request that we update the main creativecommons.org website with your translations. You should expect a response saying it's done within a couple of work days at the longest.

Granting permissions

As a language administrator, you can grant privileges to other translators who have shown their ability to provide good-quality text. To do that,

Other information

Getting Help

If you have questions about using Pootle or about the translation process, you can ask in the IRC channel, or by sending an email to webmaster@creativecommons.org. If you are a CC affiliate on the CCi mailing list, you can use that instead.

Administering translations

Using suggestions

  •  ?

How to handle ${} strings

When you see ${license_name} in a string, that indicates a substitution (for the real license name). These are placeholders that the translation machinery uses; if you modify this placeholder, the real license name will never be substituted into your string.

As a result, DO NOT:

  • Translate the text ("license_name") into your own language
  • Remove the text
  • Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")

New page contents

Creative Commons uses the online tool Pootle at translate.creativecommons.org to manage translations of our software projects. (To translate pages on this wiki, see CcWiki:Translate.)

Applications currently managed by translate.creativecommons.org are:

There are three Pootle tutorials you can watch and read:

  1. Setting up your account
  2. Making translations and suggestions
  3. Managing suggestions and previewing at staging