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“<用户名>”克隆，这样您可以提交更改以供复核：



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

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

主要分支表示成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.

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

或

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

使用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

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

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

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

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.

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

使用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.

参见

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