Difference between revisions of "Translating with Pootle"

From Creative Commons
Jump to: navigation, search
 
(63 intermediate revisions by 8 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/index 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 use Pootle to edit translations.
 
  
 
Applications currently managed by '''translate.creativecommons.org''' are:
 
Applications currently managed by '''translate.creativecommons.org''' are:
Line 12: Line 8:
 
* [[CcHost|ccHost]]
 
* [[CcHost|ccHost]]
  
= First time setup =
+
= Tutorials =
  
New users of Pootle will have to create an account,
+
There are three Pootle tutorials you can watch and read:
  
== Creating an account ==
+
# [[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 '''Log in''' link in the upper right-hand corner.  Enter your desired username and password and click "Register." This will take you to the full registration page, which will ask you for your password again, your full name, and your email address.  Click "Register" once more, and Pootle will send an activation code to the email address you specified.  Follow the link to the activation page, and copy your activation code into the "Activation Code" box. Click "Activate Account", and your account is now activated.
+
= Other information =
  
Now you can log in by clicking the ''Log in'' button in the upper-right corner.
+
== Getting Help ==
  
== Adding a Language ==
+
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.
  
Languages currently need to be assigned to projects by server administrators.  If you are interested in translating a project into a new language, or adding a completely new language, email the project you're interested in and the language to webmaster@creativecommons.org.
+
== Administering translations ==
  
= Non-first-time use =
+
* [[Translating with Pootle/Administration]]
  
== Editing a Translation ==
+
== How to handle ${} or %() strings ==
  
When you log into Pootle you will see a list of available projects.
+
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_list.png|frame|Project list displayed after logging into Pootle.]]
+
As a result, '''DO NOT''':
  
Click on the project you're interested in working on and a list of available languages will be displayed.
+
* 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:Project_lang_list.png|frame|List of available languages for the selected project.]]
+
== Whitespace Characters ==
  
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 languageWhen 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.
+
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.
  
[[Image:Project_language_details.png|frame|Translation details and links for the project language.]]
+
== Wiki Links ==
  
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.
+
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.
  
[[Image:Quick_translate.png|frame|Quick translating untranslated strings.]]
+
{{Translations
 +
| articles = Id:Translating with Pootle
 +
}}
  
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 string.  If you do not want to translate that string, just click '''Skip''' to move to the next untranslated string.
+
[[Category:Developer]]
 
+
[[Category:Opensource]]
== Getting Help ==
+
[[Category:I18n]]
 
 
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].
 
 
 
== Administering translations ==
 
 
 
* [[Translating with Pootle/Administration]]
 
 
 
== Using suggestions ==
 
* ?
 

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.