Extension:Bootstrap

PW

L'équipe Professional Wiki maintient cette extension de manière professionnelle.

Professional Wiki fournit le support officiel uniquement pour les versions LTS de MediaWiki. Il peut fonctionner avec d'autres versions de MediaWiki.

Manuel des extensions MediaWiki

Bootstrap État de la version : stable
Implémentation	Habillage
Description	Fournit l'environnement de l'interface utilisateur web Bootstrap 4
Auteur(s)	Stephan Gambke (F.trottdiscussion)
Maintenance	Professional Wiki
Dernière version	5.0.0 (2024-04-26)
Politique de compatibilité	Pour chaque version de MediaWiki qui est une version avec support à long terme (LTE - Long Term Support) il existe une branche correspondante dans l'extension.
MediaWiki	1.39+
PHP	8.0+
Modifie la base de données	Non
Composer	mediawiki/bootstrap
Licence	Licence publique générale GNU v3.0 ou supérieur
Téléchargement	GitHub: page du projet URL du dépôt git [aide ] historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net . README on GitHub Changelog on GitHub
Accroches utilisées SetupAfterCache

L'extension Bootstrap fournit l'environnement de l'interface utilisateur web Bootstrap 4 (documentation) à MediaWiki. Il peut être activé directement ou utilisé à partir des habillages ou des extensions.

Installation

Voir les instructions d'installation pour plus d'informations sur la façon d'installer cette extension.

Utilisation

A partir d'un habillage

Utiliser \Bootstrap\BootstrapManager::getInstance() pour obtenir le singleton gérant l'environnement de Bootstrap.

Avec l'objet renvoyé,

• ajouter les modules Bootstrap à l'aide de addBootstrapModule(), addCoreBootstrapModules() et addAllBootstrapModules()
• définir les variables SCSS en utilisant setScssVariable() et setScssVariables()
• ajouter les fichiers de style à l'aide de addStyleFile()
• ajouter les fichiers gérant le cache à l'aide de addCacheTriggerFile()

Enfin, pour ajouter les styles Bootstrap et le JavaScript de la page, utiliser $out->addModuleStyles( 'ext.bootstrap.styles' ) pour les styles et $out->addModules( 'ext.bootstrap.scripts' ) pour les scripts.

Voir l'habillage Chameleon pour obtenir un exemple sur la manière d'inclure les styles Bootstrap dans un habillage.

De manière isolée

Pour activer simplement les styles Bootstrap sur toutes les pages, ajouter le code suivant à votre fichier LocalSettings.php :

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

Problèmes connus

Conséquences sur le Sélecteur universel de langues

Si l'extension Universal Language Selector (ULS) est installée, l'installation de l'extension Bootstrap fera que le menu déroulant de ULS apparaîtra désordonné et cassera le fonctionnement de sa barre de recherche (voir la copie d'écran sur GitHub). Cependant, cela peut être corrigé en ajoutant le code suivant à MediaWiki:Common.css :

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

.uls-search {
        display: block;
}

Voir aussi

Sites web

• page d'accueil de l'environnement Bootstrap
• page d'accueil de SASS/SCSS
• Bootstrap pour wiki MediaWiki — Exemples et démonstrations

Habillages et extensions

• habillage Chameleon utilisant cette extension
• habillage Medik utilisant également Bootstrap
• extension BootstrapComponents utilisant cette extension et permettant aux éditeurs d'utiliser potentiellement son balisage wiki interne

Billets de blog

• Etendre votre MediaWiki avec Bootstrap — Billet de blog sur l'amélioration de votre wiki en l'intégrant avec Bootstrap et ses composants; publié le 20 janvier 2024