Download from Git/ja


 * MediaWiki 1.19beta2, 1.18.2, 1.17.3 以降、MediaWiki コアおよび拡張機能は、バージョン管理に Git を使用しています. これらより古いバージョンについては Subversion を参照してください. 

Git は分散型バージョン管理ソフトウェアであり、パッケージ化を待たずに、利用者がブランチの「最新の」バージョンをダウンロードできる仕組みです. これにより MediaWiki はより素早くリリースでき、利用者はインストールしたソフトの更新やアップグレードの巻き戻し、パッチの投稿をもっと容易に実行できます. (もちろん、安定性は公式の安定バージョンの方が常に高いことはお忘れなく. )

詳細情報は、特に貢献をするにはGit を参照してください. 基本作業のいくつかは、以下に概要を示します.

要件
使用するにはまず Git をインストールしてください. Git はさまざまな方法で取得できますが、ご使用中のオペレーティング システムに依存します. ソースコードおよび公式のバイナリについては、git-scm.com を参照してください. Git をインストールするその他の方法については、ご使用中のオペレーティング システム用の手順を検索エンジンで見つけてください.

サードパーティーのライブラリをダウンロードするには、Composer のインストールをお勧めしますが、必須ではありません.

ダウンロード
Git を使用すると MediaWiki コア (SVN の phase3)のほか、ウィキメディア財団のサーバー クラスタ上に現在インストールしてある拡張機能のすべてと、その他で提供する多くの拡張機能をダウンロードできます.

まず、MediaWiki のコア リポジトリを clone (クローン、複製) します. これには時間が掛かる場合があります.

ターミナル画面で、以下のコマンドを入力してください:

これは、MediaWikiコアリポジトリ全体を と名づけたサブディレクトリにクローンするため、まず最初にリリースブランチ に取り掛かるという手順です.

インストール先のディレクトリを変更するには、コマンドラインに保存先を書き込みます（手順の詳細は外部の説明文書を参照してください. ）リポジトリがクローンされると簡単に異なるブランチやタグ（下記参照）に切り替えできる代わり、MediaWikiの不安定なバージョンを追跡するものも対象になってしまいます. そこで、開発ブランチ  は最先端の開発者向けMediaWikiですが安定しているとはみなさず、どのような状況下でも絶対にマスターコードを本番用環境に使用してはいけません.

クローンするリビジョンの数を減らしたい場合は、上記のコマンドに を追加します.

その理由はリリースブランチには大量のGitサブモジュールがあるからで、よく使用される拡張機能や外装が含まれます（マスターブランチにはないもの）. サブモジュールの更新は、次のコマンドを実行します.

開発向けダウンロード
開発者アクセス権をお持ちの場合 (開発者アクセス権は簡単に申請できます)、https接続で匿名利用者として実行するよりも、セキュアシェル プロトコルssh「<利用者名>」経由でクローンし、変更を査読に提出できるようにしてください.



外部ライブラリの取得
MediaWikiが外部PHPライブラリの管理に使うComposerは、どの場合もご使用のMediaWikiディレクトリの ディレクトリを参照します.

これらの必要なライブラリをインストールするには、以下の選択肢があります:


 * 推奨される手順とは、composer をダウンロードしてインストールし、ローカルの MediaWiki ディレクトリに移動して  を実行する方法です.


 * あるいはまた、Mozilla Composer を使いたくない場合、もしくはWMF 生産クラスタで使ったベンダ・ライブラリをそのまま使いたい場合、 を実行して MediaWiki インストレーションのコアフォルダに   ディレクトリを作ります. もし拡張機能ごとに独自のComposer要件が設定されていると、このオプションは適合しません.

外部ライブラリはMediaWiki 1.25 以前、コアのリポジトリに保管され、パッケージマネジャは不要でした.

MediaWiki タグ (安定バージョン)
一方、MediaWiki の特定の安定バージョンは「タグ」で追跡されています. これらの内容は tar アーカイブ リリースと似ています. 現存するバージョンは (安定)と (LTS) および (レガシー) です.

使用できるタグの一覧はこちら:

(Mac OS X などで) 非 GNU の sort コマンドを使用する場合、古い形式の区切りを指定します:

