Download from Git/be-tarask


 * З MediaWiki 1.19beta2, 1.18.2, 1.17.3, ядро MediaWiki і пашырэньні выкарыстоўваюць для кантролю вэрсіяў. Дзеля старых вэрсіяў глядзіце 

Git is distributed version control software that allows users to download the very latest version of a branch, without having to wait for someone to get around to packaging it. MediaWiki will release faster, and it'll be easier for you to update your installation, roll back an upgrade, or submit patches. (Of course always remember official stable releases are less risky.)

See Git for more details, particularly for making contributions. Below are some quick directions for a couple common tasks.

Неабходныя кампанэнты
You must have Git installed before you can use it. There are many different ways to acquire Git, depending on your operating system. For source and official binaries, check out git-scm.com. For alternative ways to install Git, use your favorite search engine to find instructions for your operating system.

Спампоўка
У цяперашні час вы можаце спампаваць ядро MediaWiki (phase3 на SVN) з дапамогай Git, а таксама любое пашырэньне, якое цяпер усталяванае на клястэры сэрвэраў фундацыі «Вікімэдыя». Да ліпеня 2013 году ўсе пашырэньні будуць даступныя з дапамогай Git або будуць пераведзеныя на альтэрнатыўныя сыстэмы кантролю вэрсіяў.

Першы крок — зрабіць клон сховішча MediaWiki. Гэта можа заняць час.

Увядзіце наступнае ў ваш камандны радок: git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

Калі вы бачыце «The requested URL returned error: 403» або «error: The requested URL returned error: 403 while accessing https://gerrit.wikimedia.org/r/p/mediawiki/core.git», вам трэба праверыць вэрсію вашага git-кліента git --version і абнавіцца як мінімум да вэрсіі git 1.7, вядома, што вэрсіі 1:1.7.2.3-2.2~bpo50+1, 1.7.9.2 і 1.7.9.6 працуюць.

Гэта робіць клон усяго сховішча ядра MediaWiki. Дапомнай «галіной» будзе самая апошняя вэрсія MediaWiki для распрацоўнікаў. Калі клон сховішча будзе створаны, вы зможаце лёгка пераключацца паміж рознымі галінамі або цэтлікамі (глядзіце ніжэй), у тым ліку і на стабільныя вэрсіі MediaWiki.

Калі вы маеце (які лёгка запытаць): git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Fetch external libraries
Starting with MediaWiki 1.25, there are some external libraries that are now required, and no longer in our git repository. We use composer to manage them. There are two recommended methods of how to install them:


 * Download and install composer, and then run
 * Or  to create a   directory in your main mediawiki folder.

Вэрсіі WMF
Аддаленыя вэрсіі ўжываюцца для адсочваньня вэрсіяў MediaWiki, якія ўжываюцца на сэрвэрах фундацыі «Вікімэдыя». Яны могуць быць ня цалкам стабільнымі, але ў іх вельмі хутка выпраўляюцца памылкі і ў цэлым яны дастаткова стабільныя, акрамя ўсяго, менавіта гэтай вэрсія карыстаецца такі вялікі праект як Вікіпэдыя. Калі вэрсія REL* лічыцца «стабільнай», мы «пазначаем» яе і фармуем tar-архіў з крынічным кодам.

Каб пабачыць, якія вэрсіі даступныя, пераключыцеся на клон MediaWiki і выканайце наступную каманду: git branch -r | sort -V Асноўныя рэлізы пазначаюцца як «origin/REL », напрыклад, «origin/». Каб пераключыцца на канкрэтную вэрсію: git checkout -b REL origin/REL Напрыклад, каб пераключыцца на актуальную стабільную вэрсію,, увядзіце: git checkout -b origin/

Цэтлікі MediaWiki (стабільная вэрсія)
Акрамя таго, вызначаныя стабільныя вэрсіі MediaWiki пазначаюцца з дапамогай «цэтлікаў». Яны аналягічныя tar-архівам з крынічным кодам. Вы можаце пабачыць даступныя вэрсіі з дапамогай: git tag -l | sort -V Пры выкарыстаньні ня GNU-камандаў сартаваньня, напрыклад, такіх, як на Mac OS X, вам трэба разьлічваць на старыя добрыя разьдзяляльнікі: git tag -l | sort -n -t. -k1 -k2 -k3

Каб выкарыстаць пэўны цэтлік: git checkout

Актуальная вэрсія MediaWiki для распрацоўнікаў
Актуальная вэрсія MediaWiki для распрацоўнікаў знаходзіцца ў «майстар»-галіне. Яна зьяўляецца дапомнай, калі вы першы раз робіце клон сховішча MediaWiki. Калі вы перайшлі на іншую галіну, але хочаце вярнуцца да актуальнай вэрсіі MediaWiki, выканайце каманду: git checkout master

Падтрымка ў актуальным стане
Калі вы выкарыстоўваеце пэўную вэрсію MediaWiki або вэрсію для распрацоўнікаў, загрузка апошніх зьменаў вельмі простая. Перайдзіце ў каталёг з вашым клонам MediaWiki і выканайце каманду атрыманьня: git pull Усе апошнія зьмены будуць дапасаваныя да вэрсіі, якую вы ўжываеце.

Акрамя таго, пасьля абнаўленьня вам трэба запусьціць скрыпт абнаўленьня MediaWiki з каманднага радку: php maintenance/update.php

Пераключэньне на іншую вэрсію
Пераключэньне на іншую вэрсію MediaWiki з дапамогай Git прасьцей, чым з SVN. Кожная з нашых вэрсіяў кантралюецца з дапамогай галінаў і цэтлікаў. Каб пераключыцца на адну зь іх, вам трэба зрабіць «checkout» пэўнай галіны або цэтліку з вашага каталёгу з клонам MediaWiki: git checkout або git checkout Зьмены будуць аўтаматычна захаваныя і ўсё будзе гатовае да працы.

Спампоўка

 * Сьпіс пашырэньняў у git
 *  павінна быць замененая на назву пашырэньня, якое вы хочаце спампаваць, без прабелаў. Для, гэта будзе TitleKey (рэгістар важны!).

Спампаваць і зрабіць клон пашырэньня з Git:

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

Клон для распрацоўнікаў: git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/extensions/.git Крынічны код можа быць правераны з дапамогай:

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

Спампаваць усе пашырэньні
Калі вы жадаеце загрузіць на свой кампутар усе пашырэньні MediaWiki, якія знаходзяцца на gerrit.wikimedia.org, зрабіце наступнае:

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_23 origin/REL1_23 || :'

Выкарыстаньне Git для спампоўкі тэмаў афармленьня MediaWiki
MediaWiki вэрсіі 1.24 і пазьнейшыя не ўключаюць тэмы афармленьня ў загрузку з Git.

Спампоўка
git clone https://gerrit.wikimedia.org/r/p/mediawiki/skins/Vector.git

Switch to the skins folder, that was just cloned. To get all the skins use:

git submodule update --init --recursive

Add a  line to your  file corresponding to the skin:
 * (This is identical to extension installation, only in a different directory.)
 * (This is identical to extension installation, only in a different directory.)

Detailed installation instructions are available on each skin's page here on MediaWiki.org, for example see Skin:Vector#Installation. Instructions for all other skins are analogous.

Глядзіце таксама

 * , альтэрнатыва спампоўцы з Git
 * , альтэрнатыва спампоўцы з Git