Download from Git/uk


 * Починаючи з MediaWiki 1.19beta2, 1.18.2, 1.17.3, ядро та розширення MediaWiki використовують для контролю версії. Для старіших версій див. 

Git — розподілене програмне забезпечення керування версіями, яке дозволяє користувачам завантажувати найсвіжішу версію гілки без очікування на когось, хто її упакує. MediaWiki випускається швидше, і вам легше оновлювати своє встановлення, відкочувати оновлення чи надсилати патчі. (Звичайно ж, пам'ятайте, що офіційні стабільні релізи менш ризиковані.)

Див. Git для детальнішої інформації, в тому числі про те, як зробити свій внесок. Нижче наведено кілька прямих відсилань до кількох поширених завдань.

Передумови
Перед тим, як використовувати Git, ви маєте його встановити. Є чимало різних способів це зробити, вибір залежить від вашої операційної системи. Вихідні коди і офіційні двійкові файли можна знайти на git-scm.com. Для альтернативних способів встановлення Git, скористайтесь своїм улюбленим пошуковиком і знайдіть інструкції під свою операційну систему.

Рекомендується, щоб у Вас був встановлений composer для завантаження та встановлення сторонніх бібліотек, проте це не обов'язково.

Завантаження
На даний момент ви можете завантажити з допомогою Git ядро MediaWiki (phase3 на SVN), а також будь-яке розширення, встановлене зараз на кластері серверів Фонду Вікімедіа. До липня 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 працюють.

This clones the entire MediaWiki core repository into a subdirectory named core. 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.

Download for development
Якщо у вас є (на який легко подати запит): git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Fetch external libraries
Starting with MediaWiki 1.25, some external libraries that MediaWiki requires are no longer in this "core" git repository. We use composer to manage them. To install these needed libraries:


 * Download and install composer, switch to the core directory and then run


 * 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   to create a   directory inside the core folder of your MediaWiki installation.

Гілки ФВМ
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.

Щоб побачити доступні гілки, ви перемкніться на клон MediaWiki і виконайте таку команду: git branch -r | sort -V Основні релізи позначені як «origin/REL » (напр., «origin/»). Щоб перемкнутися на конкретну гілку релізу: git checkout -b REL origin/REL Наприклад, щоб перемкнутися на поточну стабільну версію,, введіть: git checkout -b origin/

Мітки MediaWiki (стабільна версія)
Крім того, окремі стабільні версії MediaWiki позначено мітками ('tags'). Вони подібні до tar-архівів з вихідним кодом. Доступні версії можна знайти так: git tag -l | sort -V За відсутності GNU команди sort, як на Mac OS X, доведеться покластися на старі добрі розділювачі: git tag -l | sort -n -t. -k1 -k2 -k3

Для перемикання на версію із міткою : git checkout

Найновіша версія MediaWiki в процесі розробки
Гілка 'master' містить найновішу версію MediaWiki, яка перебуває в розробці. Саме вона завантажується за замовчуванням, коли ви вперше клонуєте репозиторій MediaWiki. Якщо ви перемкнулися на іншу гілку і хочете повернутися до найновішої версії, виконайте: git checkout master

Своєчасне оновлення
Якщо ви використовуєте певну гілку або основну версію розробки MediaWiki, оновлення репозиторію просте. Перейдіть до каталогу локального репозиторію MediaWiki (куди відбувалося клонування) і виконайте команду завантаження: git pull До вашої локальної версії коду буде внесено всі нові зміни використовуваної вами гілки.

Після оновлення слід не забути виконати сценарій оновлення MediaWiki з командного рядку: php maintenance/update.php

Як перемкнутися на іншу версію
Перемикання на іншу версію MediaWiki значно простіше з Git, ніж із SVN. Кожна з наших версій відслідковується за допомогою або окремих гілок, або теґів. Щоб перемкнутися на таку версію, слід у вашій локальній копії репозиторію MediaWiki виконати 'checkout' із зазначенням бажаної гілки або теґу: git checkout або git checkout Зміни буде застосовано автоматично.

Завантаження

 * Перелік розширень під git
 *  слід замінити назвою розширення, яке ви хочете клонувати, без пробілів. Так, для Extension:TitleKey це має бути 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

Оновлення розширень до версій з певною міткою (REL1_23) гілки: git submodule foreach 'git checkout -b REL1_24 origin/REL1_24 || :'

Використання Git для завантаження тем оздоблення MediaWiki
Починаючи з MediaWiki 1.24, теми оздоблення не включено до стандартного Git-завантаження.

Завантаження
git clone https://gerrit.wikimedia.org/r/p/mediawiki/skins.git

Перейдіть до папки тем оздоблення, яку щойно було клоновано. Отримати всі теми оздоблення можна так:

git submodule update --init --recursive

Додавайте рядок коду, що відповідає темі, до вашого файлу :
 * (Процедура така сама, як і встановлення розширення, лише в іншій папці.)
 * (Процедура така сама, як і встановлення розширення, лише в іншій папці.)

Детальні інструкції з інсталяції кожної теми оздоблення доступні тут на MediaWiki.org, приміром, Skin:Vector#Installation. Так само можна знайти й інструкції для інших тем.

Див. також

 * , альтернатива завантажуванню з Git
 * , альтернатива завантажуванню з Git