Git からのダウンロード

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

Outdated translations are marked like this.
Other languages:
aragonés • ‎العربية • ‎asturianu • ‎تۆرکجه • ‎беларуская (тарашкевіца)‎ • ‎български • ‎català • ‎čeština • ‎dansk • ‎Deutsch • ‎Ελληνικά • ‎English • ‎Esperanto • ‎español • ‎euskara • ‎فارسی • ‎suomi • ‎français • ‎galego • ‎Hawaiʻi • ‎עברית • ‎hrvatski • ‎magyar • ‎Հայերեն • ‎Bahasa Indonesia • ‎Interlingue • ‎italiano • ‎日本語 • ‎ქართული • ‎Taqbaylit • ‎한국어 • ‎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 を参照してください。以下は、よく行う作業のいくつかを簡易的に示したものです。

要件[edit]

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

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

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

ダウンロード[edit]

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

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

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

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

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

開発向けダウンロード[edit]

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

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

外部ライブラリの取得[edit]

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バージョンにあった適切なブランチを利用していることを確認してください(例えばバージョン1.25には REL1_25 です)。

MediaWiki の特定のバージョン[edit]

WMF ブランチ[edit]

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

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

git branch -r | sort -V

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

git checkout -b REL<リリース番号> origin/REL<リリース番号>

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

git checkout -b REL1_29 origin/REL1_29
MediaWiki タグ (安定バージョン)[edit]

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

git tag -l | sort -V

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

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

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

git checkout <タグ名>

MediaWiki の最新の開発バージョン[edit]

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

git checkout master


最新の状態に保つ[edit]

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コマンドがあります。

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

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

git checkout <ブランチ名>

または

git checkout <タグ名>

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

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

Git 内の拡張機能の一覧

拡張機能のダウンロード[edit]

<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://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=master

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

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_29 origin/REL1_29 || :'

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

拡張機能の除去[edit]

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

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

git の外装のリスト

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

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

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

関連項目[edit]