Wikimore

**Manuel des extensions MediaWiki**
CSS; État de la version : stableCategory:Stable extensions/fr
Implémentation	Fonction d'analyseurCategory:Parser function extensions/fr
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
	Paramètres $wgCSSIdentifier;
	Accroches utilisées ParserFirstCallInitCategory:ParserFirstCallInit extensions/fr; RawPageViewBeforeOutputCategory:RawPageViewBeforeOutput extensions/fr;
Licence	Licence publique générale GNU v2.0 ou ulté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; Category:Extensions in Wikimedia version control/fr
Exemple	organicdesign.nz
	Traduire l’extension CSS sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

Category:GPL licensed extensions/frCategory:All extensions/fr

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.)Category:Extensions requiring Composer with git/fr
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.

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :

Category:User interface extensions/fr Category:Script embedding extensions/fr Category:CSS/fr