Manuel:CSS
Les règles Cascading Style Sheet (CSS) définissent en grande partie l'apparence de MediaWiki : la taille de police, les couleurs, l'espacement, le logo et l'image d'arrière-plan, même si le contenu du site est affiché ou est masqué.
Le CSS peut être utilisé pour changer le style de l'ensemble du wiki, par exemple pour rendre l'arrière-plan d'une couleur différente, ou vous pouvez utiliser CSS en ligne pour le style des morceaux de texte spécifiques dans votre wiki. Par exemple texte en vert peut être accompli en faisant <span style="color:green;">texte en vert</span>body { font-size: larger; }
Pour changer l'apparence et la sensation de l'affichage de votre MediaWiki (présentation dans un navigateur), vous pouvez mettre le CSS dans MediaWiki:Common.css.
Pour changer la façon dont les pages de MediaWiki s'affichent à "l'impression", vous pouvez mettre du CSS dans MediaWiki:Print.css sur votre wiki
Si enabled sur votre wiki, les utilisateurs individuels peuvent créer des feuilles de style personnalisées pour eux-mêmes à Special:MyPage/<skin_name>.css (par exemple Special:MyPage/vector.css S'ils utilisent l'habillage Vector). Special:MyPage/common.css permet la création de feuilles de style personnelles pour tous les habillages.
Vous pouvez également créer des habillages personnalisés pour MediaWiki.
Contents
Aide
La syntaxe CSS, les attributs et les valeurs, doivent être corrects sinon cela ne fonctionnera pas correctement. World Wide Web Consortium (W3C) est une excellente référence pour vérifier que le code CSS est rédigé correctement, en accord avec les standards:
- https://www.w3.org/TR/CSS21/propidx.html -- CSS 2.1 Index of properties ← très utile
- http://www.w3.org/TR/CSS21/indexlist.html -- CSS 2.1 Index of everything
- http://www.w3.org/TR/CSS21/cover.html#minitoc -- CSS 2.1 Table des matières
Wikipédia donne un bon aperçu du CSS.
Si vous préférez une référence facilement consommable aux côtés de démonstrations de fonctionnalités CSS Mozilla Developer Network CSS Reference vous fournira un guide "à jour" pour la syntaxe et l'utilisation de base des différents éléments.
Mises en garde
Assurez-vous de conserver votre sémantique de balisage HTML. S'appuyer sur le style pour indiquer le sens est une mauvaise pratique (par exemple pour la lisibilité de la machine, par les moteurs de recherche, les lecteurs d'écran utilisant le texte à la parole et les navigateurs de texte).
CSS Normalisé
Beaucoup de code CSS s'appuie aujourd'hui sur un CSS "réinitialisé" ou "normalisé" pour que tous les navigateurs fonctionnent de la même manière. MediaWiki n'a pas de réinitialisation en soi, bien qu'il existe des feuilles de style intégrées telles que common/commonElements.css, common/commonContent.css, common/commonInterface.css et MediaWiki:Common.css.
Si vous copiez du code CSS, vérifiez qu'il ne dépende pas de code CSS supplémentaire.
Par exemple, jsFiddle a une case à cocher pour "CSS normalisé". Ceci définit marges vers 0 et réinitialise les nombres sur les listes commandées. Comme aucun de ces CSS de normalisation ne s'exécute sur les sites MediaWiki, vous ne devriez pas l'utiliser lors du test du code relatif à MediaWiki.
jsfiddle possède une fonctionnalité d'importation de CSS. Si vous testez l'habillage Vector sur Wikipédia en anglais, les premières feuilles devraient être (dans cet ordre) :
- Code CSS intégré au noyau (tous les habillages qui utilisent CSS)
- CSS Général et Vector intégrés au noyau
- Site CSS (espace de noms MediaWiki)
- Mediawiki.org contrôle le site CSS avec l'extension Gadgets, donc Mediawiki:Gadget-site.css est utilisé à la place de Mediawiki:Common.css. Il en résulte une URL de chargement légèrement différente.
Vous pouvez ajuster le domaine dans l'URL pour d'autres wikis WMF. En les important, vous pouvez avoir une meilleure idée de la façon dont votre CSS interagit avec le CSS sur wikis WMF.
Les styles ne fonctionnent pas sur Special:UserLogin ou Special:Preferences?
Par défaut, les customisations CSS du site (ex. MediaWiki:Common.css) ne prend pas effet sur la page de login et des préférences
Il s'agit de préserver la sécurité du processus de connexion et de permettre aux utilisateurs de supprimer les personnalisations indésirables sans être gênés.
Si vous n'êtes pas préoccupé par les risques de sécurité, vous pouvez utiliser le paramètre de configuration $wgAllowSiteCSSOnRestrictedPages pour permettre aux CSS personnalisés de fonctionner sur ces pages.
