MediaWiki Language Extension Bundle

From MediaWiki.org
Jump to: navigation, search
shortcut: MLEB

The MediaWiki language extension bundle provides easy way to bring ultimate language support to your MediaWiki. The bundle is a collection of selected few MediaWiki extensions needed by any wiki which desires to be multilingual.

Introduction [edit]

Contents

The Universal Language Selector is a must have, because it provides an essential functionality for any user regardless of the number of languages they speak: language selection, font support for displaying scripts badly supported by operating systems and input methods for typing languages that don't use the Latin alphabet.

Maintaining multilingual content in a wiki is a mess without the Translate extension, which is used by Wikimedia, KDE, translatewiki.net and other sites, where hundreds of interface translations are updated every day. With Localisation Update your users will always have the latest translations freshly out of the oven. The Clean Changes extension keeps your recent changes page uncluttered from translation activity and other clutter.

Don't miss the chance to practice your rusty language skills, use the Babel extension to mark the languages you speak and find other speakers of the same language in your wiki. And finally the cldr extension is a database of language and country translations.

MLEB has a monthly release schedule, so that you can easily stay on the cutting edge with the constantly improving language support. The bundle comes with clear installation and upgrade instructions (see below). The bundle is tested against MediaWiki release versions, so you can avoid most of the temporary breaks that would happen if you were using the latest development versions instead.

Download [edit]

Tarball [edit]

Latest release [edit]

Previous releases [edit]

Via Git [edit]

In your extensions directory do the following to get or update to the latest release and follow configuration instructions below.

 for ext in Babel cldr CleanChanges LocalisationUpdate Translate UniversalLanguageSelector
 do
   if [ ! -d "$ext" ]
   then
     git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/$ext.git
   fi
   cd $ext; git fetch --tags; git checkout 2013.03; cd ..
 done

Installation [edit]

Layout: ./mediawiki/extensions/{A,B,C} [edit]

Go to mediawiki directory and extract the release file:

tar xjf MediaWikiLanguageExtensionBundle-2013.03.tar.bz2

Your extension variable is

$EXT = "$IP/extensions";

Layout: ./mediawiki/ ./extensions/{A,B,C} [edit]

Go to common parent directory and extract the release file:

tar xjf MediaWikiLanguageExtensionBundle-2013.03.tar.bz2

Your extension variables are:

$EXT = "$IP/../extensions";
$wgExtensionAssetsPath = "{$wgScriptPath}/../extensions";

Add/update your LocalSettings.php [edit]

Near the end, place the config lines given above followed by this:

require_once( "$EXT/Babel/Babel.php" );
 
require_once( "$EXT/cldr/cldr.php" );
 
require_once( "$EXT/CleanChanges/CleanChanges.php" );
$wgCCTrailerFilter = true;
$wgCCUserFilter = false;
$wgDefaultUserOptions['usenewrc'] = 1;
 
require_once( "$EXT/LocalisationUpdate/LocalisationUpdate.php" );
$wgLocalisationUpdateDirectory = "$IP/cache";
 
require_once( "$EXT/Translate/Translate.php" );
$wgGroupPermissions['user']['translate'] = true;
$wgGroupPermissions['user']['translate-messagereview'] = true;
$wgGroupPermissions['user']['translate-groupreview'] = true;
$wgGroupPermissions['user']['translate-import'] = true;
$wgGroupPermissions['sysop']['pagetranslation'] = true;
$wgGroupPermissions['sysop']['translate-manage'] = true;
$wgTranslateDocumentationLanguageCode = 'qqq';
$wgExtraLanguageNames['qqq'] = 'Message documentation'; # No linguistic content. Used for documenting messages

require_once( "$EXT/UniversalLanguageSelector/UniversalLanguageSelector.php" );
If you have existing babel categories, you need to check that the configuration matches your wiki's format. See Extension:Babel.

Update database tables [edit]

Commandline [edit]

In the directory where your LocalSettings.php is located, run the following command:

php maintenance/update.php

Webbrowser [edit]

Go to example.com/mediawiki/mw-config/ by using your domain and path and rerun install.

Configuring LocalisationUpdate [edit]

If you are on unix like system, you should add LocalisationUpdate to crontab:

crontab -e
# Add the following line
@daily php /path/to/your/wiki/extensions/LocalisationUpdate/update.php --quiet
Retrieved from "http://www.mediawiki.org/w/index.php?title=MediaWiki_Language_Extension_Bundle&oldid=681904"