Download from Git/uk

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

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

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

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

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

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

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

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

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

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

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

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

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



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

If you have a slow internet connection and want to reduce the number of revisions that are cloned, add  to the   command.

Мітки MediaWiki (стабільна версія)
Крім того, окремі стабільні версії MediaWiki позначено мітками ('tags'). Вони подібні до tar-архівів з вихідним кодом. Currently, these are (stable),  (LTS) and  (legacy).

You can see all available tags with:

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

Update the Git submodules
The 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:

Вибірка зовнішних бібліотек
MediaWiki uses Composer to manage external PHP libraries, all of which end up in the  directory in your MediaWiki directory.

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


 * Завантажити і встановити composer, перемкнутися на свою кореневу директорію, і тоді запустити.
 * Якщо Ви не бажаєте використовувати composer або якщо Ви хочете використати той же набір бібліотек, який використано у виробничому кластері ФВМ, Ви можете натомість виконати $git для створення директорії  всередині кореневої папки Вашої інсталяції MediaWiki.
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Note that if any of your extensions have their own Composer requirements, then you cannot use this option.

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

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

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

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

You also need to update  with any newer versions of required libraries. This often means running the following Composer command, but see #Fetch external libraries above for more details:

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

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

Як перемкнутися на іншу версію
Кожна з наших версій відслідковується за допомогою або окремих гілок, або теґів. Щоб перемкнутися на таку версію, слід у Вашій локальній копії репозиторію 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:

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

Оновлення розширень до версій з певною міткою (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 без завантаження чого-небудь на свої машини.

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

 * 1) Remove the " " or " " from
 * 2) Remove any line referencing the extension in   (usually in the "extra → merge-plugin → include" section)
 * 3) Remove the extension's directory in

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

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

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

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

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

Див. також

 * Intranet/Intranet Installation, part of a fully worked series of articles that uses Git for MediaWiki deployment