Download from Git/uk


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

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

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

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

Завантаження
На даний момент ви можете завантажити з допомогою 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 працюють.

Це клонує весь репозиторій ядра MediaWiki. Гілкою (branch) за замовчуванням буде найновіша, розробницька версія 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.

Гілки ФВМ
Віддалені гілки використовуються для відслідковування весій MediaWiki на кластері серверів Фонду Вікімедіа. Найновіша може бути не зовсім стабільною, але баґи у них виправляютсья дуже швидко і загалом вони досить стабільні — зрештою, це те, що використовують головні проекти, на зразок Вікіпедії. Як тільки гілка REL* вважається "стабільною", ми "теґуємо" її і перетворюємо на tar-архівний випуск.

Щоб побачити доступні гілки, ви перемкніться на клон 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_23 origin/REL1_23 || :'

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

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

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

git submodule update --init --recursive

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

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

Див. також

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