Jump to content

Расширение:ExtensionDistributor

From mediawiki.org
This page is a translated version of the page Extension:ExtensionDistributor and the translation is 73% complete.
Справка по расширениям MediaWiki
ExtensionDistributor
Статус релиза: стабильно
Реализация Служебная страница
Описание Enables the distribution of extensions from www.mediawiki.org
Автор(ы) Tim Starling, Sam Reed, Chad Horohoe
Последняя версия постоянные обновления
Политика совместимости Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
MediaWiki 1.26+
Изменения в БД Нет
Лицензия GNU General Public License 2.0 или позднее
Скачать
  • $wgExtDistDefaultSnapshot
  • $wgExtDistCandidateSnapshot
  • $wgExtDistPopularSkinList
  • $wgExtDistListFile
  • $wgExtDistAPIConfig
  • $wgExtDistSnapshotRefs
  • $wgExtDistGraphiteRenderApi
  • $wgExtDistPopularExtList
Ежеквартальные загрузки 29 (Ranked 111st)
Переведите расширение ExtensionDistributor, если оно доступно на translatewiki.net
Проблемы Открытые задачи · Сообщить об ошибке

Расширение ExtensionDistributor генерирует .tar.gz-снапшоты (снимки) расширений из git-репозитория и распространяет их. Оно задумано для использования на www.mediawiki.org. См. Special:ExtensionDistributor, чтобы увидеть, как это работает.

Установка

  • Скачайте и распакуйте файл(ы) в папку с названием ExtensionDistributor в вашей папке extensions/.
    Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ExtensionDistributor
  • Добавьте следующий код в конце вашего файла LocalSettings.php :
    wfLoadExtension( 'ExtensionDistributor' );
    
  • Yes Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Настройки конфигурации:

/**
 * Configuration for the API client to use
 *
 * Must have a 'class' key, can either be
 * "GithubExtDistProvider" or "GerritExtDistProvider"
 *
 * Common parameters:
 *  'apiUrl' - API url to use with $EXT and $REF variables
 *  'tarballUrl' - API url where tarballs are located
 *  'tarballName' - Expected filename of tarballs
 *  'proxy' - Proxy to use (optional)
 *
 * Github specific parameters:
 *  'token' - An OAuth token for authenticating requests
 *
 * Gerrit specific parameters:
 *  'repoListUrl' - API url to fetch a list of repositories
 *
 * @var array
 */
$wgExtDistAPIConfig = false;

/**
 * File to fetch list of extensions from, with one extension per line
 * Only needed for the Github provider
 * Example url: https://gerrit.wikimedia.org/mediawiki-extensions.txt
 */
$wgExtDistListFile = false;

/**
 * Supported branches/tags, master is the default (and shouldn't be removed)
 */
$wgExtDistSnapshotRefs = array(
	'master',
);

/**
 * Snapshot branch/tag to default to
 */
$wgExtDistDefaultSnapshot = 'master';

Для работы расширения вам потребуется настроить некоторые параметры. For Wikimedia's Gerrit instance, it would look like:

$wgExtDistAPIConfig = array(
	'class' => \MediaWiki\Extension\ExtensionDistributor\Providers\GerritExtDistProvider::class,
	'apiUrl' => 'https://gerrit.wikimedia.org/r/projects/mediawiki%2F$TYPE%2F$EXT/branches',
	'tarballUrl' => 'https://extdist.wmflabs.org/dist/$TYPE/$EXT-$REF-$SHA.tar.gz',
	'tarballName' => '$EXT-$REF-$SHA.tar.gz',
	'repoListUrl' => 'https://gerrit.wikimedia.org/r/projects/?p=mediawiki/$TYPE/',
);

$wgExtDistSnapshotRefs = array(
	'master',
	'REL1_25',
);

The Gerrit provider requires an independent tarball generator, the source code for the one running at extdist.wmflabs.org can be found: https://github.com/wikimedia/labs-tools-extdist