Download from Git/uk

Git — це розподілена система керування версіями. Вона дає змогу користувачу завантажити найновішу версію вихідного коду, з усіма відгалуженнями та позначеними релізами.

Якщо ви розробник і хотіли би пропонувати власні патчі, вам слід клонувати Git-репозиторій програмного забезпечення.

Якщо ж ви не плануєте брати участь у розробці, а хотіли б лише встановити MediaWiki та її розширення, просто завантажте архів стабільного релізу.

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

Передумови
Перед тим, як використовувати Git, ви маєте його встановити. Є чимало різних способів це зробити, вибір залежить від вашої операційної системи. Ось один із посібників про встановлення Git, але ви можете знайти й інші в Інтернеті.

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

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

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

Завантаження для розробки
Гілка «master» містить найновішу версію MediaWiki, яка перебуває в розробці.

Спочатку пересвідчіться, що у вас є обліковий запис розробника, аби мати ім'я користувача ssh.

Відтак у вікні терміналу введіть таку команду з вашим ssh для клонування, аби мати можливість надсилати патчі для оцінки досвідченішими розробниками:

Це клонує (копіює) увесь репозиторій ядра MediaWiki, синхронизований з гілкою «master», у підкаталог з назвою.

Аби встановити в іншу директорію, змініть це в командному рядку (подробиці в цьому документі). Щойно репозиторій клоновано, ви можете перемикатися до інших гілок чи тегів. Гілка розробників,, містить найновішу версію MediaWiki з усіма новими змінами; код з неї в жодному разі не слід застосовувати на веб-сайті, бо він розглядається як нестабільний.



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

Якщо у вас повільне Інтернет-з'єднання або обмежений трафік, ви можете зменшити кількість клонованих версій, додавши  до команди.

Теги MediaWiki (стабільна версія)
Крім того, окремі стабільні версії MediaWiki позначено мітками («tags»). Вони подібні до tar-архівів з вихідним кодом. Наразі розрізняють (стабільну),  (з довгим терміном підтримки) та  (успадковану з довгим терміном підтримки) версії.

Ви можете побачити всі наявні позначки в такий спосіб:

Для перемикання на версію із певним тегом, приміром, до найновішого стабільного релізу:

Оновлення модулів Git
Гілки містять посилання на багато модулів, — це, зокрема, популярні розширення та скіни (основна гілка «master» такого не містить). Оновити модулі можна командою: The  branch does not have these. To update the submodules, run:

Вибірка зовнішніх бібліотек
MediaWiki використовує для керування зовнішніми бібліотеками PHP, які зрештою опиняються в піддиректорії   вашої установки MediaWiki.

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


 * Завантажити і встановити composer PHAR, опціонально перейменувати файл composer.phar згідно з інструкцією для вашої операційної системи, й тоді запустити  з директорії, в яку встановлено MediaWiki. Рекомендовано саме такий підхід.
 * Або ж, якщо Ви не бажаєте використовувати composer чи хочете використати той самий набір бібліотек, який використано на виробничому кластері Фонду Вікімедіа, то можете натомість створення директорію  всередині кореневої директорії Вашої інсталяції MediaWiki:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Зверніть увагу: якщо хоча б одне з установлених вами розширень має власні вимоги до Composer, то у вас не вийде застосувати цю схему.

До MediaWiki 1.25 зовнішні бібліотеки зберігалися в репозиторії ядра і потреби в менеджері пакетів не було.

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

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

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

Вам також слід оновити  до новіший версій необхідних бібліотек. Часто для цього достатньо виконати таку команду Composer (але погляньте #Вибірка зовнішніх бібліотек вище за подробицями):

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

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

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

або

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

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

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

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

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

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

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

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

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

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

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

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

Аби перемкнутися на іншу гілку, як-от після чергового релізу:

Пам'ятайте, що слід використовувати саме ті версії розширень, які належать до відповідного релізу MediaWiki.

Аби відслідковувати основну гілку «master»:

Зверніть увагу, що в жодному разі не слід використовувати код із основної гілки «master» на веб-сайті, оскільки він розглядається як нестабільний.

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

Вилучення розширення

 * 1) Видаліть « » чи « » із
 * 2) Видаліть будь-які рядки, де в   згадується це розширення (зазвичай у розділі «extra → merge-plugin → include»)
 * 3) Видаліть каталог розширення із

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

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

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

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

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

Див. також

 * Intranet/Intranet Installation, одна з серії статей про використання Git для розгортання MediaWiki

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki