Extension:Bootstrap/ru

This page is a translated version of the page Extension:Bootstrap and the translation is 44% complete.
Справка по расширениям MediaWiki
OOjs UI icon advanced-invert.svg
Bootstrap
Статус релиза: стабильно
Реализация Тема оформления
Описание Provides the Bootstrap 4 web front-end framework
Автор(ы) Stephan Gambke (F.trottобсуждение)
Поддерживающий(ие) Professional Wiki
Последняя версия 4.6.0 (2022-03-30)
Политика совместимости Master maintains backward compatibility.
MediaWiki 1.29+
PHP 5.6+
Изменения в БД Нет
Composer mediawiki/bootstrap
Лицензия GNU General Public License 3.0 или позднее
Скачать
README on GitHub
Changelog on GitHub
Quarterly downloads 0
Public wikis using 380 (Ranked 337th)

The Bootstrap extension provides the Bootstrap 4 (version 4.6.1) web front-end framework to MediaWiki. It can be activated directly or used from skins or extensions.

Установка

See the installation instructions for information on how to install this extension.

Использование

Within a skin

Use \Bootstrap\BootstrapManager::getInstance() to get the singleton managing the Bootstrap framework.

With the returned object,

  • add Bootstrap modules using addBootstrapModule(), addCoreBootstrapModules(), and addAllBootstrapModules()
  • set SCSS variables using setScssVariable() and setScssVariables()
  • add style files using addStyleFile()
  • add cache trigger files using addCacheTriggerFile()

Finally to add the Bootstrap styles and javascript to the page use $out->addModuleStyles( 'ext.bootstrap.styles' ) for styles and $out->addModules( 'ext.bootstrap.scripts' ) for scripts.

For an example on how to include Bootstrap styles in a skin have a look at the Chameleon skin.

Standalone

To simply enable Bootstrap styles on all pages add the following code to your "LocalSettings.php" file:

$wgHooks['SetupAfterCache'][] = function(){
	\Bootstrap\BootstrapManager::getInstance()->addAllBootstrapModules();
	return true;
};


$wgHooks['ParserAfterParse'][]=function( Parser &$parser, &$text, StripState &$stripState ){
	$parser->getOutput()->addModuleStyles( ['ext.bootstrap.styles'] );
	$parser->getOutput()->addModules( ['ext.bootstrap.scripts'] );
	return true;
};

Известные проблемы

Effect on Universal Language Selector

If you have the Universal Language Selector (ULS) extension installed, installing the Bootstrap extension will make the ULS's dropdown-menu look disordered and break its search bar (screenshot on GitHub). However, this can be fixed by adding the following code to MediaWiki:Common.css:

.uls-language-list {
        display: block;
}

.uls-search {
        display: block;
}

См. также


This extension is professionally maintained by the Professional Wiki team.