CKEditor 3.x/Developers Guide/Translating CKEditor - Revision history

Anna: /* Offline Translation */ Update to February 2013 look and feel

2013-02-27T16:45:13Z

‎Offline Translation: Update to February 2013 look and feel

Anna: /* Online Translation */ Note on keyboard shortcuts added

2013-02-27T16:26:17Z

‎Online Translation: Note on keyboard shortcuts added

Anna: /* Online Translation */ Typo corrected, outdated screenshot removed

2013-02-27T16:09:47Z

‎Online Translation: Typo corrected, outdated screenshot removed

Anna: /* Online Translation */ Update part 3

2013-02-27T15:30:45Z

‎Online Translation: Update part 3

Anna: /* Online Translation */ Update part 2

2013-02-27T14:18:19Z

‎Online Translation: Update part 2

Anna: Part 1 updated

2013-02-27T13:55:28Z

Part 1 updated

Anna: Minor clarification added

2011-11-28T07:56:50Z

Minor clarification added

Anna: Links updated, Troubleshooting link added

2011-11-24T13:15:39Z

Links updated, Troubleshooting link added

Anna: Internal links corrected

2011-11-22T14:38:01Z

Internal links corrected

Anna: TOC removed

2011-11-18T08:00:05Z

TOC removed

@@ Line 59: / Line 59: @@
 == Offline Translation ==
-If you want to translate offline, go to the language team page and choose a resource that you want to work on from the resources list. In the '''Translation Details''' pop-up that opens choose the '''Download for translation''' option.
+If you want to translate offline, go to the language team page and choose a resource that you want to work on from the resources list. In the resource pop-up that opens choose the '''Download for translation''' option.
 [[Image:Transifex_offline_translation_01.png|thumb|center|800px|Offline translation in Transifex]]
