Download from Git/zh


 * 从 MediaWiki 1.19beta2, 1.18.2, 1.17.3起, MediaWiki核心部分与扩展开始使用Git版本管理软件. 对于较旧的版本，请使用Subversion

Git是一个分布式版本控制软件，它允许用户获得最新的软件分支而不必等待应用开发者封包. MediaWiki可以更快的发行，同时让安装版本升级、回滚升级和提交Bug更方便. （当然官方发布版更稳定. ）

查看Git了解更多，特别是如何提交你对MediaWiki的更改，下面是一些常见任务的指南.

开始之前
使用前你要先安装Git. 有多种方式可以得到Git，取决于你的操作系统. 要获得源代码和官方二进制包，签出(check out)git-scm.com. 对于安装Git的其它方式，使用你最喜爱的搜索引擎来找到适合你的操作系统的安装指南.

建议使用composer下载安装第三方库，但非必需.

下载
你可以在使用Git下载MediaWiki核心文件和在维基媒体基金会的服务器上使用的所有扩展.

第一步是克隆MediaWiki版本库，这需要一些时间.

在终端窗口中输入如下命令：

This clones the entire MediaWiki core repository into a subdirectory named core. To install into a specific directory, add that to the command line (for more info refer to these docs). The default "branch" will be, the cutting-edge, developer version of MediaWiki. Once the repository is cloned, you can easily switch to different branches or tags (see below), including those tracking stable versions of MediaWiki.

下载以进行开发
如果您有开发者权限（容易申请），然后您不需要通过https匿名克隆，而是需要提供您的ssh“<用户名>”克隆，这样您可以提交更改以供复核：



获取外部库
Starting with MediaWiki 1.25, some external libraries that MediaWiki requires are no longer in this "core" git repository. 我们使用composer管理它们. 欲安装下列的库，您可以：


 * Download and install composer, switch to your core directory and then run composer install --no-dev . 请注意如果现在已存在 composer.lock 文件，您需要运行 composer update --no-dev.


 * If you don't want to use composer, or if you want to use the same set of vendor libraries as used on the WMF production cluster, you can instead git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git to create a vendor/ directory inside the core folder of your MediaWiki installation. Make sure you use the right branch for your MediaWiki version (e.g. REL1_25 for 1.25).

WMF 分支
Remote branches track the MediaWiki versions used on the Wikimedia Foundation server cluster. These may not be entirely stable, but they receive very quick bug fixes and are generally stable enough – after all, these are what major projects such as Wikipedia are using. Once a REL* branch is considered 'stable', we 'tag' it and turn it into a tarball release.

To see what branches are available, switch to your MediaWiki core directory and enter the following command:

主要分支表示成origin/REL ，例如origin/. 要切换到特定的分支.

例如要切换到稳定版本, ,键入:

MediaWiki标签（稳定版本）
另外,特定的MediaWiki稳定版本使用'标签'进行跟踪. 这和web下载版本. 使用以下的命令查看可用的版本:

如果你使用非GNU的sort命令（例如在Mac OS X上使用），那么你必须依靠良好的旧式分隔符：

使用特定标签：

MediaWiki最新开发版
MediaWiki最新开发版使用'master'分支. 这是你首次克隆MediaWiki版本库时的默认的本地签出操作. 如果你曾切换到另一个分支，但是想切回MediaWiki的最前沿版本，那么请做如下操作：

保持最新
如果你正在使用MediaWiki的某个特定分支或者开发版本（master 分支），那么弄到最新的改变是非常容易的. 切换到MediaWiki的克隆目录，然后使用 git pull 命令：

这个分支的最新更改会合并到你的版本库上.

The new version of core may require newer versions of extensions and skins, so you must go into each extension and skin directory and update it with a command like git pull --recurse-submodules.

在更新/升级以后如有需要，您应该运行MediaWiki 命令行脚本以更新数据库表：

You also need to update mediawiki/vendor to any newer versions of required libraries, see.

If you use MediaWiki-Vagrant, it offers a single command, vagrant git-update, that performs all these steps.

切换到不同的版本
Switching to a different version of MediaWiki is far simpler with Git than with SVN. Each of our versions are tracked as branches or tags. In order to switch to one of these, all you have to do is checkout the particular branch or tag you want from within your MediaWiki clone directory:

或

你的更改会自动完成.

使用Git下载MediaWiki扩展

 * git中的扩展列表

下载扩展

 * 应替换为您希望下载的扩展名称，不带空格. 例如Extension:TitleKey，它应为TitleKey. （区分大小写！）

从Git下载并克隆扩展：

开发者使用以下命令:

You can view extension source code in Phabricator's diffusion application, and at the URL:

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

下载全部扩展
If you prefer to have all MediaWiki extensions that are at gerrit.wikimedia.org checked out to your machine, enter the following:

此后，要更新所有扩展至它们的最新版本，只需输入：

要跟踪特定分支，请执行：

If you only need a read-only checkout (for instance to grep or analyse all MediaWiki code), you can use the shared MediaWiki checkout on Labs, without downloading anything on your machines.

移除一个扩展
Just remove the extension folder and remove the " " from.

使用Git下载MediaWiki皮肤

 * git中的所有皮肤列表

从Git下载的MediaWiki 1.24及以后的版本不再包含皮肤.

Follow the exact same procedure as for extensions (described in the previous section), but using  rather than   in all URLs and paths.

详细的皮肤安装指南可以在各自的描述页上找到, 例如Vector： Skin:Vector#Installation.

另见

 * ,从Git下载的备用方法.
 * ,从Git下载的备用方法.