Extension:Bootstrap/zh

**MediaWiki扩展手册**
Bootstrap; 发行状态：稳定版
实现	皮肤
描述	Provides the Bootstrap 4 web front-end framework
作者	Stephan Gambke (F.trott留言)
维护者	Professional Wiki
最新版本	5.0.0 (2024-04-26)
兼容性政策	对于每个有长期支持的MediaWiki发行版本，扩展内都有对应的分支。
MediaWiki	1.39+
PHP	8.0+
数据库更改	否
Composer	mediawiki/bootstrap
许可协议	GNU通用公眾授權條款3.0或更新版本
下載	GitHub: 项目页面; git存储库URL [帮助]; 提交历史; ; 注意：; 无法由translatewiki.net; 提供本地化更新。 ; README on GitHub; Changelog on GitHub
	使用的函数钩 SetupAfterCache;

This page is a translated version of the page Extension:Bootstrap and the translation is 0% complete.

PW

The Professional Wiki team maintains this extension professionally.

Professional Wiki provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.

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

Installation

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

Usage

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 of how to include Bootstrap styles in a skin, have a look at the Chameleon skin.

Standalone

To 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;
};

Known issues

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;
}