Скачать из 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 97% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Начиная с версий 1.19beta2, 1.18.2, 1.17.3, ядро MediaWiki и расширения используют Git для контроля версий. Для старых версий — см. Subversion.

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

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

Необходимые компоненты

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

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

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

Скачать

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

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

В окне терминала введите следующую команду:

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

Это склонирует весь репозиторий ядра MediaWiki в поддиректорию mediawiki, за место изначального 1.31

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

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

В релизных ветках содержатся подмодули Git для часто используемых расширений и скинов (в ветке master их нет). Чтобы обновить подмодули, выполните следующую команду:

cd mediawiki
git submodule update --init

Скачать для разработки

Если у вас есть аккаунт разработчика (который легко запросить), тогда вместо анонимного клонирования через HTTPS следует выполнить клонирование через ssh <USERNAME>, чтобы вы смогли отправлять изменения на рассмотрение:

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

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

Загрузка внешних библиотек

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

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

  • Если вы не хотите использовать Composer, или если вы хотите использовать точно такой же набор библиотек, который используется на производственном кластере ФВМ, вы можете вместо этого выполнить git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git для создания каталога vendor/ внутри основного каталога установки MediaWiki. Обратите внимание, что если у какого-либо из ваших расширений есть свои требования в Composer, тогда вы не можете использовать эту опцию.

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

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

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

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

git tag -l | sort -V

При использовании не GNU sort команды, например на Mac OS X, вы должны полагаться на старые добрые разделители:

git tag -l | sort -n -t. -k1 -k2 -k3

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

git checkout 1.31.1

Последняя разрабатываемая версия MediaWiki

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

git checkout master

Поддержание в актуальном состоянии

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

git pull

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

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

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

composer update --no-dev

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

php maintenance/update.php

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

Переключение на другую версию

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

git checkout <название ветки>

или

git checkout <название метки>

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

Использование Git для скачивания расширений MediaWiki

Список расширений на git'е

Скачать расширение

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

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

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

Разработчики могут клонировать командой:

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

Вы можете просмотреть исходный код расширений в приложении Gerrit's gitiles, а также по следующей ссылке:

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

Скачать все расширения

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

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
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_30 origin/REL1_30 || :'

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

Для отслеживания master ветки:

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

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

Если вам только нужен checkout в режиме только чтения (например, для анализа кода MediaWiki или обработки его grep), можно использовать общедоступный MediaWiki checkout на Labs, не скачивая ничего на ваши компьютеры.

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

  1. Удалите require_once … или "wfLoadExtension( … )" из LocalSettings.php
  2. Удалите любую строку связанную с расширением в composer.local.json (обычно в разделе "extra → merge-plugin → include")
  3. Удалите каталог с расширения в install-dir/extensions/

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

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

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

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

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

См. также