Revision as of 17:23, 16 November 2011

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 CKEditor localization project on Transifex. Transifex is an online platform that allows projects to make use of 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/start/
• Transifex documentation: http://help.transifex.net/index.html
• 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 CKEditor project on Transifex currently includes the following translatable resources:

• core – the language strings of the main CKEditor application;
• plugin-a11yhelp – the language strings of the CKEditor Accessibility Help;
• plugin-devtools – the language strings of the optional Developer Tools plugin;
• plugin-placeholder – the language strings of the optional Placeholder plugin;
• plugin-specialchar – the language strings of the Special Characters plugin;
• plugin-uicolor – 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:

1. Register on the Transifex website.

   You can sign up for free by using the "Free Plan" option. You will be redirected to the 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.

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

3. Join a CKEditor translation team.

   Go to the translation teams page on the project's site and see the list of available language teams. If you find a suitable one, join it. If not, 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 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.

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.

Team waiting list in Transifex

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

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.

Team members list in Transifex

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

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

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

Requesting a new team in Transifex

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

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.

Pending team requests in Transifex

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

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.

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.

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.

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

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.