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版本库，这需要一些时间.

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

这个操作用来克隆MediaWiki版本库到  文件夹，你可以添加参数使其克隆到其他目录（参见这些文档以获取更多信息）. 默认的 '分支'是最新的开发者版本. 当你完成克隆版本库后，你可以切换到不同的分支，或使用稳定版本. 如果您希望减少克隆的修订版本数，添加 至上方命令即可.

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



获取外部库
从MediaWiki 1.25开始，MediaWiki需要的一些外部库不再在这个“核心”git存储库中. 我们使用composer管理它们. 要安装下列的库，您可以：


 * 下载并安装composer，切换到您的核心目录，然后运行 composer install --no-dev . 请注意如果现在已存在 文件，您需要运行 composer update --no-dev.


 * 如果您不想使用 composer ，或者如果要使用与WMF生产集群中使用的相同的外部库，可以使用 git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git 在MediaWiki安装的核心文件夹中创建  目录.  确认你为MediaWiki使用正确的分支版本(e.g.   for 1.25).

WMF 分支
这一分支用于维基媒体基金会的服务器上. 可能不会显示最新的更改，这是相对稳定且主要修复Bug的分支. 这个分支用于像维基百科这样的计划上，REL*分支也称为“稳定版”，我们会将它标记然后发行.

要查看可用的分支，移动到你的 MediaWiki core 目录然后按以下操作：

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

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

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

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

使用特定标签：

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

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

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

新的核心版本可能需要更新的延伸和细节， 所以你必须进去延伸与细节的目录并用句子比方说 git pull --recurse-submodules 来上传.

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

你也需要上传 给所有更新的版本的所需库，看.

如果你使用MediaWiki-Vagrant/zh，这提供单向的命令， vagrant git-update ，这样施行所有阶段.

切换到不同的版本
切换到MediaWiki的不同版本，用Git比用SVN更容易. 每个版本都有分支和标签来跟踪. 为了切换到其中的一个版本，你所要做的无非就是在你的MediaWiki的克隆目录下“签出”（checkout）到你需要的特定分支或标签.

或

更改会自动应用，您就一切准备好了.

使用Git下载MediaWiki扩展

 * git中的扩展列表

下载扩展

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

从Git下载并克隆扩展：

开发者使用以下命令:

您可以在Phabricator的diffusion应用程序和URL中查看扩展源代码：

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

下载全部扩展
如果您愿意在您的机器上，拥有在gerrit.wikimedia.org签出的所有MediaWiki扩展，请输入以下命令：

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

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

如果您只需要一个只读的结帐（例如，打印或分析所有MediaWiki代码），您可以使用在实验室上共享的MediaWiki结帐，而无需在计算机上下载任何内容.

移除一个扩展
直接移除扩展文件夹，并从 中移除“ ”.

使用Git下载MediaWiki皮肤

 * git中的所有皮肤列表

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

按照与扩展（前面部分所述）完全相同的过程，但在所有URL和路径中使用 而不是.

详细的皮肤安装指南可以在各自的描述页上找到，例如Vector：Skin:Vector#Installation. 其他皮肤的安装教程同理.

参见

 * 从SVN迁移至Git
 * Nightlies，从Git下载的备用方法