Extension:TemplateStylesExtender/fr

From mediawiki.org
This page is a translated version of the page Extension:TemplateStylesExtender and the translation is 100% complete.
Manuel des extensions MediaWiki
TemplateStylesExtender
État de la version : stable
Implémentation Extension de l'analyseur
Description Extends Extension:TemplateStyles with new selectors
Auteur(s) Octfxdiscussion
Dernière version 1.2.0 (2023-07-19)
MediaWiki 1.39+
PHP >=8.0
Composer octfx/template-styles-extender
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement

  • $wgTemplateStylesExtenderEnablePrefersColorScheme
  • $wgTemplateStylesExtenderEnableCssVars
  • $wgTemplateStylesExtenderEnableUnscopingSupport

L'extension TemplateStylesExtender étend l'extension TemplateStyles avec de nouveaux sélecteurs et des matchers.

Fonctionnalités

Sont pris en charge :

  • les variables CSS :
    Exemple color: var( --color-base )
  • image-rendering
  • ruby-position
  • ruby-align
  • scroll-margin-* and scroll-padding-*
  • @media (prefers-color-scheme: dark/light) media queries
  • mask-image
  • clamp
  • revert / revert-layer
  • aspect-ratio

Installation

  • Télécharger et placez le(s) fichier(s) dans un répertoire appelé TemplateStylesExtender dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'TemplateStyles' );
    wfLoadExtension( 'TemplateStylesExtender' );
    
  • Configurer selon les besoins.
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Clé Description Exemple Valeur par défaut
$wgTemplateStylesExtenderEnablePrefersColorScheme drapeau pour activer les requêtes sur les médias @media (prefers-color-scheme: dark/light) false true
$wgTemplateStylesExtenderEnableCssVars drapeau pour activer les variables CSS false true
$wgTemplateStylesExtenderEnableUnscopingSupport drapeau pour dévier le CSS des utilisateurs ayant le droit de modifier l'interface true false

Note sur les variables CSS

L'utilisation actuelle des sélecteurs :root ne fonctionne pas car les styles des modèles sont préfixés par .mw-parser-output.

Une correction possible est d'inclure l'ensemble du contenu dans un élément 'div' et d'y ajouter les déclarations, par exemple :

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Wikicode

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>


Dévier le CSS

Exemple : <templatestyles src="Foo/style.css" wrapclass="mediawiki" /> fait que le CSS est celui de .mediawiki au lieu d'être celui de .mw-parser-output.

En incluant un tel appel dans la page, vous ne rendez possibles les modifications principalement qu'aux utilisateurs ayant les droits editinterface. Une autre solution est d'inclure l'appel d'un modèle qui inclut les styles.

Voir aussi