Help:Extension:Translate/Installation

Documentation for Extension:Translate

Translators (main help page )

• How to translate
• Best practices
• Statistics and reporting
• Quality assurance
• Message group states
• Offline translation
• Glossary

Translation administrators

• How to prepare a page for translation
• Page translation administration
• Unstructured element translation
• Group management
• Move translatable page
• Import translations via CSV
• Working with message bundles

Sysadmins and developers

• Installation
• Configuration
• Getting started with development
• Developer guide
• Extending Translate
• Validators
• Insertables
• Group configuration
• Group configuration example
• Translation memories
• Translation aids
• Enabling message bundles
• PHP hooks

Translate this template

The Translate extension, due to its nature of rapid development, requires a relatively recent version of MediaWiki to work. The aim is to support the development version and the two latest stable versions of MediaWiki. In package managers, the version may be too old to fulfill the requirements. In that case you need to download a newer release from mediawiki.org or from Wikimedia's Git repository.

The Translate extension uses a continuous development model, which means that latest version should never be totally broken, because all commits to Translate extension are peer reviewed and pass unit tests. The core functionality is pretty stable, but there may be bigger changes from time to time.

Requirements

The following software is required to install this extension:

1. Recent version of MediaWiki
2. SQL database. MariaDB is recommended. We don't test other database engines, but they should mostly work thanks to the database abstraction layer in MediaWiki.
3. Extension:UniversalLanguageSelector (included in MediaWiki Language Extension Bundle )
4. (optional) Phpyaml for faster and better YAML parsing and generation
5. (optional) ElasticSearch for advanced search features and translation memory
6. (optional) Internet access on the server for machine translation services

PHP must be installed with the curl module to allow for the translation suggestion feature.

MediaWiki needs to have the job queue set up correctly. If your job queue is not processed, nothing will work in Translate.

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

The use of memcached for caching and for example APC PHP accelerator is recommended in a production environment.

Installation instructions

Go to MediaWiki Language Extension Bundle for download links and instructions. The bundle includes additional extensions commonly used together with the Translate extension. It also includes a functioning default configuration to get you started. See Help:Extension:Translate/Configuration for a description of the settings.