Translating with Pootle - Revision history

Hamilton Abreu at 14:25, 29 April 2011

2011-04-29T14:25:23Z

← Older revision		Revision as of 14:25, 29 April 2011
Line 1:		Line 1:
	~~{{Translations\|~~
	~~articles=Id:Translating with Pootle~~
	}}

	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]].)		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]].)

Line 48:		Line 44:

	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.		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.

			{{Translations
			\| articles = Id:Translating with Pootle
			}}

	[[Category:Developer]]		[[Category:Developer]]
	[[Category:Opensource]]		[[Category:Opensource]]
	[[Category:I18n]]		[[Category:I18n]]

Hamilton Abreu at 16:04, 18 April 2011

2011-04-18T16:04:40Z

← Older revision		Revision as of 16:04, 18 April 2011
Line 47:		Line 47:
	== Wiki Links ==		== 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 [[~~CcWiki~~:Translate]] for instructions on translating wiki pages.		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.

	[[Category:Developer]]		[[Category:Developer]]
	[[Category:Opensource]]		[[Category:Opensource]]
	[[Category:I18n]]		[[Category:I18n]]

Hamilton Abreu at 16:03, 18 April 2011

2011-04-18T16:03:10Z

← Older revision		Revision as of 16:03, 18 April 2011
Line 3:		Line 3:
	}}		}}

	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 [[~~CcWiki~~:Translate]].)		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]].)

	Applications currently managed by '''translate.creativecommons.org''' are:		Applications currently managed by '''translate.creativecommons.org''' are:

JED3: /* How to handle ${} or %() strings */

2010-06-02T17:35:51Z

How to handle ${} or %() strings

← Older revision		Revision as of 17:35, 2 June 2010
Line 30:		Line 30:
	* [[Translating with Pootle/Administration]]		* [[Translating with Pootle/Administration]]

	== How to handle ${} strings ==		== How to handle ${} or %() 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.		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''':		As a result, '''DO NOT''':
Line 39:		Line 39:
	* Remove the text		* Remove the text
	* Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")		* 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 ==		== Whitespace Characters ==

Faido: /* Whitespace Characters */

2010-04-04T09:11:38Z

Whitespace Characters

← Older revision		Revision as of 09:11, 4 April 2010
Line 43:		Line 43:

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


	~~[[File:Bg-footer.jpg\|200px\|thumb\|left\|тест рус]]~~

	== Wiki Links ==		== Wiki Links ==

Faido: /* Whitespace Characters */

2010-04-04T09:11:13Z

Whitespace Characters

← Older revision		Revision as of 09:11, 4 April 2010
Line 43:		Line 43:

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


			[[File:Bg-footer.jpg\|200px\|thumb\|left\|тест рус]]

	== Wiki Links ==		== Wiki Links ==

Nathan Yergler: /* Other information */

2009-11-16T18:26:59Z

Other information

← Older revision		Revision as of 18:26, 16 November 2009
Line 39:		Line 39:
	* Remove the text		* Remove the text
	* Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")		* Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")

			== Whitespace Characters ==

			Sometimes you'll see <code>\t</code> or <code>\n</code> 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 [[CcWiki:Translate]] for instructions on translating wiki pages.

	[[Category:Developer]]		[[Category:Developer]]
	[[Category:Opensource]]		[[Category:Opensource]]
	[[Category:I18n]]		[[Category:I18n]]

Nathan Yergler at 15:31, 14 April 2009

2009-04-14T15:31:44Z

← Older revision		Revision as of 15:31, 14 April 2009
Line 1:		Line 1:
	~~[[Category:Developer]]~~		{{Translations\|
	~~[[Category:Opensource]]~~		articles=Id:Translating with Pootle
	~~[[Category:I18n]]~~		}}

	{{Translations\|
	articles=Id:Translating with Pootle
	}}


	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 [[CcWiki:Translate]].)		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 [[CcWiki:Translate]].)
Line 25:		Line 20:
	# [[Translating with Pootle/Admins: managing suggestions and previewing\|Managing suggestions and previewing at staging]]		# [[Translating with Pootle/Admins: managing suggestions and previewing\|Managing suggestions and previewing at staging]]

			= Other information =

	~~= Other information =~~
	== Getting Help ==		== Getting Help ==

Line 35:		Line 30:
	* [[Translating with Pootle/Administration]]		* [[Translating with Pootle/Administration]]

	=~~= Using suggestions ==~~		== How to handle ${} strings ==
	* ?

	= 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.		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.
Line 47:		Line 39:
	* Remove the text		* Remove the text
	* Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")		* Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")

			[[Category:Developer]]
			[[Category:Opensource]]
			[[Category:I18n]]

Paulproteus at 22:49, 13 April 2009

2009-04-13T22:49:12Z

@@ Line 8: / Line 8: @@
-Creative Commons uses the online tool [http://translate.sourceforge.net/wiki/pootle/index Pootle] to manage translations of our software projects. NOTE: To translate pages on this wiki, see [[CcWiki:Translate]].
+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 [[CcWiki:Translate]].)
 Applications currently managed by '''translate.creativecommons.org''' are:
@@ Line 19: / Line 17: @@
 * [[CcHost|ccHost]]
-= Video tutorials =
+= Tutorials =
@@ Line 56: / Line 47: @@
 * Remove the text
 * Reverse the order of characters because you have a right-to-left language (ie, "{license_name}$")

Paulproteus: /* Language administrator tasks */ This content has moved

2009-04-13T22:48:13Z

Language administrator tasks: This content has moved

← Older revision		Revision as of 22:48, 13 April 2009
Line 33:		Line 33:


	~~= 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.

	~~[[Image:Pootle_view_suggestions_dropped_down.png\|frame\|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.~~

	~~[[Image:Pootle_edit_screen_with_suggestion.png\|frame\|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.~~

	* The staging license chooser at [http://staging.creativecommons.org/license http://creativecommons.org/license/] allows you to preview questions users see when they choose a license.
	* The staging deeds at, for example, [http://staging.creativecommons.org/licenses/by-sa/3.0/no/ http://staging.creativecommons.org/licenses/by-sa/3.0/no/] show the localized versions of the human-readable license deeds.

	~~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:~~

	~~[[Image:Pootle_show_editing_functions.png\|frame\|The message catalogs page with ''Show Editing Functions'' highlighted]]~~

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

	~~[[Image:Pootle_editing_functions.png\|frame\|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 =		= Other information =