Download from Git/uk


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

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

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

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

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

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

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

У вікні терміналу введіть таку команду:

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

To install into different directory, change that in the command line (for more info refer to these docs). Once the repository is cloned, you can easily switch to different branches or tags (see below), including those tracking unstable versions of MediaWiki. The development branch,, is the cutting-edge, developer version of MediaWiki; you should not use master code for production under any circumstances as it is not considered stable.

If you want to reduce the number of revisions that are cloned, add  to the above command.

That the release branches have a bunch of Git submodules in them, for commonly-used extensions and skins (the master branch does not have these). To update the submodules, run:

Завантаження для розробки
Якщо у Вас є доступ розробника (на який легко подати запит), тоді замість клонувати анонімно з https Вам треба клонувати зі своїм ssh , щоб Ви могли подавати зміни на розгляд:



Вибірка зовнішних бібліотек
Для керування ними ми використовуємо composer.

Щоб встановити ці необхідні бібліотеки, Ви можете вибрати:


 * Завантажити і встановити composer, перемкнутися на свою кореневу директорію, і тоді запустити.


 * Якщо Ви не бажаєте використовувати composer або якщо Ви хочете використати той же набір бібліотек, який використано у виробничому кластері ФВМ, Ви можете натомість виконати  для створення директорії   всередині кореневої папки Вашої інсталяції MediaWiki.

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

Мітки MediaWiki (стабільна версія)
Крім того, окремі стабільні версії MediaWiki позначено мітками ('tags'). Вони подібні до tar-архівів з вихідним кодом. Доступні версії можна знайти так:

You can see all available tags with:

За відсутності GNU команди sort, як на Mac OS X, доведеться покластися на старі добрі розділювачі:

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

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

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

До вашої локальної версії коду буде внесено всі нові зміни використовуваної вами гілки.

Нова весія ядра може вимагати новіших версій розширень і тем оформлення, тому Ви маєте перейти у кожну директорію розширень і тем й оновити її командою на зразок git pull --recurse-submodules.

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

Після оновлення слід не забути виконати скрипт  MediaWiki з командного рядка, щоб оновити за потреби таблиці баз даних:

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

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

або

Зміни буде застосовано автоматично.

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

 * Список розширень з git

Завантаження розширення

 *  слід замінити назвою розширення, яке Ви хочете завантажити, без пробілів. Так, для Extension:TitleKey це має бути TitleKey. (чуттєво до регістру літер!)

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

Клонування для розробників:

Ви можете переглянути вихідний код розширення у програмі Phabricator diffusion та за посиланням:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master

Завантажити всі розширення
Якщо Ви хочете скопіювати на свій комп'ютер цсі розширення MediaWiki, доступні на gerrit.wikimedia.org, введіть таке:

У подальному для оновлення усіх розширень до їх найновіших версій просто введіть:

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

Remember that you should only use versions of extensions from the same release as that version of MediaWiki and each other.

To track the master branch:

Please note that you should not use master code for production under any circumstances as it is not considered stable.

Якщо Вам потрібен checkout у режимі лише для читання (наприклад, для обробки grep чи аналізу всього коду MediaWiki), Ви можете скористатися загальнодоступним MediaWiki checkout на Labs без завантаження чого-небудь на свої машини.

Вилучення розширення
Просто вилучіть папку розширення і « » з.

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

 * Список тем офомлення у git

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

Виконайте ті самі кроки, що й для розширень (описані у попередньому розділі), але використовуйте  замість   у всіх посиланнях і шляхах.

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

Див. також

 * Міграція з SVN на Git
 * Nightlies, альтернатива завантажуванню з Git
 * Intranet/Intranet Installation, part of a fully worked series of articles that uses Git for Mediawiki deployment