Download from Git/ru


 * Начиная с версий 1.19beta2, 1.18.2, 1.17.3, ядро MediaWiki и расширения используют для версионного контроля. Для старых версий — см. .

Git — это распределённая система управления версиями файлов, позволяющая пользователям загрузить самые последние версии, не дожидаясь, пока кто-то их упакует. Она позволяет MediaWiki выпускать новые версии быстрее. Для вас же будет проще обновить установленную версию, откатить обновления или загрузить исправление. Однако всегда помните, что официальные стабильные релизы являются менее рискованными.

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

Необходимые компоненты
Вы должны установить Git прежде, чем начать его использовать. В зависимости от вашей операционной системы есть различные способы это сделать. Исходные коды и официальные скомпилированные файлы можно найти на сайте git-scm.com. Для альтернативных методов установки Git поищите инструкции под свою операционную систему через ваш любимый поисковик.

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

Скачать
В настоящий момент с помощью Git вы можете скачать ядро MediaWiki (phase3 на SVN) с помощью Git, а также любые расширения, установленные в настоящее время на кластере серверов Фонда Викимедиа.

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

Введите в командной строке следующее: git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

В случае, если Вы видите ошибки «The requested URL returned error: 403» или «error: The requested URL returned error: 403 while accessing https://gerrit.wikimedia.org/r/p/mediawiki/core.git», вам необходимо проверить вашу версии git-клиента git --version и обновить Git хотя бы до версии 1.7. С версиями 1:1.7.2.3-2.2~bpo50+1, 1.7.9.2 и 1.7.9.6 всё работает.

Это клонирует весь репозитарий ядра MediaWiki. Веткой (branch) по умолчанию будет самая последняя версия MediaWiki для разработчиков. Как только репозиторий будет склонирован, легко сможете переключиться на другие версии или метки (см. ниже), в том числе на стабильные версии MediaWiki.

Скачать для разработки
Если у вас есть доступ разработчика (который легко запросить): git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Выборка внешних библиотек
Начиная с MediaWiki 1.25, имеются некоторые требуемые внешние библиотеки которых больше нет в нашем репозитории Git. We use composer to manage them. Есть два рекомендуемых методов, как их установить:

или...
 * Скачать и установить composer, перейти к основному каталогу, а затем запустить


 * для создания  каталог внутри основного каталога установки MediaWiki.

Версии Фонда Викимедиа
Удалённые версии используются для отслеживания версий MediaWiki, используемых на кластере серверов Фонда Викимедиа. Последние могут быть не совсем стабильными, но к ним очень быстро выходят исправления и в целом они всё же достаточно стабильны — в конце концов, их используют такие крупные проекты, как Википедия. После того, как REL-версия признаётся «стабильной», мы «помечаем её» и формируем tar-архив с исходным кодом.

Чтобы увидеть, какие версии доступны, переключитесь на клон MediaWiki и выполните следующую команду: git branch -r | sort -V Основные релизы обозначаются как «origin/REL » (например, «origin/»). Чтобы переключиться на конкретную версию релиза: git checkout -b REL origin/REL Например, для переключения на текущую стабильную версию,, введите: git checkout -b origin/

Метки MediaWiki (стабильная версия)
Кроме того, определённые устойчивые версии MediaWiki отмечаются с помощью «меток» (tags). Они аналогичны tar-архивам с исходным кодом. Вы можете увидеть доступные версии с помощью: git tag -l | sort -V При использовании команды не GNU-сортировки, например, такой, как на Mac OS X, вы должны полагаться на старые добрые разделители: git tag -l | sort -n -t. -k1 -k2 -k3

Для использования специфических тегов: git checkout

Последняя версия MediaWiki для разработчиков
Самая свежая версия MediaWiki для разработчиков расположена в мастер-ветке. Она помечается локально как версия по умолчанию, когда вы впервые клонируете репозиторий MediaWiki. Если вы перешли на другую ветку, но хотели бы вернуться к использование новейшей MediaWiki, выполните: git checkout master

Поддержание в актуальном состоянии
Если вы используете какую-то конкретную версию MediaWiki или версию для разработчиков, загрузка последних изменений очень проста. Перейдите в ваш каталог с клоном MediaWiki и выполните команду извлечения: git pull Будут применены все последние изменения для версии, которую вы используете.

Кроме того, после обновления вы должны запустить из командной строки скрипт обновления MediaWiki: php maintenance/update.php

Переключение на другую версию
Переключение на другую версию MediaWiki на Git гораздо проще, чем в SVN. Каждый из наших версий отслеживаются через версии (branch) или метки. Для перехода к одной из них всё, что вам нужно сделать, это выполнить 'checkout' конкретной версии или метки из вашего каталога клонированной MediaWiki: git checkout или git checkout Изменения будут применены автоматически, и всё будет готово к работе.

Скачать

 * Список расширений в Git
 *  следует заменить на имя расширения (без пробелов), которое вы хотите загрузить. Для Extension:TitleKey это будет TitleKey. (название регистрозависимо!)

Скачайте и клонируйте расширение с Git:

cd /path/to/extensions git clone https: //gerrit.wikimedia.org/r/p/mediawiki/extensions/.git

Разработчики могут клонировать командой: git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/extensions/.git Исходный код может быть проверен с помощью:

https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/.git;a=tree;h=refs/heads/master;hb=master

Скачать все расширения
Если вы желаете загрузить на свой компьютер все расширения MediaWiki, которые находятся на gerrit.wikimedia.org, выполните следующие действия:

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions.git cd extensions git submodule update --init --recursive

Чтобы обновить расширения до последних версий, просто выполните:

cd /path/to/extensions git pull git submodule update --init --recursive

Чтобы обновиться до определённой версии, просто выполните это вместо последней команды из блока выше: git submodule foreach 'git checkout -b REL1_24 origin/REL1_24 || :'

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

Скачать
git clone https://gerrit.wikimedia.org/r/p/mediawiki/skins.git

Переключитесь к каталогу с темами оформления, который был только что клонирован. Чтобы получить все используемые темы оформления:

git submodule update --init --recursive

Добавьте  в свой файл, соответствующий теме оформления:
 * (Это идентично установке расширения, только в другой каталог)
 * (Это идентично установке расширения, только в другой каталог)

Подробные инструкции по установке доступны на странице каждой темы оформления на MediaWiki.org, например, см. Skin:Vector#Installation. Инструкции для всех остальных тем оформления аналогичны.

См. также

 * , как альтернатива скачиванию с Git
 * , как альтернатива скачиванию с Git