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.
You can also create custom skins for 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 ← very helpful
- 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.
If you prefer an easily consumable reference alongside demos of CSS features Mozilla Developer Network CSS Reference will provide you an "up-to-date" guide to syntax and basic usage of the various elements.
Caveats
Be sure to keep your HTML markup semantic. Relying on styling to indicate meaning is a bad practice (e.g. for machine readability such as by search engines, screen readers using text-to-speech, and text browsers).
Normalized CSS
Much CSS today relies on a "reset" or "normalize" CSS to make all browsers work the same. MediaWiki does not have a reset per se, though there are built-in stylesheets such as common/commonElements.css, common/commonContent.css, common/commonInterface.css, and MediaWiki:Common.css.
If you copy CSS, watch if it depends on additional CSS.
For example jsFiddle has a checkbox for "Normalized CSS". This sets margins to 0 and resets the numbers on ordered lists. Since none of this normalization CSS is running on MediaWiki sites, you should not use it when testing MediaWiki-related code.
jsfiddle has a feature to import CSS. If you're testing against the Vector skin on English Wikipedia, the primary sheets should be (in this order):
- Legacy general (all skins that use CSS) CSS built in to core
- General and Vector CSS built-in to core
- Site CSS (MediaWiki namespace)
-
Mediawiki.org controls site CSS with the Gadgets extension, so Mediawiki:Gadget-site.css is used in place of Mediawiki:Common.css. This results in a slightly different load URL.
-
You can adjust the domain in the URL for other WMF wikis. By importing these, you can get a better idea how your CSS interacts with the CSS on WMF wikis.
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 This is to preserve the security of the login process, and to allow users to remove any unwanted customizations without being interfered with. If you are not concerned about the security risks, you can use the $wgAllowSiteCSSOnRestrictedPages configuration setting to allow custom CSS to work on these pages.
