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)、およびウィキメディア財団のサーバー クラスターに現在インストールされているすべての拡張機能、$girritで提供されている他の多くの拡張機能をダウンロードできます.

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

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

この方法では MediaWiki コアのリポジトリ全体を  という名前のサブ ディレクトリに clone します. 他のディレクトリにインストールするには、コマンドラインにそのことを書き加えてください(詳しい情報は これらのドキュメントを参照してください). 既定の「ブランチ」は MediaWiki の開発者向けの最先端のバージョンです. リポジトリをひとたび clone すると、別のブランチやタグに簡単に切り替えられます (下記参照). これらのブランチやタグは MediaWiki の安定バージョンを追跡しているものも含んでいます. clone する版の数を抑えるには、上記のコマンドに と書き加えます.

開発向けダウンロード
開発者アクセスをお持ちの場合 (開発者アクセスは簡単に申請できます)、httpsで匿名にcloneするよりも、ssh ""を利用してcloneし、変更をreviewに提出できるようにしたほうがいいでしょう.



外部ライブラリの取得
MediaWiki 1.25 以降、MediaWiki が必要とする一部の外部ライブラリは、この「core」リポジトリには含まれなくなりました. 外部ライブラリの管理にはComposerを使用します. これらの必要なライブラリをインストールするには、以下の選択肢があります:


 * composer をダウンロードおよびインストールして、core ディレクトリに移動して、 composer install --no-dev を実行します. 既存の   ファイルがある場合は代わりに composer update --no-dev を実行する必要があることにご注意ください.


 * Mozilla Composer 遣いたくない場合、あるいは WMF 生産クラスタで使ったのと同じベンダ・ライブラリを使いたい場合、 git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git して MediaWiki インストレーションのコアフォルダに ライブラリを作ります.  あなたのMediaWikiバージョンにあった適切なブランチを利用していることを確認してください(例えばバージョン1.25には REL1_25 です).

WMF ブランチ
リモート ブランチは、ウィキメディア財団のサーバー クラスターで使用されている MediaWiki のバージョン群を追跡します. これらが完全に安定しているとは限りませんが、バグ修正が非常に素早く行われるため、全般的に充分に安定しています - これらのバージョンは、ウィキペディアのような主要なプロジェクトが使用しています. REL* ブランチが充分に「安定している」(stable) と考えられる場合は、そのバージョンにタグを付けて、その内容を tar アーカイブでリリースします.

利用できるブランチを列挙するには、あなたの MediaWiki coreのあるディレクトリに移動して以下のコマンドを実行します:

メジャー リリースは「origin/REL 」の形式です (例:「origin/」). 特定のリリース ブランチに切り替えるには以下を実行します:

例えば、現行の安定バージョン に切り替えるには、以下を入力します:

MediaWiki タグ (安定バージョン)
一方、MediaWiki の特定の安定バージョンは「タグ」で追跡されています. これらの内容は tar アーカイブ リリースと似ています. 以下のようにしてバージョンを列挙できます:

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

特定のタグを使用するには:

MediaWiki の最新の開発バージョン
MediaWiki の最新の開発バージョンは、「master」ブランチで追跡されています. これは、MediaWiki リポジトリを clone した際にデフォルトで checkout されるブランチです. 別のブランチに切り替えた場合は、以下を実行して最先端の MediaWiki に切り替えることもできます:

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

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

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

さらに、更新/アップグレード後には、データベースを更新するため MediaWiki の  コマンドラインスクリプトを必要に応じて実行してください.

mediawiki/vendorをより新しいバージョンの必須ライブラリに更新する必要があるかもしれません. 外部ライブラリの取得をご覧ください.

MediaWiki-Vagrantを利用している場合は、これらのステップすべてを実行してくれる vagrant git-update コマンドがあります.

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

または

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

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

 * Git 内の拡張機能の一覧

拡張機能のダウンロード

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

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

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

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

 https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/.git;a=tree;h=refs/heads/master;hb=master

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

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

特定のブランチを追跡するには:

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

拡張機能の除去
拡張機能のフォルダーを除去して、「 」を  から除去するだけです.

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

 * git の外装のリスト

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

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

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

関連項目

 * SVN から Git への移行
 * ナイトリー - Git からのダウンロードの代替