Difference between revisions of "Translating with Pootle"

From Creative Commons
Jump to: navigation, search
 
(75 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Category:Developer]]
+
Creative Commons uses the online tool [http://translate.sourceforge.net/wiki/pootle/index Pootle] at [http://translate.creativecommons.org/ translate.creativecommons.org] to manage translations of our software projects. (To translate pages on this wiki, see [[CC Wiki:Translate]].)
[[Category:Opensource]]
 
[[Category:I18n]]
 
  
Creative Commons uses the online tool [http://translate.sourceforge.net/wiki/pootle Pootle] to manage translations of our tools.  The Creative Commons installation of Pootle is maintained at http://translate.creativecommons.org.  This page describes how to Applications currently managed by '''translate.creativecommons.org''' are:
+
Applications currently managed by '''translate.creativecommons.org''' are:
  
 +
* license engine and deeds
 +
* [http://search.creativecommons.org search.creativecommons.org]
 
* [[CcPublisher|ccPublisher]]
 
* [[CcPublisher|ccPublisher]]
 
* [[CcHost|ccHost]]
 
* [[CcHost|ccHost]]
  
== Getting Started ==
+
= Tutorials =
 +
 
 +
There are three Pootle tutorials you can watch and read:
 +
 
 +
# [[Translating with Pootle/Setting up your account|Setting up your account]]
 +
# [[Translating with Pootle/Making translations and suggestions|Making translations and suggestions]]
 +
# [[Translating with Pootle/Admins: managing suggestions and previewing|Managing suggestions and previewing at staging]]
  
Before you can translate an application you need to create an account.  Go to http://translate.creativecommons.org and click the '''Register''' link in the right-hand column.  Enter your username, password, full name and email address and click '''Register Account.'''  Pootle will send an activation code to the email address you specify.  Return to translate.creativecommons.org and instead of '''Register''' click the '''Activate''' link on the right side.  Enter your username and activation code and click '''Login'''.  Your account is now activated.
+
= Other information =
  
== Editing a Translation ==
+
== Getting Help ==
  
When you log into Pootle you will see a list of available projects.
+
If you have questions about using Pootle or about the translation process, you can ask in the [[IRC|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.
  
[[Image:Project_list.png|frame|Project list displayed after logging into Pootle.]]
+
== Administering translations ==
  
Click on the project you're interested in working on and a list of available languages will be displayed.
+
* [[Translating with Pootle/Administration]]
  
[[Image:Project_lang_list.png|frame|List of available languages for the selected project.]]
+
== How to handle ${} or %() strings ==
  
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.  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, so each is listed, along with links for translating them.
+
When you see "${license_name}" or "%(license_name)s" 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.
  
[[Image:Project_language_details.png|frame|Translation details and links for the project language.]]
+
As a result, '''DO NOT''':
  
If you want to edit existing strings, you can click the '''Translate All''' link. Clicking '''Quick Translate''' will jump to the first non-translated string.
+
* 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}$")
 +
* If the text uses the %(), do not remove the trailing character after the close of the parenthesis (i.e. the 's' in "%(license_name)s")
  
[[Image:Quick_translate.png|frame|Quick translating untranslated strings.]]
+
== Whitespace Characters ==
  
You can translate the string in the text box next to the English text, and then click '''Submit''' to save your translation and move to the next untranslated stringIf you do not want to translate that string, just click '''Skip''' to move to the next untranslated string.
+
Sometimes you'll see <code>\t</code> or <code>\n</code> in stringsThese are left-over from the source files and can be safely omitted.
  
== Adding a Language ==
+
== Wiki Links ==
  
Languages currently need to be assigned to projects by server administrators.  If you are interested in translating a project into a new language, email the project and language to software@creativecommons.orgIf you know the locale code, that's helpful but not required.
+
Some text contains links to the CC Wiki for more information (ie, issues surrounding fair use, public domain, etc).  If you would like to translate those pages in the CC Wiki, you may do so and substitute the link to the translated page in the translationSee [[CC Wiki:Translate]] for instructions on translating wiki pages.
  
== Getting Help ==
+
{{Translations
 +
| articles = Id:Translating with Pootle
 +
}}
  
If you have questions about using Pootle or about the translation process, you can ask in the [[IRC|IRC channel]], or on the [http://lists.berlios.de/mailman/listinfo/cctools-i18n cctools-i18n mailing list].
+
[[Category:Developer]]
 +
[[Category:Opensource]]
 +
[[Category:I18n]]

Latest revision as of 14:25, 29 April 2011

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 CC Wiki:Translate.)

Applications currently managed by translate.creativecommons.org are:

Tutorials

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

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

How to handle ${} or %() strings

When you see "${license_name}" or "%(license_name)s" 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}$")
  • If the text uses the %(), do not remove the trailing character after the close of the parenthesis (i.e. the 's' in "%(license_name)s")

Whitespace Characters

Sometimes you'll see \t or \n in strings. These are left-over from the source files and can be safely omitted.

Wiki Links

Some text contains links to the CC Wiki for more information (ie, issues surrounding fair use, public domain, etc). If you would like to translate those pages in the CC Wiki, you may do so and substitute the link to the translated page in the translation. See CC Wiki:Translate for instructions on translating wiki pages.