MediaWiki 言語拡張機能バンドル

This page is a translated version of the page MediaWiki Language Extension Bundle and the translation is 100% complete.


MediaWiki 言語拡張機能バンドル (MLEB) はキュレーションに合格した MediaWiki 拡張機能一式で多言語機能を提供します。 この機能の目的は、MediaWiki に手軽な言語サポートを提供することです。

拡張機能の概要

現バージョンの MLEB には下記の拡張機能が含まれています:[1]

MLEB は、新しい MediaWiki リリースの後に半年ごとにリリースされ、最新の MediaWiki バージョンのみをサポートします。 最新の MediaWiki 更新との整合性をテストしてありますので、それぞれの拡張機能の最新開発バージョンを使っても、起こりがちなトラブルを回避できます。

インストールすべき理由

ユニバーサル言語選択はぜひ入れておくべきです。なぜならユーザが話す言語の数に関わらずあらゆるユーザにとって不可欠な機能を提供するからです。言語選択機能とフォントサポート機能は一般的なオペレーティングシステムではうまくサポートされていない文字を表示するための、入力メソッド機能はラテンアルファベットを使わない言語を入力するための機能を提供します。 これにはアメリカ、ヨーロッパ、中東、インド、東南アジアの主要言語のほとんどをカバーするフリーライセンスフォントを収録しています。

ウィキにおいて、ウィキメディア財団、KDE、translatewiki.net などのサイトで使われているTranslate拡張機能を使うことなく多言語コンテンツを維持するのは面倒です。

CleanChanges 拡張機能は、最近の更新ページから翻訳活動などの雑多なものを取り除きすっきりとした状態に保ちます。

錆びついた語学力を鍛えるチャンスをお見逃しなく。Babel 拡張機能を使ってあなたが話す言葉をマークし、ウィキで同じ言語を話す他の人を見つけてください。 そして最後に、CLDR 拡張機能は言語と国の翻訳データベースです。

リリースノートとダウンロード

最新リリース

Highlights
  • Future releases of MLEB will no longer include the CleanChanges extension. The Language filter has been integrated into the Translate extension. The User filter will be deprecated; use the standard Special:Contributions page as an alternative.
    • To enable the language filter on Special:RecentChanges, set $wgTranslateRecentChangesLanguageFilter = true;
2024.07
Highlights
  • As per discussion on phab:T356847 this is the last release to support MediaWiki 1.41 and MediaWiki 1.42. Moving forward, MLEB will be released semi-annually after the new MediaWiki release and will only support the latest MediaWiki version.
  • Support has been dropped for MediaWiki 1.40. MLEB 2024.07 supports >= MediaWiki 1.41.

Previous releases

2024.04
Highlights
  • We're planning to make changes to how and when we release MLEB. You can read more about it on phab:T356847 and leave your comments.
2024.01
Highlights
  • MediaWiki Language Extension Bundle 2024.01 no longer supports MediaWiki 1.39 and requires MediaWiki 1.40+.
  • The hook Translate:GettextFFS:headerFields has been deprecated, use Translate:GettextFormat:headerFields instead.
2023.12
Highlights
  • Translate extension: Fix broken Special:SpecialPages for MediaWiki 1.40, and 1.39 (T351959).
2023.10
Highlights
  • Translate extension: Removed mirrors option when providing configuration for translation memory.
2023.07
Highlights
  • This release of MLEB now requires MediaWiki >= 1.39
2023.04
Highlights
  • This is the last release of MLEB supporting MediaWiki >= 1.38
2023.01
Highlights
  • MLEB now requires PHP >= 7.4 and MediaWiki >= 1.38
2022.10
Highlights
  • [SECURITY] Translate extension: Adds missing block checks to various pages and API (T302479, Gerrit change 838940)
  • This will be the last MLEB release supporting PHP 7.3 and MediaWiki 1.37
2022.07
LocalisationUpdate
  • LocalisationUpdate extension is removed from MediaWiki Language Extension Bundle. Please read the announcement.
Translate extension
  • Support for MediaWiki 1.36 has been dropped.
  • Avoid recreation of translation pages on bulk deletion of pages, for example when using the Nuke extension. (T291724, Gerrit change 799383)
  • Fix "Impossible to mark pages for translation using the mobile site". (T311631, Gerrit change 809970)
2022.04
LocalisationUpdate
  • We're planning to sunset the LocalisationUpdate extension from version 2022.07. Please read the announcement.
Translate extension
  • If you are using translation memory with ElasticSearch backend, we recommend rebuilding the translation memory index. This can be done by running php <path_to_mediawiki_core>/extensions/Translate/scripts/ttmserver-export.php

Show all releases .

Git でのダウンロード

extensions ディレクトリで、以下の手順にしたがって最新リリースの取得または更新を行い、以下の指示にしたがい設定を行ってください。

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


Installation

Installation requirements

Installation requirements of each piece of provided software are included in the respective documentation. See in particular the installation requirements.

Add/update your LocalSettings.php

Near the end of LocalSettings.php, you have to place this configuration:

wfLoadExtension( 'Babel' );

wfLoadExtension( 'cldr' );

wfLoadExtension( 'CleanChanges' );
$wgCCTrailerFilter = true;
$wgCCUserFilter = false;
$wgDefaultUserOptions['usenewrc'] = 1;

wfLoadExtension( 'Translate' );
$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

wfLoadExtension( 'UniversalLanguageSelector' );

Update database tables

Command line

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

php maintenance/run.php update

Web browser

Go to example.com/mediawiki/mw-config/ (see Manual:Upgrading#Web browser) by using your domain and path and rerun install.

Configuring and using extensions

See the respective extension documentation pages.

背景

MLEB はバージョン依存性のある拡張機能ブランチは使っていません。 これは、MLEB がリリースされる時点で最新の MediaWiki リリースで動作することが検証されたマスターからのスナップショットです。

MLEB リリースは Melange と呼ばれるツールを使ってつくられています。 そのコードに (コードを変更したいなど) 関心があるなら、GitMelange リポジトリを参照してください。 サポートが終わった PHP のバージョンはサポート対象から外すかもしれませんが、私たちがサポートしているいずれの MediaWiki バージョンも、少なくとも1つの PHP バージョンで動作するようにします。

参考資料

  1. 2022年7月の公開以降、LocalisationUpdate は MLEB から外されています。