Завантажити з Git

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 47% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Tiếng Việt • ‎Türkçe • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎українська • ‎қазақша • ‎العربية • ‎سنڌي • ‎فارسی • ‎अवधी • ‎हिन्दी • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

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

It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.

You should download from Git if you are a developer and want to submit patches.

If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.

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

Передумови

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

Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

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

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

Завантаження

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

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

Завантаження для розробки

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

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

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

git clone ssh://<Ім'я користувача>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

This clones the entire MediaWiki core repository, synced to the master branch, into a sub-directory named 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 switch to different branches or tags. The development branch, master, 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.

Download a stable branch

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

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_34 mediawiki

If you have a slow internet connection and want to reduce the number of revisions that are cloned, add --depth=1 to the git clone command.

Мітки MediaWiki (стабільна версія)

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

You can see all available tags with:

git tag -l | sort -V

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

git checkout 1.34.1

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:

cd mediawiki
git submodule update --init

Вибірка зовнішних бібліотек

Для керування ними ми використовуємо composer.

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

  • Якщо Ви не бажаєте використовувати composer або якщо Ви хочете використати той же набір бібліотек, який використано у виробничому кластері ФВМ, Ви можете натомість виконати $git для створення директорії vendor/ всередині кореневої папки Вашої інсталяції MediaWiki.
    • With your developer account, use this command: git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/vendor.git
    • For anonymous checkout, use this command: git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
    • 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 (куди відбувалося клонування) і виконайте команду:

git pull

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

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

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

composer update --no-dev

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

php maintenance/update.php

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

Як перемкнутися на іншу версію

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

git checkout <branch_name>

або

git checkout <tag_name>

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

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

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

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

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

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

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

cd /path/to/extensions
git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>

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

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT> --branch REL1_34

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

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

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

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

With your developer account, to get the master branch:

git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions

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

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_34

After running the git clone command, continue with these commands:

cd /path/to/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_33 origin/REL1_33 || :'

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:

git submodule foreach 'git checkout -b origin/master || :'

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 "require_once …" or "wfLoadExtension( … )" from LocalSettings.php
  2. Remove any line referencing the extension in composer.local.json (usually in the "extra → merge-plugin → include" section)
  3. Remove the extension's directory in install-dir/extensions/

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

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

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

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

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

Див. також