Help:Extension:Translate/Installation

Due to the nature of rapid development of the Translate extension, it requires a relatively recent version of the software to work. All distributions may not have stabilised such new packages to fulfill the requirements. In that case you need to download later a release from mediawiki.org or from Wikimedia's Subversion repository.

The Translate extension is using a continuous development model, which means we are not doing any releases. You should get the latest version from svn and update from time to time to get new features and bug fixes. The core functionality is pretty stable, but there may be bigger changes from time to time. We might start doing actual releases if there is enough interest.

Requirements
The following software is required to install this extension:


 * 1) MediaWiki 1.17 (some features don't work), 1.18 or the development version (trunk)
 * 2) MySQL database
 * 3) PHPlot (optional) for statistics graphs
 * 4) Syck (optional) for YAML support (spyc is used if syck is not available)
 * 5) Tmserver (optional) from translatetoolkit for the translation memory
 * 6) Internet access on the server for machine translation services

In addition, shell access is required to run maintenance scripts.

Using caching with memcached and for example APC, as well as using the $wgLocalisationCacheConf is recommended in production environment.

Getting the source
The recommended way to get the Translate extension is to use svn. svn co http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Translate
 * 1) at mediawiki extension folder

This is the suggested way, because the code is in constant change and new features and bugfixes are made often. Also, only the latest version is currently supported, due to the lack of resources. It is easy to update this way, only svn up in the Translate directory is needed.

At this point you may also want to install other recommended extension:
 * Extension:Babel – Allows user to indicate which languages they speak
 * Extension:CleanChanges – Cleaner recent changes
 * Extension:CLDR – localised language names and other data in many languages

Activating the extension
After the code has been put into the known place, all that is needed is a line similar to this in the LocalSettings.php that lies in MediaWiki's root directory:

After that line it is possible to add configuration settings that enable new features or change the way the extension works. See Configuration how to do this. See also page for Page translation feature, which needs further steps.