Extension:CSS

Manuel des extensions MediaWiki

CSS État de la version : stable
Implémentation	Fonction d'analyseur
Description	Fournit une fonction d'analyseur pour ajouter aux articles : des fichiers CSS, des articles ou des règles en ligne.
Auteur(s)	Aran Dunkley Rusty Burchfield
Dernière version	3.5.0
MediaWiki	>= 1.43.0
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
Exemple	organicdesign.nz
Paramètres $wgCSSIdentifier
Accroches utilisées ParserFirstCallInit RawPageViewBeforeOutput
Traduire l’extension CSS sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension CSS permet d'inclure des feuilles de style CSS dans des articles spécifiques. Le CSS peut être un autre article, un fichier, ou un ensemble de règles définies directement dans la fonction analyseur.

Utilisation

Par exemple, étant donné un article CSS nommé "MyStyles.css" qui contient les styles prévus pour l'article "MyFancyUserPage", on ajouterait la syntaxe de la fonction analyseur suivante à ce dernier :

{{#css:MyStyles.css}}

Si par ailleurs, "MyStyles.css" était un fichier dans le répertoire /wiki/skins, il pourrait être inclus dans une page avec la syntaxe ci-dessous. Notez qu'un fichier doit être désigné par un chemin absolu commençant par une barre oblique (/) afin de le distinguer d'un titre d'article.

{{#css:/skins/MyStyles.css}}

Il est également possible d'inclure directement des règles CSS à l'intérieur de la fonction analyseur (inline) comme dans l'exemple suivant,

{{#css:
  body {
    background: yellow;
    color: red;
    font-size: 1.25rem;
  }
}}

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé CSS dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CSS
  

• Seulement lorsque vous installez à partir de Git, exécutez Composer pour installer les dépendances PHP, en entrant composer install --no-dev après vous être positionné dans le répertoire de l'extension. (Voir T173141 pour des complications potentielles.)
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'CSS' );
  

• Configurer si nécessaire.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

En option, vous pouvez initialiser l'URL de base pour les fichiers externes.

$wgCSSPath = false;  # Par défaut, relatif à $wgScriptPath
$wgCSSPath = '';  # Relatif par rapport à la racine de votre serveur
$wgCSSPath = 'https://example.org/stylesheets';  # Relatif à un site différent

Tips

Problèmes liés au changement de la couleur ou du fond d'une page donnée

Appeler la fonction d'analyseur pour utiliser le CSS à partir d'une autre page ne fonctionne pas si on veut modifier la couleur ou le fond de page, néanmoins en utilisant la fonction analyseur sur une page unique, permet en soi-même de modifier le fond. Pour contourner ce problème, il est possible de charger le CSS via une transclusion, ce qui ne fait pas apparaître le problème d'échec de chargement du fond de page.

Voir aussi

• Extension:NewPageCSS
• Extension:TemplateStyles - une extension similaire qui normalise le CSS et le sauvegarde dans des pages séparées.