Download from Git/ru

Git — это распределённая система управления версиями файлов. Она позволяет загрузить самую последнию версию исходного кода со всеми ветками и релизами в ваше распоряжение.

Если вы разработчик и хотите отправить патч, то вам нужно загрузить из Git.

Если вы не хотите участвовать в разработке, но хотите просто установить MediaWiki и расширения, то просто загрузите архив стабильнго релиза.

Более подробную информацию можно найти на странице Git, особенно в части внесения вклада в проект. Ниже приводятся краткие рекомендации по нескольким наиболее распространенным задачам.

Необходимые компоненты
Вы должны установить Git прежде, чем начать его использовать. В зависимости от вашей операционной системы есть много способов это сделать. Перейдите к разделу Gerrit/Руководство#Настройка Git или используйте ваш любимый поисковик.

Рекомендуется, чтобы у вас был установлен для загрузки и установки сторонних библиотек, но это не обязательно.



Скачать
В настоящий момент вы можете скачать ядро MediaWiki с помощью Git, а также все расширения, установленные в настоящее время на кластере серверов Фонда Викимедиа, и многие другие расширения, размещённые на.

Первым шагом является клонирование репозитория ядра MediaWiki. Это займёт некоторое время.



Скачать для разработки
Последняя разрабатываемая версия MediaWiki расположена в 'master'-ветке.

Сперва убедитесь что вы создали аккаунт разработчика; так у вас будет имя пользователя от ssh.

Затем, в окне терминала введите следующую команду, чтобы склонировать при помощи ssh и. Так вы сможете отправлять патчи на рассмотрение:

Это клонирует весь основной репозиторий MediaWiki, синхронизированный с master веткой, в подкаталог с именем.

Чтобы установить в конкретную директорию, добавьте её в командную строку (больше информации смотрите в https://git-scm.com/docs/git-clone). После того как репозиторий склонирован, вы можете легко переключится на другие ветки или метки. Разрабатываемая ветка,, самая современная версия для разработчиков MediaWiki; вы ни при каких обстоятельствах не должны использовать код из master, поскольку он считается нестабильным.





Загрузка стабильной ветки
Если вы не хотите разрабатывать патчи, а просто хотите анонимно склонировать ветку стабильного релиза, то воспользуйтесь этой командой:

Если у вас медленное интернет соединение и вы хотите уменьшить количество клонируемых ревизий, добавьте  к команде.



Метки MediaWiki (стабильная версия)
Кроме того, определённые стабильные версии MediaWiki отмечаются с помощью «меток» (tags). Они аналогичны релизам в tar-архивах. На данный момент имеется (стабильная),  (LTS) и  (legacy LTS).

Вы можете увидеть все доступные метки с помощью:

Для использования специфических метки, например последний стабильный релиз:



Обновите Git-субмодули
В ветках и тегах есть группа подмодулей Git для часто используемых расширений и скинов, а также для каталога. В ветке  их нет. Для обновления субмодуля запустите:



Загрузка внешних библиотек
MediaWiki Composer для управления внешними библиотеками PHP. Они все находятся в каталоге  в MediaWiki каталоге.

Для установки этих библиотек, вы можете выбрать:


 * Скачайте и установите composer PHAR. Если инструкции для вашей ОС необходимо переименовать файл composer.phar, то выполните это. А затем, запустите  из вашего MediaWiki каталога. Это рекомендуемый подход.
 * Если версия PHP CLI по умолчанию не совпадает с версией PHP веб-сервера, укажите её, например,.
 * Если вы не хотите использовать Composer, или если вы хотите использовать точно такой же набор библиотек, который используется на производственном кластере WMF, вы можете вместо этого создать каталога  внутри основного каталога установки MediaWiki:
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Обратите внимание, что если у какого-либо из ваших расширений есть свои требования в Composer, тогда вы не можете использовать эту опцию.

До MediaWiki 1.25 внешние библиотеки хранились в основном репозитории, и менеджер пакетов не требовался.



Поддержание в актуальном состоянии
Если вы используете какую-то конкретную версию MediaWiki или разрабатываемую версию (ветку «master»), загрузка последних изменений довольно проста. Перейдите в ваш каталог с клоном MediaWiki и выполните эту команду:

Будут применены все последние изменения для ветки, которую вы используете.

Новая версия ядра может потребовать более новые версии расширений и скинов, так что необходимо перейти в каждый из каталогов расширений и скинов и обновить его командой наподобие.

Вам также понадобится обновить  до каких-либо новых версий требуемых библиотек. Это часто означает выполнение следующей команды Composer, но см. #Загрузка внешних библиотек для получения дополнительных сведений:

Кроме того, после обновления кода и необходимых библиотек вы должны запустить из командной строки  скрипт, чтобы обновить таблицы баз данных как необходимо:

Если вы используете, в этой программе есть специальная команда, , которая производит все эти действия.



Переключение на другую версию
Каждая из наших версий отслеживается через версии (branch) или метки. Для переключения на какую-либо другую версию (например из ветки  на любую другую ветку или метку), checkout на необходимую версию или метку из вашего каталога клонированной MediaWiki:

или

Изменения будут применены автоматически, и всё будет готово к работе.



Использование 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 в режиме только чтения (например, для анализа кода MediaWiki или обработки его grep), можно использовать общедоступный MediaWiki checkout на Labs, не скачивая ничего на ваши компьютеры.



Удалить расширение

 * 1) Удалите « » или « » из
 * 2) Удалите любую строку связанную с расширением в   (обычно в разделе "extra → merge-plugin → include")
 * 3) Удалите каталог с расширения в



Использование Git для скачивания тем оформления MediaWiki

 * Список оболочек на git'е

MediaWiki версии 1.24 и более поздние версии не содержат темы оформления при загрузке с Git.

Следуйте тем же процедурам, что и для расширений (описано в предыдущей секции), но используя  вместо   во всех URL и путях.

Подробные инструкции по установке доступны на странице каждой темы оформления на MediaWiki.org, например, см. Skin:Vector#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