2012-12-21T12:26:21Z

Wiktor:

<note>Flash files with `swf' extension, just like HTML files, can be used to execute JavaScript code (and to e.g. perform an XSS attack). Grant permission to upload `.swf` files only if you understand and can accept this risk.</note>

2011-12-16T11:52:11Z

Wiktor: Created page with '{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} __TOC__ During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have m…'

{{#CUSTOMTITLE:Enabling CKEditor on Publishing Sites}} __TOC__
During the installation process, CKEditor will be automatically enabled on Publishing Sites. However, if you have modified the default master pages or if you are using your own, custom master pages, then you will need to manually enable CKEditor on these sites.

=== Adding CKEditor to a Master Page ===

The master pages are located in the following folders:
* <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\GLOBAL\default.master</code>
* <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\FEATURES\PublishingLayouts\MasterPages\</code>

In each file master file that is used on your sites do the following changes:

==== Step 1: Register an Assembly ====

To enable CKEditor, in the <code>Register</code> section at the top of the page add:

<source>
<%-- Start CKEditorForSharePoint --%>
<%@ Register TagPrefix="my" Assembly="CKEditorForSharePoint, Version=1.0.0.0, Culture=neutral, PublicKeyToken=2c0483256f3286a8"
Namespace="CKEditorForSharePoint" %>
<%-- End CKEditorForSharePoint --%>
</source>

==== Step 2: Add the Page_Load Method ====

Straight below the <code>Register</code> tag or somewhere in the <code><body></code> of the master page add:
<source>
<%-- Start CKEditorForSharePoint --%>
<script language="C#" runat="server">
private void Page_Load(object sender, EventArgs e) {
this.Page.ClientScript.RegisterStartupScript(this.Page.GetType(), "CKEditorConfigScript",
string.Format("var CKTabConfig =\"{0}\";", SPUtils.ReadConfigurationForCKEditor()), true);
}
</script>
<%-- End CKEditorForSharePoint --%>
</source>

<note>
The extra comments <code><%-- Start CKEditorForSharePoint --%></code> and <code><%-- End CKEditorForSharePoint --%></code>
are not required, but they will be helpful e.g. during uninstallation process or when modifying the page to understand what they are used for.
</note>

==== Step 3: Enable Code Blocks in Master Pages ====

In previous step we added server side code to the page. In order to execute this part of code, SharePoint must be configured to allow this operation. If code blocks are disallowed, you will see the following error:

'''Parser Error Message''' : Code blocks are not allowed in this file

Code blocks can be enabled in the <code>web.config</code> file, in the <code>configuration/SharePoint/PageParserPaths</code> configuration section. Find the <code><PageParserPaths></code> option and add there <code><PageParserPath></code> element:

<source lang="xml">
<PageParserPaths>
<PageParserPath VirtualPath="/_catalogs/masterpage/*" CompilationMode="Always" AllowServerSideScript="true"
IncludeSubFolders="true"/>
</PageParserPaths>
</source>

<note>Such configuration option should be '''restricted only to certain set of pages''' (or even to a single page). Anyone that can modify or add a page to the specified <code>VirtualPath</code> can insert code that will be executed server side with no restrictions. A good location to specify as a <code>PageParserPath</code> is the location where you store your masterpages, for example <code>/_catalogs/masterpage</code>.</note>

CKEditor for SharePoint/2010/Administrators Guide/License

2011-11-29T09:00:13Z

Wiktor: fixed typo

CKEditor 3.x/Developers Guide/Technical Details of Localization

2011-11-23T11:45:36Z

Wiktor: added space after "Comment"

{{#CUSTOMTITLE:Technical Details of the CKEditor Localization}} __TOC__
In the article below you will learn:
# How often translations are ported from Transifex to CKEditor;
# Why gettext <code>.po</code> files are used in the CKEditor localization project;
# How to manually test new translations.
== When Will My Translation Be Published? ==
Below is a simple diagram that shows when the language strings added in Transifex will land in a new CKEditor release.

http://a.cksource.com/c/1/inc/img/transifex/diagram.png

Once generated, the development snapshot is immediately published on the [http://nightly.ckeditor.com/ CKEditor Nightly Website].
The whole process takes up to 24 hours, so after updating the translation, the next day you can download a development snapshot that will contain updated files. You can then test if everything works as expected.
<note>Please note that the ''development shapshot'' is exactly what the name implies. For a production environment it is more advisable to wait for the next stable release with updated language files.</note>

== Why Are .po Files Used in Tansifex? ==
CKEditor is a browser-based WYSIWYG editor written in JavaScript. The language files used by CKEditor are also JavaScript files. This is the best option performance-wise.

For many translators working with JavaScript source code was not comfortable. Storing text in plain JavaScript files meant that the translator had to know how to code in JavaScript — strings had to be escaped properly, multiline strings had to be written in a special way etc. JavaScript language files are in fact small programs, for example the language file for the <code>a11yhelp</code> plugin calls a function:
<source lang="javascript">
CKEDITOR.plugins.setLang( 'a11yhelp', 'he', {
accessibilityHelp : {
...
}
}
</source>
All the issues mentioned above as well as the very specific format of the language files used by CKEditor core and plugins lead to the conclusion that a simplified intermediate format (<code>gettext</code>) is needed to make the localization process more straightforward and the integration with Transifex easier.
=== What Does it Mean to Me? ===
In the CKEditor localization project at Transifex you only have access to the <code>gettext</code> (<code>.po</code>) files. It means that for example if you download a resource for offline translation, you will get a <code>.po</code> file, not a JavaScript file. You can load this file into your favorite <code>.po</code> file editor like [http://projects.gnome.org/gtranslator/ Gtranslator], [http://userbase.kde.org/Lokalize Lokalize], or [http://www.poedit.net/ Poedit] for offline translation, but you cannot use it directly with CKEditor.
== How Can I Immediately Test New Translations? ==
At some stage you may want to immediately check if your translation fits into the place where it is used.
As explained above, the propagation of changes between Transifex and the CKEditor nightly build takes up to 24 hours. If you have doubts regarding the string context, make sure to always check the '''Details''' tab of a language string and read the '''Comment''' <sup>'''(1)'''</sup> to understand where the string is used.

[[File:Transifex details tab.png|900px|The "details" tab]]

If you are still unsure, you can also check the '''String ID''' <sup>'''(2)'''</sup> in the '''Details''' tab. The '''String ID''' is nothing else than the name of a variable that is used inside the JavaScript language files.
For example, the <code>common.browseServer</code> ID is equal to the following object:
<source lang="javascript">
common :
{
browseServer : '...'
}
</source>
After finding the right entry in the appropriate CKEditor language file (if you are translating the core, the language file is located in the <code>lang</code> folder), you may modify the string you are interested in. Save the file and launch CKEditor to see whether your translation fits the context and available space.

CKEditor 3.x/Developers Guide/Localization

2011-11-23T11:44:51Z

Wiktor: Added link to Technical Details

CKEditor 3.x/Developers Guide

2011-11-23T11:43:58Z

Wiktor: Added link to Technical Details

{{#CUSTOMTITLE:CKEditor 3.x Developer's Guide}} __TOC__
== CKEditor ==
*[[CKEditor 3.x/Developers Guide/Installation|Installation]]
* Integration
**[[CKEditor 3.x/Developers Guide/Integration|Integration]]
** [[CKEditor 3.x/Developers Guide/jQuery Adapter|jQuery]]
*Configuration
**[[CKEditor 3.x/Developers Guide/Setting Configurations|Setting Configuration]]
**[[CKEditor 3.x/Developers Guide/Toolbar|Toolbar]]
**[[CKEditor_3.x/Developers_Guide/Styles|Styles]]
**[[CKEditor 3.x/Developers Guide/Output Formatting|Output Formatting]]
**[[CKEditor 3.x/Developers Guide/Templates|Templates]]
**Spell Checker
**[[CKEditor 3.x/Developers Guide/File Browser (Uploader)|File Browser/Uploader ]]
* Tools
** [[CKEditor_3.x/Developers_Guide/CKPackager|CKPackager — Compressing CKEditor Source]]
*Customization
**[[CKEditor 3.x/Developers Guide/Dialog_Customization|Dialogs]]
* Contribution
** [[CKEditor_3.x/Developers_Guide/Localization|Localization]]
*** [[CKEditor_3.x/Developers_Guide/Localization_Teams|Joining a Localization Team]]
*** [[CKEditor_3.x/Developers_Guide/Translating_CKEditor|Translating CKEditor]]
*** [[CKEditor_3.x/Developers_Guide/Localization_Tips|Localization Tips]]
*** [[CKEditor_3.x/Developers_Guide/Localization_Troubleshooting|Localization Troubleshooting]]
*** [[CKEditor_3.x/Developers_Guide/Technical_Details_of_Localization|Technical Details]]
**Plugins
**Skins
*Advanced Tasks
**[[CKEditor_3.x/Developers_Guide/Editor_Core_URLs_Manipulation|Editor Core URLs Manipulation]]
**[[CKEditor_3.x/Developers_Guide/Data_Processor|Data Processor: Data Input and Output Manipulation]]
*[http://docs.cksource.com/ckeditor_api/ JavaScript API]
*[[FCKeditor 3.x/Design and Architecture|Design and Architecture]]

== CKEditor for ASP.NET ==
{{CKEditor.NET_TOC}}

== CKEditor for Java ==
{{CKEditor.Java_TOC}}

CKEditor 3.x/Developers Guide/Technical Details of Localization

2011-11-23T11:42:43Z

Wiktor: Created page with '{{#CUSTOMTITLE:Technical Details of the CKEditor Localization}} __TOC__ In the article below you will learn: # How often translations are ported from Transifex to CKEditor; # Why…'

{{#CUSTOMTITLE:Technical Details of the CKEditor Localization}} __TOC__
In the article below you will learn:
# How often translations are ported from Transifex to CKEditor;
# Why gettext <code>.po</code> files are used in the CKEditor localization project;
# How to manually test new translations.
== When Will My Translation Be Published? ==
Below is a simple diagram that shows when the language strings added in Transifex will land in a new CKEditor release.

http://a.cksource.com/c/1/inc/img/transifex/diagram.png

Once generated, the development snapshot is immediately published on the [http://nightly.ckeditor.com/ CKEditor Nightly Website].
The whole process takes up to 24 hours, so after updating the translation, the next day you can download a development snapshot that will contain updated files. You can then test if everything works as expected.
<note>Please note that the ''development shapshot'' is exactly what the name implies. For a production environment it is more advisable to wait for the next stable release with updated language files.</note>

== Why Are .po Files Used in Tansifex? ==
CKEditor is a browser-based WYSIWYG editor written in JavaScript. The language files used by CKEditor are also JavaScript files. This is the best option performance-wise.

For many translators working with JavaScript source code was not comfortable. Storing text in plain JavaScript files meant that the translator had to know how to code in JavaScript — strings had to be escaped properly, multiline strings had to be written in a special way etc. JavaScript language files are in fact small programs, for example the language file for the <code>a11yhelp</code> plugin calls a function:
<source lang="javascript">
CKEDITOR.plugins.setLang( 'a11yhelp', 'he', {
accessibilityHelp : {
...
}
}
</source>
All the issues mentioned above as well as the very specific format of the language files used by CKEditor core and plugins lead to the conclusion that a simplified intermediate format (<code>gettext</code>) is needed to make the localization process more straightforward and the integration with Transifex easier.
=== What Does it Mean to Me? ===
In the CKEditor localization project at Transifex you only have access to the <code>gettext</code> (<code>.po</code>) files. It means that for example if you download a resource for offline translation, you will get a <code>.po</code> file, not a JavaScript file. You can load this file into your favorite <code>.po</code> file editor like [http://projects.gnome.org/gtranslator/ Gtranslator], [http://userbase.kde.org/Lokalize Lokalize], or [http://www.poedit.net/ Poedit] for offline translation, but you cannot use it directly with CKEditor.
== How Can I Immediately Test New Translations? ==
At some stage you may want to immediately check if your translation fits into the place where it is used.
As explained above, the propagation of changes between Transifex and the CKEditor nightly build takes up to 24 hours. If you have doubts regarding the string context, make sure to always check the '''Details''' tab of a language string and read the '''Comment'''<sup>'''(1)'''</sup> to understand where the string is used.

[[File:Transifex details tab.png|900px|The "details" tab]]

If you are still unsure, you can also check the '''String ID''' <sup>'''(2)'''</sup> in the '''Details''' tab. The '''String ID''' is nothing else than the name of a variable that is used inside the JavaScript language files.
For example, the <code>common.browseServer</code> ID is equal to the following object:
<source lang="javascript">
common :
{
browseServer : '...'
}
</source>
After finding the right entry in the appropriate CKEditor language file (if you are translating the core, the language file is located in the <code>lang</code> folder), you may modify the string you are interested in. Save the file and launch CKEditor to see whether your translation fits the context and available space.

File:Transifex details tab.png

2011-11-23T11:35:37Z

Wiktor: The "details" tab in Transifex.

The "details" tab in Transifex.

Main Page

2011-11-22T10:17:55Z

Wiktor: Added CKeditor for Drupal

{{#CUSTOMTITLE:CKSource Docs - The Official Documentation Site}}<table style="width:100%" cellspacing="30"><tr><td style="width:50%" valign="top">

{{CKEditor_Docs_FrontPage}}
</td><td style="width:50%" valign="top">

http://a.cksource.com/e/1/img/logo-ckfinder-h100.png

<span class="introText">Manage your images and files with this easy to use yet extremely powerful file manager, making your web content truly rich and enhancing the user experience.</span>

<ul>
<li class="homeMainDoc">[[CKFinder_2.x/Developers Guide|CKFinder 2.x Developer's Guide]]</li>
<li class="homeMainDoc">[[CKFinder_2.x/Users Guide|CKFinder 2.x User's Guide]]</li>
<li class="homeDoc">[[CKFinder_1.x/Developers Guide|CKFinder 1.x Developer's Guide]]</li>
<li class="homeDoc">[[CKFinder_1.x/Users Guide|CKFinder 1.x User's Guide]]</li>
<li class="homeSite">[http://ckfinder.com/ CKFinder Web Site]</li>
</ul>

</td></tr>
<tr><td style="width:50%" valign="top">
http://a.cksource.com/c/1/inc/img/ckeditor-for-sp-logo-h100.png

<span class="introText">The ultimate editing solution for Microsoft SharePoint that brings all amazing features of the most popular online WYSIWYG editor in the world to this platform.</span>

<ul>
<li class="homeMainDoc">[[CKEditor_for_SharePoint|CKEditor for SharePoint Documentation]]</li>
<li class="homeSite">[http://ckeditor.com/sharepoint CKEditor for SharePoint Web Site]</li>
</ul>
</td>
<td style="width:50%" valign="top">
http://a.cksource.com/c/1/inc/img/ckeditor-for-joomla-logo.png

<span class="introText">The ultimate editing solution for Joomla! content management system that brings all amazing features of the most popular online WYSIWYG editor in the world to this platform.</span>

<ul>
<li class="homeMainDoc">[[CKEditor_for_Joomla|CKEditor for Joomla Documentation]]</li>
<li class="homeSite">[http://ckeditor.com/ckeditor-for-joomla CKEditor for Joomla Website]</li>
</ul>
</td>
</tr>

<tr><td style="width:50%" valign="top">
http://a.cksource.com/c/1/inc/img/ckeditor-for-drupal-logo.png

<span class="introText">The ultimate editing solution for Drupal Open Source CMS that brings all amazing features of the most popular online WYSIWYG editor in the world to this platform.</span>

<ul>
<li class="homeMainDoc">[[CKEditor_for_Drupal|CKEditor for Drupal Documentation]]</li>
<li class="homeSite">[http://ckeditor.com/ckeditor-for-drupal CKEditor for Drupal Website]</li>
</ul>
</td>
<td style="width:50%" valign="top">
</td>
</tr>

</table>

Template:CKFinder 2.x V1 Integration Javascript

2011-11-21T08:45:45Z

Wiktor: corrected path to _samples/standalone_v1.html

<div class="usermessage" style="border:1px solid #000;padding:6px;margin-bottom:10px">The following integration method is recommended only for users upgrading from CKFinder 1.x that don't want to change their code.<br>If you're installing CKFinder for the first time, please check the [[CKFinder_2.x/Developers_Guide/{{{language}}}/Integration/JavaScript|JavaScript Integration]] instead.</div>
== JavaScript integration ==

The integration using javascript code is a bit more powerful. The javascript integration file provides also a '''Popup''' method, which can be used to open CKFinder in a popup window.

=== Step 1: Loading CKFinder ===

CKFinder is a JavaScript application. To load it, you just need to include a single file reference at your page. Supposing that you have [[CKFinder_2.x/Developers_Guide/{{{language}}}/Installation|installed]] CKFinder at the "ckfinder" directory at the root of your web site, here you have an example:
<source><head>
...
<script type="text/javascript" src="/ckfinder/ckfinder_v1.js"></script>
</head></source>
With the above file loaded, the CKFinder class is ready to be used.

=== Step 2: Creating an Application Instance ===

Next thing to do, to have the CKFinder up & running, is creating an application instance.

<source>
<script type="text/javascript">
var finder = new CKFinder();
finder.BasePath = '/ckfinder/';
finder.Skin = 'v1';
finder.Create();
</script>
</source>

(put this code anywhere inside of the <code><body></code> tag). For a working example please check the standalone v1 sample distributed with CKFinder (_samples/standalone_v1.html).

The JavaScript integration method provides also two static methods to launch CKFinder, which can accept either four arguments or the settings object as the only argument.
* '''CKFinder.Create'''( basePath, width, height, selectFunction ) - Simple static method supporting only basic four arguments. All arguments except basePath are optional.
* '''CKFinder.Create'''( settingsObject ) - Pass an object with selected properties as the only argument.
* '''CKFinder.Popup'''( basePath, width, height, selectFunction ) - Simple static method supporting only basic four arguments. All arguments except basePath are optional.
* '''CKFinder.Popup'''( settingsObject ) - Pass an object with selected properties as the only argument.

The example of creating CKFinder using a static javascript method:
<source>
<script type="text/javascript">
CKFinder.Create( '/ckfinder/', 700 ) ;
</script>
</source>

More flexible method of launching CKFinder, the object with selected settings is passed as the only argument:
<source>
<script type="text/javascript">
CKFinder.Create( { BasePath : '/ckfinder/', RememberLastFolder : false } ) ;
</script>
</source>

CKEditor for Drupal/Installation

2011-11-18T15:48:46Z

Wiktor: the id of <hide> element must be unique

If you want to install CKEditor for Drupal, follow the steps described below.

== Drupal 7 ==
* Download the installation package (<code>.zip</code> archive) from the official CKEditor for Drupal website.
* Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
* When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:
<pre>
modules <dir>
...
ckeditor <dir>
ckeditor <dir>
ckfinder <dir>
images <dir>
includes <dir>
plugins <dir>
changelog.html
ckeditor.api.php
ckeditor.css
ckeditor.info
ckeditor.install
ckeditor.module
...
</pre>
* Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
* (Optional) Grant permissions for administering CKEditor in the '''Administration panel''' > '''People''' > '''Permissions''' section.
* Add your license name and key by editing the Global Profile in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' > '''Global settings''' section. CKEditor will now run in licensed mode.
* If you want to enable CKFinder, an advanced Ajax file browser, see the '''Installing CKFinder''' section below.
* Adjust CKEditor profiles in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' section. Profiles determine which options are available to users based on the input format system.<br><warning />Certain Text formats (e.g. <code>Filtered HTML</code>) limit allowed HTML tags, so after saving the content you many notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in '''Administration panel''' > '''Configuration''' > '''Content authoring''' > '''Text formats'''. <hide target="formats">More...</hide>
<div id="formats">
Below is a short list of tags that can be created with CKEditor (form elements are not included in this list):
<source lang="xml">
<a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr>
<br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tbody> <th> <tr> <td> <em> <b> <u> <i> <strong>
<del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code>
<cite> <embed> <object> <param> <strike> <caption> <iframe>
</source>
<strong>Note:</strong> be careful when granting users access to create tags like <code><iframe></code>.
</div>

You can now use CKEditor with its default settings on your Drupal website, like in the figure below, or [[CKEditor_for_Drupal/Configuration|customize it to your needs]] if required.

[[Image:Drupal_CKEditor_example.png|frame|center|A basic page created with CKEditor for Drupal]]

=== Installing CKFinder ===
CKFinder is an Ajax-based file manager created by CKEditor developers: http://ckfinder.com/. It is already included in your licensed CKEditor for Drupal module, so all you need to do is enable it in the Drupal administration panel.

* Grant the "CKFinder access" permission in the '''Administration panel''' > '''People''' > '''Permissions''' section.
* Open the Drupal settings file (<code>sites/default/settings.php</code>) and do the following:
** Uncomment the <code>$base_url</code> variable and set the base URL of your website (without the trailing slash).
** Uncomment the <code>$cookie_domain</code> variable and set the domain name of your website.
* (Optional) Configure CKFinder settings in the '''File browser settings''' section for the CKEditor profile that you want to use.

== Drupal 6 ==

* Download the installation package (<code>.zip</code> archive) from the official CKEditor for Drupal website.
* Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
* When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:
<pre>
modules <dir>
...
ckeditor <dir>
ckeditor <dir>
ckfinder <dir>
images <dir>
includes <dir>
plugins <dir>
changelog.html
ckeditor.api.php
ckeditor.css
ckeditor.info
ckeditor.install
ckeditor.module
...
</pre>
* Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
* Grant permissions for using CKEditor to selected roles in the '''Administration panel''' > '''User management''' > '''Permissions''' section ('''ckeditor module''' > '''access ckeditor''').
* Add your license name and key by editing the Global Profile in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' > '''Global settings''' section. CKEditor will now run in licensed mode.
* If you want to enable CKFinder, an advanced Ajax file browser, see the '''Installing CKFinder''' section below.
* Adjust CKEditor profiles in the '''Administration panel''' > '''Site configuration''' > '''CKEditor''' section. Profiles determine which options are available to users based on system-wide roles. In each profile you can choose which textareas will be replaced by CKEditor, select a default toolbar, and configure some more advanced settings. '''Note:''' User 1 must be assigned a system role that corresponds to the privileges required. If no role is assigned to User 1, they will have the privileges of "authenticated user".<br><warning />Certain Text formats (e.g. <code>Filtered HTML</code>) limit allowed HTML tags, so after saving the content you many notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in '''Administration panel''' > '''Configuration''' > '''Content authoring''' > '''Text formats'''. <hide target="formats2">More...</hide>
<div id="formats2">
Below is a short list of tags that can be created with CKEditor (form elements are not included in this list):
<source lang="xml">
<a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr>
<br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tbody> <th> <tr> <td> <em> <b> <u> <i> <strong>
<del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code>
<cite> <embed> <object> <param> <strike> <caption> <iframe>
</source>
<strong>Note:</strong> be careful when granting users access to create tags like <code><iframe></code>.
</div>

That's it, you can now use CKEditor with its default settings on your Drupal website.

=== Installing CKFinder ===
CKFinder is an Ajax-based file manager created by CKEditor developers: http://ckfinder.com/. It is already included in your licensed CKEditor for Drupal module, so all you need to do is enable it in the Drupal administration panel.

* Grant the "allow CKFinder file uploads" permission in the '''Administration panel''' > '''User management''' > '''Permissions''' section.
* Open the Drupal settings file (<code>sites/default/settings.php</code>) and do the following:
** Uncomment the <code>$base_url</code> variable and set the base URL of your website (without the trailing slash).
** Uncomment the <code>$cookie_domain</code> variable and set the domain name of your website.
* (Optional) Configure CKFinder settings in the '''File browser settings''' section for the CKEditor profile that you want to use.

CKEditor 3.x/Developers Guide/Localization

2011-11-17T19:12:16Z

Wiktor: /* Useful Links */

__TOC__
{{#CUSTOMTITLE:CKEditor Localization}}
In an effort to speed up the CKEditor localization process and make it easier and more intuitive for our translators to create and maintain different localizations we have decided to set up the [https://www.transifex.net/projects/p/ckeditor/ CKEditor localization project on Transifex]. Transifex is an online platform that allows projects to make use of [http://en.wikipedia.org/wiki/Crowdsourcing crowd-sourced] translations, providing suitable resource management tools as well as a user-friendly browser-based interface.

No matter if you are a first-time Transifex user or a seasoned translator, a fresh CKEditor fan or a long time user, feel free to join us, contribute to existing translations or create new ones in an effort to make it easier for people from around the world to use their favorite editor in their native language!

== Useful Links ==
* Transifex website: http://www.transifex.net
* Transifex documentation: http://help.transifex.net
* CKEditor official website for an overview of the editor features: http://ckeditor.com
* CKEditor demo, to see the real context where the language strings are used: http://ckeditor.com/demo

== CKEditor Localization Project Structure ==
The [https://www.transifex.net/projects/p/ckeditor/ CKEditor project] on Transifex currently includes the following translatable resources:
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/core/ core]</code> – the language strings of the main CKEditor application;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-a11yhelp/ plugin-a11yhelp]</code> – the language strings of the '''CKEditor Accessibility Help''';
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-devtools/ plugin-devtools]</code> – the language strings of the optional '''Developer Tools''' plugin;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-placeholder/ plugin-placeholder]</code> – the language strings of the optional '''Placeholder''' plugin;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-specialchar/ plugin-specialchar]</code> – the language strings of the '''Special Characters''' plugin;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-uicolor/ plugin-uicolor]</code> – the language strings of the '''UI Color''' plugin.

== CKEditor Localization Team Structure ==
You will find the following roles among the contributors of the CKEditor localization project on Transifex:
* '''Project maintainers''' – CKSource staff that manage the project and have full administration permissions.
* '''Teams''' – groups of people that take care of specific localizations, like the Hebrew team, the German team, the Spanish team and so on. Each team consists of one or more persons that perform either of the following roles:
** '''Team coordinator''' – usually the creator of the team or a more advanced translator; a user who can manage the team and review submitted translations.
** '''Team member''' – a translator of CKEditor into a given language.

== Joining CKEditor Localization Team ==
CKSource is always looking for new translators willing to join the CKEditor localization project, complete existing translations and add new language versions. If you want to contribute, proceed as described below:
# '''Register on the Transifex website.'''
#; You can [https://www.transifex.net/plans/ sign up for free] by using the "Free Plan" option. You will be redirected to the [https://www.transifex.net/plans/signup/free/ signup form page]. Fill in your personal details and register the account. You will need to confirm your account by clicking the link from the validation e-mail.
# '''Sign in and complete your profile.'''
#; Go to the '''Profile''' tab of your dashboard and fill in the information that can tell other contributors something more about yourself.
# '''Join a CKEditor translation team.'''
#; Go to the translation [https://www.transifex.net/projects/p/ckeditor/teams/ teams page] on the project's site and see the list of available language teams. If you find a suitable one, [[CKEditor_3.x/Developers_Guide/Localization#Joining_a_Team|join it]]. If not, [[CKEditor_3.x/Developers_Guide/Localization#Requesting_a_New_Team|request the creation of a new team]] for your native language.
#; Your requests will need to be approved by one of the maintainers or coordinators before you can actively contribute to the project.

=== Joining a Team ===
Go to the translation [https://www.transifex.net/projects/p/ckeditor/teams/ teams page] on the project's site and click a team that you want to join. Accept the contributor license agreements and click '''Join this Team''' to request access to an existing team.

[[Image:Transifex_join_team_01.png|thumb|center|800px|Joining an existing team in Transifex]]

After you click the '''Join this Team''' button, a notification will be sent to the team coordinator. Your user name will now appear on the waiting list and you will be able to withdraw your application by clicking the '''Withdraw''' button.

[[Image:Transifex_join_team_02.png|thumb|center|800px|Team waiting list in Transifex]]

The request will also be visible in your profile — see the '''Recent activity''' list.

[[Image:Transifex_recent_activity_01.png|frame|center|Recent activity list in Transifex profile]]

When your request is approved, you will receive an e-mail notification. Your user name will also appear on the language team page.

[[Image:Transifex_team_members.png|thumb|center|800px|Team members list in Transifex]]

You can now start translating project resources within your language team.

<note>Please note that in order to join more language teams you need to apply to all of them separately.
</note>

=== Requesting a New Team ===
If a team for your native language does not exist, you can request creating a new one.

Go to the translation [https://www.transifex.net/projects/p/ckeditor/teams/ teams page] on the project's site and click the '''Request a new team''' button. The following form will open, letting you choose a language for the team.

[[Image:Transifex_request_team_02.png|thumb|center|800px|Requesting a new team in Transifex]]

<note>Please note that CKEditor uses two-letter ISO 639-1 language codes (like <code>de</code>, <code>it</code>, <code>fi</code>) for the majority of translations. In some cases, when a regional variation is required, the four-letter language code can be used (like in <code>pt_BR</code> for Brazilian Portuguese). Please contact the project maintainers if you have any doubts in this regard.</note>

After you click the '''Request Team''' button, a notification will be sent to the project maintainers. The requested team will now appear on the waiting list.

[[Image:Transifex_request_team_03.png|thumb|center|800px|Pending team requests in Transifex]]

The request will also be visible in your profile — see the '''Recent activity''' list.

[[Image:Transifex_recent_activity_02.png|frame|center|Recent activity list in Transifex profile]]

When your request is approved, you will receive an e-mail notification. The new team will also immediately appear on the main project teams page.

[[Image:Transifex_teams_01.png|frame|center|Language teams list in Transifex]]

== Introduction to 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.

[[Image:Transifex_team_translation_resources_01.png|thumb|center|800px|Team translation resources in Transifex]]

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.

<note>Please note that it is recommended to complete missing translations before attempting to correct the existing ones.
</note>

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>

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

[[Image:Transifex_team_translation_details_03.png|frame|center|Translation details in Transifex]]

The translation process can be performed in two ways: online and offline.
* [[CKEditor_3.x/Developers_Guide/Localization#Online_Translation|Online translation]] – 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/Localization#Offline_Translation|Offline translation]] – 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.

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.

[[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 '''Source String''' column displays the language string in its original version (for CKEditor — in English). The '''Translation''' column 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 — an untranslated entry and the blue one is a modified one.

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.

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.

[[Image:Transifex_online_translation_03.png|thumb|center|800px|Automatic translation saving in Transifex]]

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.

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

[[Image:Transifex_offline_translation_01.png|thumb|center|800px|Offline translation in Transifex]]

When you choose this option, Transifex will lock the file to prevent multiple translators from working on the same resource and possibly duplicating their efforts. The file will be locked for up to 48 hours and if you do not upload the translated file during this time (or extend the lock by using the Transifex UI), it will become available to other translators after that.

[[Image:Transifex_offline_translation_02.png|frame|center|File lock status in Transifex]]

You will be prompted to save the file on your local computer; please note that it will have the <code>.po</code> extension that comes from the <code>[http://www.gnu.org/software/gettext/manual/gettext.html gettext]</code> format.

<note>Please note that all CKEditor language files should be UTF-8 encoded, without BOM. Transifex will reject any other file encoding, often without a clear error message.</note>

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.

[[Image:Transifex_offline_translation_03.png|frame|center|Uploading a file in Transifex]]

When the upload is finished, your translations will be added to the project and the file lock will be released.

== Translation Tips ==
Below are some tips that can speed up the translation process and make our workflow more understandable.
# When translating, concentrate on incomple resources first and only after they are done, attempt to correct the extisting entries.
# When using the online Transifex editor, see the list of [http://help.transifex.net/intro/translating.html#keyboard-shortcuts available keyboard shortcuts] that can make a translator's life much easier.
# In translation the context is everything. The source language string might sometimes be ambiguous, so in the online editor you can open the '''Details''' tab for each source string and check its context that is described in the '''Comment''' field. Please use this feature often to avoid misunderstandings!
# If you are not a long-time CKEditor user or developer, we recommend you get acquainted with the [http://ckeditor.com/demo editor demo] or even [http://ckeditor.com/download download and install CKEditor] on your local computer. This will make it easier for you to understand the look and feel of the application as well as its structure and building blocks.
# Transifex includes a very useful feature called "[http://help.transifex.net/intro/translating.html#translation-suggestions suggestions]". You can use it to propose a better version of an existing translation and let the team coordinator or fellow team members decide which version should be used. Additionally, when you are unsure as to how to translate a term, you can propose several versions as suggestions and let other users vote on them. You will find the '''Suggestions''' tab for each entry in the '''Source String''' column.
# Use the file locking feature reasonably and do not lock a file for longer than is necessary. If you know you will not be able to finish your work in one go, you can submit a partially complete translation and come back to it when you have more time to spare.
# Last but not least, remember that Transifex is based on team work. Treat fellow team members as you would like to be treated by them; it is not about competition, it is about cooperation with others and working together to achieve a common goal.

CKEditor 3.x/Developers Guide/Localization

2011-11-17T19:12:00Z

Wiktor:

__TOC__
{{#CUSTOMTITLE:CKEditor Localization}}
In an effort to speed up the CKEditor localization process and make it easier and more intuitive for our translators to create and maintain different localizations we have decided to set up the [https://www.transifex.net/projects/p/ckeditor/ CKEditor localization project on Transifex]. Transifex is an online platform that allows projects to make use of [http://en.wikipedia.org/wiki/Crowdsourcing crowd-sourced] translations, providing suitable resource management tools as well as a user-friendly browser-based interface.

No matter if you are a first-time Transifex user or a seasoned translator, a fresh CKEditor fan or a long time user, feel free to join us, contribute to existing translations or create new ones in an effort to make it easier for people from around the world to use their favorite editor in their native language!

== Useful Links ==
* Transifex website: https://www.transifex.net
* Transifex documentation: http://help.transifex.net
* CKEditor official website for an overview of the editor features: http://ckeditor.com
* CKEditor demo, to see the real context where the language strings are used: http://ckeditor.com/demo

== CKEditor Localization Project Structure ==
The [https://www.transifex.net/projects/p/ckeditor/ CKEditor project] on Transifex currently includes the following translatable resources:
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/core/ core]</code> – the language strings of the main CKEditor application;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-a11yhelp/ plugin-a11yhelp]</code> – the language strings of the '''CKEditor Accessibility Help''';
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-devtools/ plugin-devtools]</code> – the language strings of the optional '''Developer Tools''' plugin;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-placeholder/ plugin-placeholder]</code> – the language strings of the optional '''Placeholder''' plugin;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-specialchar/ plugin-specialchar]</code> – the language strings of the '''Special Characters''' plugin;
* <code>[https://www.transifex.net/projects/p/ckeditor/resource/plugin-uicolor/ plugin-uicolor]</code> – the language strings of the '''UI Color''' plugin.

== CKEditor Localization Team Structure ==
You will find the following roles among the contributors of the CKEditor localization project on Transifex:
* '''Project maintainers''' – CKSource staff that manage the project and have full administration permissions.
* '''Teams''' – groups of people that take care of specific localizations, like the Hebrew team, the German team, the Spanish team and so on. Each team consists of one or more persons that perform either of the following roles:
** '''Team coordinator''' – usually the creator of the team or a more advanced translator; a user who can manage the team and review submitted translations.
** '''Team member''' – a translator of CKEditor into a given language.

== Joining CKEditor Localization Team ==
CKSource is always looking for new translators willing to join the CKEditor localization project, complete existing translations and add new language versions. If you want to contribute, proceed as described below:
# '''Register on the Transifex website.'''
#; You can [https://www.transifex.net/plans/ sign up for free] by using the "Free Plan" option. You will be redirected to the [https://www.transifex.net/plans/signup/free/ signup form page]. Fill in your personal details and register the account. You will need to confirm your account by clicking the link from the validation e-mail.
# '''Sign in and complete your profile.'''
#; Go to the '''Profile''' tab of your dashboard and fill in the information that can tell other contributors something more about yourself.
# '''Join a CKEditor translation team.'''
#; Go to the translation [https://www.transifex.net/projects/p/ckeditor/teams/ teams page] on the project's site and see the list of available language teams. If you find a suitable one, [[CKEditor_3.x/Developers_Guide/Localization#Joining_a_Team|join it]]. If not, [[CKEditor_3.x/Developers_Guide/Localization#Requesting_a_New_Team|request the creation of a new team]] for your native language.
#; Your requests will need to be approved by one of the maintainers or coordinators before you can actively contribute to the project.

=== Joining a Team ===
Go to the translation [https://www.transifex.net/projects/p/ckeditor/teams/ teams page] on the project's site and click a team that you want to join. Accept the contributor license agreements and click '''Join this Team''' to request access to an existing team.

[[Image:Transifex_join_team_01.png|thumb|center|800px|Joining an existing team in Transifex]]

After you click the '''Join this Team''' button, a notification will be sent to the team coordinator. Your user name will now appear on the waiting list and you will be able to withdraw your application by clicking the '''Withdraw''' button.

[[Image:Transifex_join_team_02.png|thumb|center|800px|Team waiting list in Transifex]]

The request will also be visible in your profile — see the '''Recent activity''' list.

[[Image:Transifex_recent_activity_01.png|frame|center|Recent activity list in Transifex profile]]

When your request is approved, you will receive an e-mail notification. Your user name will also appear on the language team page.

[[Image:Transifex_team_members.png|thumb|center|800px|Team members list in Transifex]]

You can now start translating project resources within your language team.

<note>Please note that in order to join more language teams you need to apply to all of them separately.
</note>

=== Requesting a New Team ===
If a team for your native language does not exist, you can request creating a new one.

Go to the translation [https://www.transifex.net/projects/p/ckeditor/teams/ teams page] on the project's site and click the '''Request a new team''' button. The following form will open, letting you choose a language for the team.

[[Image:Transifex_request_team_02.png|thumb|center|800px|Requesting a new team in Transifex]]

<note>Please note that CKEditor uses two-letter ISO 639-1 language codes (like <code>de</code>, <code>it</code>, <code>fi</code>) for the majority of translations. In some cases, when a regional variation is required, the four-letter language code can be used (like in <code>pt_BR</code> for Brazilian Portuguese). Please contact the project maintainers if you have any doubts in this regard.</note>

After you click the '''Request Team''' button, a notification will be sent to the project maintainers. The requested team will now appear on the waiting list.

[[Image:Transifex_request_team_03.png|thumb|center|800px|Pending team requests in Transifex]]

The request will also be visible in your profile — see the '''Recent activity''' list.

[[Image:Transifex_recent_activity_02.png|frame|center|Recent activity list in Transifex profile]]

When your request is approved, you will receive an e-mail notification. The new team will also immediately appear on the main project teams page.

[[Image:Transifex_teams_01.png|frame|center|Language teams list in Transifex]]

== Introduction to 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.

[[Image:Transifex_team_translation_resources_01.png|thumb|center|800px|Team translation resources in Transifex]]

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.

<note>Please note that it is recommended to complete missing translations before attempting to correct the existing ones.
</note>

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>

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

[[Image:Transifex_team_translation_details_03.png|frame|center|Translation details in Transifex]]

The translation process can be performed in two ways: online and offline.
* [[CKEditor_3.x/Developers_Guide/Localization#Online_Translation|Online translation]] – 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/Localization#Offline_Translation|Offline translation]] – 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.

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.

[[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 '''Source String''' column displays the language string in its original version (for CKEditor — in English). The '''Translation''' column 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 — an untranslated entry and the blue one is a modified one.

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.

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.

[[Image:Transifex_online_translation_03.png|thumb|center|800px|Automatic translation saving in Transifex]]

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.

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

[[Image:Transifex_offline_translation_01.png|thumb|center|800px|Offline translation in Transifex]]

When you choose this option, Transifex will lock the file to prevent multiple translators from working on the same resource and possibly duplicating their efforts. The file will be locked for up to 48 hours and if you do not upload the translated file during this time (or extend the lock by using the Transifex UI), it will become available to other translators after that.

[[Image:Transifex_offline_translation_02.png|frame|center|File lock status in Transifex]]

You will be prompted to save the file on your local computer; please note that it will have the <code>.po</code> extension that comes from the <code>[http://www.gnu.org/software/gettext/manual/gettext.html gettext]</code> format.

<note>Please note that all CKEditor language files should be UTF-8 encoded, without BOM. Transifex will reject any other file encoding, often without a clear error message.</note>

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.

[[Image:Transifex_offline_translation_03.png|frame|center|Uploading a file in Transifex]]

When the upload is finished, your translations will be added to the project and the file lock will be released.

== Translation Tips ==
Below are some tips that can speed up the translation process and make our workflow more understandable.
# When translating, concentrate on incomple resources first and only after they are done, attempt to correct the extisting entries.
# When using the online Transifex editor, see the list of [http://help.transifex.net/intro/translating.html#keyboard-shortcuts available keyboard shortcuts] that can make a translator's life much easier.
# In translation the context is everything. The source language string might sometimes be ambiguous, so in the online editor you can open the '''Details''' tab for each source string and check its context that is described in the '''Comment''' field. Please use this feature often to avoid misunderstandings!
# If you are not a long-time CKEditor user or developer, we recommend you get acquainted with the [http://ckeditor.com/demo editor demo] or even [http://ckeditor.com/download download and install CKEditor] on your local computer. This will make it easier for you to understand the look and feel of the application as well as its structure and building blocks.
# Transifex includes a very useful feature called "[http://help.transifex.net/intro/translating.html#translation-suggestions suggestions]". You can use it to propose a better version of an existing translation and let the team coordinator or fellow team members decide which version should be used. Additionally, when you are unsure as to how to translate a term, you can propose several versions as suggestions and let other users vote on them. You will find the '''Suggestions''' tab for each entry in the '''Source String''' column.
# Use the file locking feature reasonably and do not lock a file for longer than is necessary. If you know you will not be able to finish your work in one go, you can submit a partially complete translation and come back to it when you have more time to spare.
# Last but not least, remember that Transifex is based on team work. Treat fellow team members as you would like to be treated by them; it is not about competition, it is about cooperation with others and working together to achieve a common goal.