特定のタグを使用する方法. たとえば現状の最新リリースは:

MediaWiki の最新の開発バージョン
MediaWiki の最新の開発バージョンは、「master」ブランチで追跡されています. これは、MediaWiki リポジトリをクローンした際に既定で検査するブランチです. 別のブランチに変更してあるけれど、最先端の MediaWiki に切り替えるには、以下を実行します:

最新の状態に保つ
MediaWiki の特定のブランチまたは開発バージョン (「master」ブランチ) を使用している場合は、最新の変更点の入手は割合に簡単です. ご利用の MediaWiki の複製ディレクトリに移動して、  コマンドを実行してください:

ご使用中のブランチに対する最新の変更点がすべて適用されます.

新しいバージョンの core には場合によって新しい拡張機能や外装が必要なため、拡張機能やスキンごとにそれぞれのディレクトリに移動し、 といったコマンドでそれらを更新しなくてはいけません.

さらに を必須ライブラリのより新しいバージョンに更新する必要があります. 多くの場合、下記の Composer コマンドを実施するのですが、手順は前述の外部ライブラリの取得を参照します.

そしてコードと必須ライブラリの更新/アップグレード後は、データベース・テーブルの更新が求められるため、引きつづき MediaWiki のコマンドラインスクリプト  を実行します.

MediaWiki-Vagrant を利用している場合は、これら一連の手順を一度で実行してくれる  コマンドがあります.

別のバージョンへの切り替え
MediaWiki の別のバージョンへの切り替えは、SVN と比較して Git では遥かに簡単です. 各バージョンはブランチやタグで追跡されています. これらのいずれかに切り替える手順は、あなたの MediaWiki clone ディレクトリ内で、お好みのブランチやタグを「checkout」するだけです.

または

変更内容が自動的に適用され、すべてすぐに使用できる状態になります.

MediaWiki 拡張機能のダウンロードに Git を使用

 * Git 内の拡張機能の一覧

拡張機能のダウンロード

 *  を、ダウンロードしたい拡張機能の名前に読み替えてください (空白は不要です). 例えば拡張機能 Extension:TitleKey の場合は TitleKey になります. (大文字小文字は区別されます!)

拡張機能を Git からダウンロードおよび clone します:

開発者は以下で clone します:

Gerrit's gitilesアプリケーションやURLから拡張機能のソースコードを見ることができます.

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master

すべての拡張機能のダウンロード
gerrit.wikimedia.org にある すべての MediaWiki 拡張機能をあなたのマシンに checkout したい場合は、以下を実行します:

すべての拡張機能をそのブランチの最新版に更新する手順は、以下を入力するだけです:

新しいリリース後など、別のブランチに変更するには:

そのバージョンのMediaWikiと同じリリースの拡張機能のみを使用してください.

マスターブランチを追跡するには:

安定しているとは考えられないため、どのような状況下でも、本番用環境にマスターコードを使用すべきではありません.

読み取りだけのチェックアウトが必要であれば(例えばMediaWikiコード全体を検索、分析するとき)、Labsにある共有MediaWikiチェックアウトを利用すれば、あなたのコンピュータへダウンロードしなくても済みます.

拡張機能の除去

 * 1) LocalSettingsを開き、「 」または「 」を削除.
 * 2)  内で拡張機能を参照する行をすべて削除 (通常は「extra → merge-plugin → include」の手順に従う)
 * 3)  から拡張機能のディレクトリを削除.

MediaWiki 外装のダウンロードに Git を使用

 * git の外装のリスト

Gitのダウンロードにおいて、MediaWiki 1.24以降では、外装が含まれていません.

拡張機能の場合とまったく同じ手順を踏んでください (前の節で解説). ただしどの URL でもパスでも、 を   の代わりに使います.

手順についての詳細情報は、ここ MediaWiki.org 上のそれぞれの外装のページにあります (例: Skin:Vector#インストール). 他のどの外装の手順も類似しています.

関連項目

 * SVN から Git への移行
 * ナイトリー - Git からのダウンロードの代替
 * Intranet/Intranet Installation - Git を使った Mediawiki の配布法を記述した、よく練られた記事の一部