User:Cacycle/wikEd international

This page explains how to install and to create translations for the MediaWiki editor wikEd.

List of existing translations
The following existing translations are automatically loaded, following the default language of the respective wiki. Please see below for how to continue a no longer maintained translation.

Installation
In general, it is not required to explicitly install a translation. wikEd automatically detects the language settings by checking the variables  (user preferences) and   (wiki default language) and loads one of the above existing translations.

It is possible to force another translation by adding the following line to your User:YourUsername/common.js page:

var wikEdConfig = {}; wikEdConfig.languageDefault = 'en';

Replace 'en' for English with the respective language code and click Shift-Reload to update after saving your edit. This also works to explicitly define the language for older MediaWiki installations which do not send their language settings.

On wikis that have no connection to the internet you have to install the following code on your User:YourUsername/common.js page:

var wikEdConfig = {}; wikEdConfig.translations = { 'en': 'http://en.wikipedia.org/w/index.php?action=raw&ctype=text/javascript&title=User:Cacycle/wikEd_international_en.js' };

Replace 'en' with the respective default language of the wiki (check the source of a wiki page for ) replace the  translation address. Click Shift-Reload to update after saving your edit.

Alternatively, you can add a translation the old fashioned way as follows:

// install the English translation for en:User:Cacycle/wikEd mw.loader.load('//en.wikipedia.org/w/index.php?title=User:Cacycle/wikEd_international_en.js' + '&action=raw&ctype=text/javascript'); var wikEdConfig = {}; wikEdConfig.loadTranslation = false; // do not try to automatically load a translation

On older non-Wikipedia wiki installations please use instead:

// install the English translation for en:User:Cacycle/wikEd document.write('<\/script>'); var wikEdConfig = {}; wikEdConfig.loadTranslation = false; // do not try to automatically load a translation

Replace  with the respective translation address and click Shift-Reload to update after saving your edit.

Translation guide
You are encouraged to translate wikEd into other languages. Here is a how-to:

// install the (Language) translation for en:User:Cacycle/wikEd mw.loader.load('//en.wikipedia.org/w/index.php?title=User:YourUsername/wikEd_international_xx.js' + '&action=raw&ctype=text/javascript');
 * 1) Copy the English example translation from User:Cacycle/wikEd_international_en.js. You can also continue a no longer maintained translation.
 * 2) * Please do not translate the comment lines starting with "//" in order to make maintenance easier
 * 3) * Please turn wikEd off on the the translation page in order to preserve the indention tabs
 * 4) * The first string is the internal text name and must not be changed
 * 5) * The second string after the colon is the text to be translated
 * 6) * The button alt text is displayed only when the button images are not available—it should be as short as possible
 * 7) * The button title text is the popup tooltip text hat appears upon hovering over a button
 * 8) * Every line beside the last one ends with a comma
 * 9) * Every ' character has to be written as \'
 * 10) * Do not change the {wikEd...} parts as these are dynamically replaced
 * 11) * Missing translations are displayed in their English built-in version
 * 12) Save the translation under the following link: User:YourUsername/wikEd_international_xx.js (replace xx by the language code of your translation). If you do not already have an user account on the English Wikipedia please create one. It is essential that the translation page name is in your personal userspace and ends in .js for security reasons so that only you and administrators can edit it. For the same reason you must use a strong password for your account! If you start from an existing translation, please link to that original source in your edit summary.
 * 13) Load your translation into wikEd by adding the following code to your User:YourUsername/common.js page:
 * On older non-Wikipedia wiki installations please use instead:

// install the (Language) translation for en:User:Cacycle/wikEd document.write(' ');
 * Replace User:YourUsername/wikEd_international_xx.js by the actual page name of the translation (or replace the whole web address if your translation is not on Wikipedia)
 * 4. Update your installation by pressing Shift-Reload
 * 5. Check for JavaScript errors in your browser's error console (under Tools). Commonly, errors are caused by missing or wrong commas, semicolons, or parentheses.
 * 6. Optionally: You can check for missing translations by temporarily adding the following code to your User:YourUsername/common.js page:

var wikEdConfig = {}; wikEdConfig.showMissingTranslations = true;
 * 7. Please post a note to the wikEd discussion page in order to add the translation link into the program code and to update this page

Updates and changes
Usually Cacycle will add changes directly to the translation pages in English so that you can update your translation. Please check into your English Wikipedia account from time to time for updates to be translated.

Language-specific settings
The following language-specific settings can be added to your User:YourUsername/common.js page. Click Shift-Reload to update after saving your edit.


 * Use French rules for the punctuation fixing button [[Image:WikEd_fix_punct.png|16px|Fix punctuation]] :

var wikEdConfig = {}; wikEdConfig.fixPunctFrench = true;

AutoWikiBrowser RegExTypoFixer
Common typos can be fixed using AutoWikiBrowser RegExTypoFix rules. wikEd uses the English RegExTypoFix rules by default. To enable the feature and to switch to a different translation add the following lines to your User:YourUsername/common.js page:

var wikEdConfig = {}; wikEdConfig.regExTypoFix = true; wikEdConfig.regExTypoFixURL = 'http://en.wikipedia.org/w/index.php?title=Wikipedia:AutoWikiBrowser/Typos&action=raw';