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. In package managers, the version may be of too low a version to fulfil 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 making any releases. You should get the latest version from Subversion 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. These are described in a file called README in the extension's directory.

Requirements
The following software is required to install this extension:


 * 1) MediaWiki 1.17 (some features do not work), 1.18 or the development version (trunk)
 * 2) MySQL database
 * 3) (optional) PHPlot for statistics graphs
 * 4) (optional) Syck for YAML support (spyc is used if syck is not available)
 * 5) (optional) Tmserver 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 bytecode caching with for example APC is recommended in a production environment.

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

This is recommended, because the code is very regularly updated with new features and bug fixes. Also, only the latest version is currently supported, due to the lack of resources. It is easy to update this way, only  in the Translate directory is needed.

At this point you may also want to install other recommended extension:
 * Babel – Allows users to indicate which languages they speak
 * CleanChanges – Cleaner recent changes
 * CLDR – Localised language names and other data in many languages
 * Replace text – Do mass replacements in translations.
 * Narayam and WebFonts – Input method and font support for many languages.

Activating the extension
After the code has been placed into the correct directory, all that is needed is a line similar to this in : Now you should run  or the web installer again to add database tables used by the extensions.

After that line it is possible to add configuration settings that enable new features or change the way the extension works. See Configuration for a description of these settings. See also page for Page translation administration for configuring the page translation feature.