Download from Git/uk


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

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

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

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

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

Завантаження
Ви можете завантажити ядро MediaWiki з допомогою Git, а також усі розширення, встановлені зараз на кластері серверів Фонду Вікімедіа, та багато інших розширень, що розміщені на.

Перший крок — клонувати кореневий репозиторій MediaWiki. Це займе деякий час.

У вікні терміналу введіть таку команду: git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

Це клонує весь репозиторій ядра MediaWiki у субдиректорію під назвою core. Щоб встановити в певну директорію, додайте це до командного рядка (більше інформації див. у цій документації). Гілкою (branch) за замовчуванням буде, найновіша, розробницька версія MediaWiki. Як тільки репозиторій клоновано, Ви можете легко перемкнутися на інші гілки чи теґи (див. нижче), у тому числі на стабільних весіях MediaWiki.

Завантаження для розробки
Якщо у Вас є доступ розробника (на який легко подати запит), тоді замість клонувати анонімно з https Вам треба клонувати зі своїм ssh , щоб Ви могли подавати зміни на розгляд: git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Вибірка зовнішних бібліотек
Починаючи з MediaWiki 1.25 деяких зовнішніх бібліотек, потрібних для MediaWiki, немає у цьому «кореневому» git-репозиторії. Для керування ними ми використовуємо composer. Щоб встановити ці необхідні бібліотеки, Ви можете вибрати:


 * Завантажити і встановити composer, перемкнутися на свою кореневу директорію, і тоді запустити composer install --no-dev . Зверніть увагу, що якщо у Вас є файл composer.lock, то слід натомість запустити composer update --no-dev.


 * Якщо Ви не бажаєте використовувати composer або якщо Ви хочете використати той же набір бібліотек, який використано у виробничому кластері ФВМ, Ви можете натомість виконати git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git для створення директорії vendor/ всередині кореневої папки Вашої інсталяції MediaWiki. Переконайтеся, що Ви використовуєте правильну гілку своєї версії MediaWiki (наприклад, REL1_25 для 1.25).

Гілки ФВМ
Віддалені гілки відслідковують версії 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

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

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 з командного рядка, щоб оновити за потреби таблиці баз даних:

php maintenance/update.php

Вам також треба оновити mediawiki/vendor до будь-яких нових весій необхідних бібліотек, див. Вибірка зовнішних бібліотек.

Якщо Ви використовуєте MediaWiki-Vagrant, там є єдина команда, vagrant git-update, що виконує усі ці кроки.

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

Використання Git для завантаження розширень MediaWiki

 * List of extensions in git

Download an extension

 *  should be replaced with the name of the extension you want to download, without spaces. For Extension:TitleKey, it would be TitleKey. (case sensitive!)

Клонування (завантаження) розширення з Git-репозиторію:

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

Клонування для розробників: git clone ssh:// <USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>.git You can view extension source code in Phabricator's diffusion application, and at the URL:

<pre style="white-space: pre-wrap;"> https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=master

Завантажити всі розширення
If you prefer to have all MediaWiki extensions that are at gerrit.wikimedia.org checked out to your machine, enter the following:

Thereafter, to update all extensions to their latest versions, just enter:

Оновлення розширень до версій з певною міткою (REL1_23) гілки:

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.

Remove an extension
Just remove the extension folder and remove the " " from.

Використання Git для завантаження тем оздоблення MediaWiki

 * List of skins in git

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

Follow the exact same procedure as for extensions (described in the previous section), but using  rather than   in all URLs and paths.

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

Див. також

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