@@ Line 74: / Line 74: @@
-You can now open the file with your favorite <code>gettext</code> editor and add your translations. When you are done, go back to the resource's page on Transifex and upload the file by using the '''Upload file''' button. While the upload is in progress, a suitable notice will be displayed in your browser.
+You can now open the file with your favorite <code>gettext</code> editor and add your translations. When you are done, go back to the resource's page on Transifex and upload the file by using the '''Upload file''' option. While the upload is in progress, a suitable notice will be displayed in your browser.
-−
 When the upload is finished, your translations will be added to the project and the file lock will be released. If the lock is not released, it is recommended to remove it manually in order to make the file accessible to other team members.

@@ Line 43: / Line 43: @@
 Continue translating the language strings until you are done. You can use all the tools that are normally available in Transifex and described in the official documentation, like machine translate, copy source, history, spell checking, revert and so on.
 It is quite useful to check the '''Suggestions''' tab as it contains suggestions based on similar language strings from CKEditor resources. In this way you will be able to preserve consistency across the localization.
@@ Line 49: / Line 51: @@
-Wwhen you are not sure of the context where the translation is used, check the '''Details''' tab. It contains the '''Developer comment''' field with additional information explaining the language string context.
+When you are not sure of the context where the translation is used, check the '''Details''' tab. It contains the '''Developer comment''' field with additional information explaining the language string context.
 [[Image:Transifex_online_translation_details.png|thumb|center|800px|Details tab in Transifex]]

← Older revision		Revision as of 16:09, 27 February 2013
Line 54:		Line 54:


−	When you are done, you can simply exit the page finish your work.	+	When you are done, you can simply exit the page to finish your work. You can now go back to your language team page and choose another untranslated resource to work on.
−
−	~~[[Image:Transifex_online_translation_04.png\|thumb\|center\|800px\|Translation status in Transifex]]~~
−
−
−	You can now go back to your language team page and choose another untranslated resource to work on.

	== Offline Translation ==		== Offline Translation ==

← Older revision		Revision as of 15:30, 27 February 2013
Line 49:		Line 49:


−	~~When~~ you are ~~done~~, ~~click~~ the '''~~Save and Exit~~''' ~~button to finish your work~~. ~~You will be redirected to~~ the ~~resource page where~~ you ~~will be able to see~~ the ~~status of all translations of a given project resource~~.	+	Wwhen you are not sure of the context where the translation is used, check the '''Details''' tab. It contains the '''Developer comment''' field with additional information explaining the language string context.
		+
		+	[[Image:Transifex_online_translation_details.png\|thumb\|center\|800px\|Details tab in Transifex]]
		+
		+
		+	When you are done, you can simply exit the page finish your work.

	[[Image:Transifex_online_translation_04.png\|thumb\|center\|800px\|Translation status in Transifex]]		[[Image:Transifex_online_translation_04.png\|thumb\|center\|800px\|Translation status in Transifex]]

@@ Line 30: / Line 30: @@
 If you want to translate online, go to the language team page and choose a resource that you want to work on from the resources list. In the resource pop-up window that opens click the '''Translate now''' button.
-The online editor that will open shows you the list of language strings that need translating. By default only the untranslated strings are displayed, but you can change this setting by checking and unchecking the boxes in the top left-hand corner of the screen.
+The online editor that will open shows you the list of all language strings for a given resource, including the ones that have already been translated. You can change this setting by clicking the '''Untranslated''' and '''Unreviewed''' buttons above the editor text input field.
 [[Image:Transifex_online_translation_01.png|thumb|center|800px|Display options for resource translation in Transifex]]
-If you know more languages and having a translation to one of them would be useful to you, you can choose to display other translations alongside the source version by checking them in the More languages drop-down list.
+You are now ready to go. The left-hand side column displays the language strings in their original versions (for CKEditor &mdash; in English). When you choose a language string from the list, it will be shown in the top part of the text input area that contains the source string. The bottom gray part of the input area is where you should enter your translation.
 [[Image:Transifex_online_translation_02.png|thumb|center|800px|Source string and translation in Transifex]]
-The language strings in the '''Translation''' column are color-coded. A green left border means a translated entry, a red one &mdash; an untranslated entry and the blue one is a modified one.
+After a translation is entered and checked by you, click the '''Submit''' button (or use the ''Alt+Enter'' keyboard shortcut) to submit it. It will be added to CKEditor files and used automatically in the next build.
-Continue translating the language strings until you are done. You can use all the tools that are normally available in Transifex and described in the official documentation, like auto translate, copy source, history, spell checking and so on.
+Continue translating the language strings until you are done. You can use all the tools that are normally available in Transifex and described in the official documentation, like machine translate, copy source, history, spell checking, revert and so on.
-Transifex saves the translations automatically as you go from one language string to another. You will see the "Saving..." caption on the top of the page when you move forward.
+It is quite useful to check the '''Suggestions''' tab as it contains suggestions based on similar language strings from CKEditor resources. In this way you will be able to preserve consistency across the localization.
-[[Image:Transifex_online_translation_03.png|thumb|center|800px|Automatic translation saving in Transifex]]
+[[Image:Transifex_online_translation_suggestions.png|thumb|center|800px|Suggestions tab in Transifex]]

@@ Line 6: / Line 6: @@
-Pay attention to project resource statistics on the main team translation page. The '''Completion''' column shows you the completion status of a given resource in a percent value. When you hover over the completion bar, the number of translated and untranslated language strings will be displayed in a tooltip.
+Pay attention to project resource statistics on the main team translation page. The second column shows you the graphic and percentage representation of the completion status for a given resource. When you hover over the completion bar, the number of translated, untranslated and reviewed language strings will be displayed in a tooltip.
 <note>Please note that it is recommended to complete missing translations before attempting to correct the existing ones.
@@ Line 18: / Line 18: @@
 == Translating a Resource ==
-After you are accepted as a language team member, you can go to the team page and view the resources available for translation. Choose an incomplete translation that you want to start working on and check its statistics on the '''Translation Details''' pop-up that will open.
+After you are accepted as a language team member, you can go to the team page and view the resources available for translation. Choose an incomplete translation that you want to start working on and check its statistics on the pop-up window that will open.
 [[Image:Transifex_team_translation_details_03.png|frame|center|Translation details in Transifex]]
@@ Line 24: / Line 24: @@
 The translation process can be performed in two ways: online and offline.
-* [[CKEditor_3.x/Developers_Guide/Translating_CKEditor#Online_Translation|Online translation]] &ndash; uses the built-in Transifex editor (codenamed "Lotte") and lets you translate the strings in your browser, without the need to download or upload any files and even see the source file format. This is a recommended method, especially for the beginners.
+* [[CKEditor_3.x/Developers_Guide/Translating_CKEditor#Online_Translation|Online translation]] &ndash; uses the built-in Transifex editor (two versions are available) and lets you translate the strings in your browser, without the need to download or upload any files and even see the source file format. This is a recommended method, especially for the beginners.
 * [[CKEditor_3.x/Developers_Guide/Translating_CKEditor#Offline_Translation|Offline translation]] &ndash; requires downloading the language file to your local computer and uploading it back to Transifex when you are done. This method is only recommended for more experienced users.
 == Online Translation ==
-If you want to translate online, go to the language team page and choose a resource that you want to work on from the resources list. In the '''Translation Details''' pop-up that opens click the '''Translate now''' button.
+If you want to translate online, go to the language team page and choose a resource that you want to work on from the resources list. In the resource pop-up window that opens click the '''Translate now''' button.
-The online editor that will open ("Lotte") shows you the list of language strings that need translating. By default only the untranslated strings are displayed, but you can change this setting by checking and unchecking the boxes in the top left-hand corner of the screen.
+The online editor that will open shows you the list of language strings that need translating. By default only the untranslated strings are displayed, but you can change this setting by checking and unchecking the boxes in the top left-hand corner of the screen.
 [[Image:Transifex_online_translation_01.png|thumb|center|800px|Display options for resource translation in Transifex]]

← Older revision		Revision as of 07:56, 28 November 2011
Line 79:		Line 79:


−	When the upload is finished, your translations will be added to the project and the file lock will be released.	+	When the upload is finished, your translations will be added to the project and the file lock will be released. If the lock is not released, it is recommended to remove it manually in order to make the file accessible to other team members.

← Older revision		Revision as of 13:15, 24 November 2011
Line 14:		Line 14:
	When you choose a translation resource, a pop-up window with various options for a given resource will be displayed. Depending on your permissions (i.e. whether you are a team member) you will be able to download the translated version of the resource as well as the original language file, view the language strings online, see the resource status and, last but not least, start translating.		When you choose a translation resource, a pop-up window with various options for a given resource will be displayed. Depending on your permissions (i.e. whether you are a team member) you will be able to download the translated version of the resource as well as the original language file, view the language strings online, see the resource status and, last but not least, start translating.

−	<note>See the [[CKEditor_3.x/Developers_Guide/Localization~~#Translation_Tips\|Translation~~ Tips]] ~~section~~ for some important pointers for working on CKEditor translations.	+	<note>See the [[CKEditor_3.x/Developers_Guide/Localization_Tips\|Localization Tips]] article for some important pointers for working on CKEditor translations. The [[CKEditor_3.x/Developers_Guide/Localization_Troubleshooting\|Localization Troubleshooting]] article will explain how to solve some issues that you may encounter while translating.</note>
−	</note>

@@ Line 1: / Line 1: @@
-__TOC__
+__NOTOC__
 {{#CUSTOMTITLE:Translating CKEditor}}
 After you are accepted as a member of a CKEditor translation team, you will be able to contribute your translations. In order to start translating, go to the team page and choose a resource that you would like to work on, like CKEditor core or one of its plugins.