CKEditor 3.x/Developers Guide/Localization Troubleshooting - Revision history

Anna: Section sequence changed

2013-03-01T12:17:44Z

Section sequence changed

Anna: Error with CLA added

2013-03-01T11:05:44Z

Error with CLA added

Anna: Updated to February 2013 look and feel

2013-02-28T15:10:06Z

Updated to February 2013 look and feel

Anna: Article updated

2011-12-02T08:18:57Z

Article updated

Anna: Q&A sequence modified

2011-12-02T07:31:52Z

Q&A sequence modified

Anna: /* Which language code should I use for a new team? */ Minor language code correction

2011-11-24T11:56:49Z

‎Which language code should I use for a new team?: Minor language code correction

Anna: Minor formatting changes

2011-11-24T11:54:46Z

Minor formatting changes

Anna: Issue with language codes added

2011-11-24T11:54:14Z

Issue with language codes added

Anna: /* Do I still need to escape apostrophes in the localized strings? */ Minor adjustment

2011-11-18T13:27:31Z

‎Do I still need to escape apostrophes in the localized strings?: Minor adjustment

Anna: /* Transifex reports a failed file correctness check */ Minor rewording

2011-11-18T12:52:07Z

‎Transifex reports a failed file correctness check: Minor rewording

@@ Line 3: / Line 3: @@
 The following article describes some issues that may arise during the localization process. If your problem is not described here, [https://www.transifex.com/projects/p/ckeditor/ contact CKEditor project maintainers] to get support.
-=== Contribution License Agreement Error ===
+== How to report disruptive team members, abuse, and vandalism ==
 If you feel that there is a member of your team who is abusing the CKEditor localization project in any way, please report him or her to the project maintainers.
-=== Resource was not locked after downloading it for translation ===
+== Resource was not locked after downloading it for translation ==
 You can lock the resource manually by selecting the '''Lock this translation to notify others you're working with it.''' option in the language resource dialog window.
@@ Line 25: / Line 14: @@
 Do not forget to unlock the translation when you are done with your work.
-=== Which language code should I use for a new team? ===
+== Which language code should I use for a new team? ==
 When you are [[CKEditor_3.x/Developers_Guide/Localization_Teams#Requesting_a_New_Team|setting up a new localization team]], you will be able to choose one from the drop-down list on Transifex page.
@@ Line 35: / Line 24: @@
 * For a ''regional variant of a language only'', use a four letter language code, for example <code>pt_BR</code> for Portuguese as used in Brazil.
-=== Do I still need to escape apostrophes in localized strings? ===
+== Contribution License Agreement Error ==
 No. Although previously we have been working directly on JavaScript files and all apostrophes had to be escaped by using a backslash character, you no longer need to do this. Our tools will now perform all the necessary replacements in the background so just enter a correct literal string.
 * '''Old version:'''
@@ Line 42: / Line 42: @@
 *; <code>Barre d'emplacement des éléments de l'éditeur</code>
-=== How Do I Correct Existing Localizations? ===
+== How Do I Correct Existing Localizations? ==
 When using CKEditor, you might notice that some language strings are not as good as they could be. If this is the case, you can log into the CKEditor UI Translation Center at Transifex and choose the resource you want to correct. When in [[CKEditor_3.x/Developers_Guide/Translating_CKEditor#Online_Translation|online translation mode]], just use the search bar to search for the term that you want to correct. Make sure you have not limited the list to untranslated entries only by clicking the '''Untranslated''' link above the editor input field.
-=== Transifex hangs on uploading a localized file ===
+== Transifex hangs on uploading a localized file ==
 Sometimes when a file is malformed or uses an incorrect encoding, the upload may not succeed &mdash; it will hang without a descriptive error message. If this happens please check the following:
 * Whether the file is correctly encoded.<br /> All CKEditor files are UTF-8 encoded. ANSI files will be rejected.
@@ Line 52: / Line 52: @@
 *; You can run <code>msgfmt -c</code> on the file to check its correctness before you attempt to upload it.
-=== Transifex reports a failed file correctness check ===
+== Transifex reports a failed file correctness check ==
 On uploading the file Transifex may report that the file is malformed.

@@ Line 2: / Line 2: @@
 {{#CUSTOMTITLE:CKEditor Localization Troubleshooting}}
 The following article describes some issues that may arise during the localization process. If your problem is not described here, [https://www.transifex.com/projects/p/ckeditor/ contact CKEditor project maintainers] to get support.
 === How to report disruptive team members, abuse, and vandalism ===

@@ Line 1: / Line 1: @@
 __TOC__
 {{#CUSTOMTITLE:CKEditor Localization Troubleshooting}}
-The following article describes some issues that may arise during the localization process. If your problem is not described here, [https://www.transifex.net/projects/p/ckeditor/ contact CKEditor project maintainers] to get support.
+The following article describes some issues that may arise during the localization process. If your problem is not described here, [https://www.transifex.com/projects/p/ckeditor/ contact CKEditor project maintainers] to get support.
 === How to report disruptive team members, abuse, and vandalism ===
@@ Line 7: / Line 7: @@
 === Resource was not locked after downloading it for translation ===
-You can lock the resource manually by selecting the '''Lock this translation to notify others you're working with it.''' option in the '''Translation Details''' dialog window.
+You can lock the resource manually by selecting the '''Lock this translation to notify others you're working with it.''' option in the language resource dialog window.
 [[Image:Transifex_manual_locking.png|frame|center|Lock file option in Transifex]]
@@ Line 17: / Line 17: @@
 When you are [[CKEditor_3.x/Developers_Guide/Localization_Teams#Requesting_a_New_Team|setting up a new localization team]], you will be able to choose one from the drop-down list on Transifex page.
-[[Image:Transifex_language_codes.png|frame|center|Language codes available in Transifex]]
+[[Image:Transifex_language_codes.png|thumb|center|800px|Language codes available in Transifex]]
@@ Line 32: / Line 32: @@
 === How Do I Correct Existing Localizations? ===
-When using CKEditor, you might notice that some language strings are not as good as they could be. If this is the case, you can log into the CKEditor UI Translation Center at Transifex and choose the resource you want to correct. When in [[CKEditor_3.x/Developers_Guide/Translating_CKEditor#Online_Translation|online translation mode]], you will need to check the '''Translated''' checkbox in order to show the strings that have already been submitted.
+When using CKEditor, you might notice that some language strings are not as good as they could be. If this is the case, you can log into the CKEditor UI Translation Center at Transifex and choose the resource you want to correct. When in [[CKEditor_3.x/Developers_Guide/Translating_CKEditor#Online_Translation|online translation mode]], just use the search bar to search for the term that you want to correct. Make sure you have not limited the list to untranslated entries only by clicking the '''Untranslated''' link above the editor input field.
 === Transifex hangs on uploading a localized file ===

@@ Line 30: / Line 30: @@
 * '''Current version:'''
 *; <code>Barre d'emplacement des éléments de l'éditeur</code>
 === Transifex hangs on uploading a localized file ===

@@ Line 1: / Line 1: @@
 {{#CUSTOMTITLE:CKEditor Localization Troubleshooting}}
 The following article describes some issues that may arise during the localization process. If your problem is not described here, [https://www.transifex.net/projects/p/ckeditor/ contact CKEditor project maintainers] to get support.
@@ Line 12: / Line 13: @@
 Do not forget to unlock the translation when you are done with your work.
 === Do I still need to escape apostrophes in localized strings? ===
@@ Line 36: / Line 47: @@
 * BOM is present at the beginning of the file.
 * The <code>.po</code> file structure was altered and is no longer compliant with the project resources.

@@ Line 45: / Line 45: @@
 Please note that while Transifex offers both two letter and four letter language codes, you should stick to the following CKSource rules based on ISO 639-1:
 * For a ''standard variation of a language'', use a two letter language code, for example <code>pt</code> for Portuguese as used in Portugal.
-* For a ''regional variant of a language only'', use a four letter language code, for example <code>pt-br</code> for Portuguese as used in Brazil.
+* For a ''regional variant of a language only'', use a four letter language code, for example <code>pt_BR</code> for Portuguese as used in Brazil.

← Older revision		Revision as of 11:54, 24 November 2011
Line 36:		Line 36:
	* BOM is present at the beginning of the file.		* BOM is present at the beginning of the file.
	* The <code>.po</code> file structure was altered and is no longer compliant with the project resources.		* The <code>.po</code> file structure was altered and is no longer compliant with the project resources.
		+
		+	=== Which Language Code Should I Use for a New Team? ===
		+	When you are [[CKEditor_3.x/Developers_Guide/Localization_Teams#Requesting_a_New_Team\|setting up a new localization team]], you will be able to choose one from the drop-down list on Transifex page.
		+
		+	[[Image:Transifex_language_codes.png\|frame\|center\|Language codes available in Transifex]]
		+
		+
		+	Please note that while Transifex offers both two letter and four letter language codes, you should stick to the following CKSource rules based on ISO 639-1:
		+	* For a ''standard variation of a language'', use a two letter language code, for example <code>pt</code> for Portuguese as used in Portugal.
		+	* For a ''regional variant of a language only'', use a four letter language code, for example <code>pt-br</code> for Portuguese as used in Brazil.

← Older revision		Revision as of 12:52, 18 November 2011
Line 30:		Line 30:
	On uploading the file Transifex may report that the file is malformed.		On uploading the file Transifex may report that the file is malformed.

−	[[Image:Transifex_offline_translation_error.png\|thumb\|600px\|center\|Failed file correctness in Transifex]]	+	[[Image:Transifex_offline_translation_error.png\|thumb\|600px\|center\|Failed file correctness check in Transifex]]