Git からのダウンロード

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Download from Git and the translation is 100% complete.

Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎हिन्दी • ‎hrvatski • ‎magyar • ‎Հայերեն • ‎interlingua • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎Kurdî • ‎Lëtzebuergesch • ‎lietuvių • ‎Bahasa Melayu • ‎Napulitano • ‎नेपाली • ‎Nederlands • ‎occitan • ‎polski • ‎پښتو • ‎português • ‎português do Brasil • ‎română • ‎русский • ‎sicilianu • ‎Scots • ‎سنڌي • ‎slovenčina • ‎српски / srpski • ‎svenska • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎Türkçe • ‎татарча/tatarça • ‎ئۇيغۇرچە • ‎українська • ‎Tiếng Việt • ‎ייִדיש • ‎粵語 • ‎中文
MediaWiki 1.19beta2, 1.18.2, 1.17.3 以降、MediaWiki コアおよび拡張機能は、バージョン管理に Git を使用しています。これらより古いバージョンについては Subversion を参照してください。

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

特に貢献 (パッチの投稿) についての詳細は、Git を参照してください。以下は、よく行う作業のいくつかを簡易的に示したものです。

要件

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

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

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

ダウンロード

現在、Git を使用して、MediaWiki コア (SVN の phase3)、およびウィキメディア財団のサーバー クラスターに現在インストールされているすべての拡張機能、$girritで提供されている他の多くの拡張機能をダウンロードできます。

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

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

git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

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

開発向けダウンロード

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

git clone ssh://<利用者名>@gerrit.wikimedia.org:29418/mediawiki/core.git

外部ライブラリの取得

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

  • composer をダウンロードおよびインストールし、ローカルの core ディレクトリに移動して composer install --no-dev を実行します。 既存の composer.lock ファイルがある場合は、代わりに composer update --no-dev を実行する必要があることにご注意ください。
  • Mozilla Composer を遣いたくない場合、あるいは WMF 生産クラスタで使ったのと同じベンダ・ライブラリを使いたい場合、git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git して MediaWiki インストレーションのコアフォルダに vendor/ ディレクトリを作ります。
MediaWiki タグ (安定バージョン)

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

git tag -l | sort -V

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

git tag -l | sort -n -t. -k1 -k2 -k3

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

git checkout <タグ名>


MediaWiki の最新の開発バージョン

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

git checkout master


最新の状態に保つ

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

git pull

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

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

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

php maintenance/update.php

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

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

別のバージョンへの切り替え

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

git checkout <ブランチ名>

または

git checkout <タグ名>

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

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

Git 内の拡張機能の一覧

拡張機能のダウンロード

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

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

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/<EXT>.git

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

git clone ssh://<利用者名>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>.git

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

https://phabricator.wikimedia.org/r/p/mediawiki/extensions/<EXT>;browse/master/

すべての拡張機能のダウンロード

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

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions.git
cd extensions
git submodule update --init --recursive

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

cd /path/to/extensions
git pull
git submodule update --init --recursive

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

git submodule foreach 'git checkout -b REL1_30 origin/REL1_30 || :'

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

拡張機能の除去

拡張機能のフォルダーを除去して、「require_once …」または「wfLoadExtension( … )」を LocalSettings.php から除去するだけです。

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

git の外装のリスト

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

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

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

関連項目