Help:TemplateStyles/fr

TemplateStyles est un outil permettant d'activer des feuilles de style (CSS) pour les modèles sans les droits d'administrateur.

Fonctionnement
Les contributeurs peuvent ajouter  à une page et le contenu d'  sera analysé comme code CSS, nettoyé et chargé sur les pages où la balise   est utilisée (directement ou en étant utilisé dans un modèle qui est utilisé sur une page).

Le modèle de contenu de  doit être  , le modèle de contenu par défaut pour les sous-pages de l'espace de nom   qui se terminent par. Il est recommandé d'enregistrer la feuille de style d’un modèle dans une sous-page de ce modèle, par exemple d’enregistrer la feuille de style de  dans.

Si  n'a pas de préfixe d'espace de noms, l'espace de noms   est supposé. À titre d’exemple si  est indiqué, la page chargée sera.

La balise  doit être placée avant le contenu dont on veut préciser le style, par exemple en haut d'un modèle. Il s’agit de s’assurer que le contenu des style soit chargé avant le contenu afin d'éviter le clignotement du contenu pas encore mis en forme si la page est partiellement rendue alors qu'elle est en cours de chargement.

Quels sont les problèmes qu'il résout ?
Traditionnellement, il y a deux façons de mettre en forme les modèles (ou tout autre contenu) : en utilisant du code CSS directement en ligne (c'est-à-dire en utilisant du code HTML et en y ajoutant des attributs comme  ) ou en utilisant certains messages système spéciaux tels que MediaWiki:Common.css. Aucune de ces approches ne fonctionne très bien.

Pour les éléments de style en-ligne :


 * Il n'y a pas de séparation entre le contenu et la mise en forme. Dans les cas où le contenu ne provient pas d'un modèle (comme les tableaux dans les articles), le wikicode devient trop confus pour la plupart des contributeurs.
 * Puisque les éléments style sont mélangés avec le wikicode, la mise en évidence de la syntaxe du code CSS est alors difficile ou impossible.
 * Les éléments de style doivent être répétés pour chaque élément HTML auxquels ils s'appliquent, ce qui entraîne beaucoup de copier-coller et de code difficile à lire et à maintenir.
 * Les attributs de style sont limités à un sous-ensemble de CSS. Plus important encore, les règles  requises pour la conception d'une page adaptative (responsive) ne fonctionnent pas, il est donc impossible de créer des modèles qui fonctionnent bien sur une large gamme de tailles d'écran. De plus, les éléments de style en-ligne écrasent les éléments de style dépendant des choix de l'utilisateur, de sorte que les personnalisations spécifiques, à l'habillage ou à l'appareil deviennent plus difficiles.

Pour les pages système  :


 * L'édition est limitée uniquement aux administrateurs, ce qui constitue un obstacle majeur à la participation.
 * Les restrictions d'édition ne peuvent pas être supprimées car il n'y a aucun moyen de limiter les règles CSS qui peuvent être utilisées, et certaines d'entre elles pourraient être abusées pour suivre les adresses IP des lecteurs ou même exécuter des scripts dans certains navigateurs plus anciens.
 * Les modifications sont impossibles à visualiser sans enregistrement préalable.
 * Toutes les feuilles de style doivent être chargées sur toutes les pages (qu'elles utilisent les règles CSS ou non), ce qui gaspille de la bande passante et rend le débogage plus difficile.

TemplateStyles permet aux contributeurs d'associer des règles CSS à des pages spécifiques, fournissant toute la puissance des feuilles de style CSS tout en filtrant les éléments dangereux. Il fonctionne avec des outils de prévisualisation / débogage (comme TemplateSandbox) comme prévu.

Réduire les barrières conduira, nous l'espérons, à plus d'innovation dans la manière dont les modèles sont conçus et à réduire l'importance de la taille des écrans, car sur les appareils mobiles, qui représentés la moitié des pages vues de Wikipedia, l'édition est facilitée.

Est-ce que c'est sans danger ?
Oui ! TemplateStyles inclut un analyseur CSS complet qui lit, re-sérialise, utilise des caractères d'échappement pour tout le code et supprime les règles CSS qui ne correspondent pas à sa liste blanche. L'analyseur est suffisamment avancé pour rejeter les ressources externes (telles que les images d'arrière-plan) tout en permettant d'utiliser les ressources locales (comme Commons).

De plus, les sélecteurs CSS sont réécrits de sorte qu'ils ne peuvent pas se référer à des éléments extérieurs au contenu de l'article. (Pour l'instant, il n'est pas impossible de modifier visuellement des zones en dehors du contenu de l'article en déplaçant des parties de l'article, par exemple par un positionnement absolu. Ce n'est pas un changement par rapport au statu quo, car une telle chose était déjà possible avec le wikicode mélangé avec des règles CSS).

Quelles sont les règles CSS @ qui sont reconnues ?
Actuellement, TemplateStyles accepte la plupart des propriétés CSS3 supportées par un ou plusieurs navigateurs majeurs (à partir de 2017). Au-delà des règles simples,,  ,  ,   et   /   sont également prises en charge (avec des polices d'écriture limitées aux polices dont le nom commence par TemplateStyles, pour des raisons de sécurité). Pour une liste complète des propriétés permises, voir la partie « $props » du code StylePropertySanitizer de.

Les propriétés non standard (y compris les préfixes de Vendor) ne sont pas prises en charge actuellement. Voir T162379 pour les discussions en cours.

Comment je peux cibler les définitions pour la navigation mobile ou station de travail ?
Les requête de média vous permettent d’appliquer des styles différents en fonction de la définition des dispositifs clients. Certains conseils impliques de créer par défaut des styles adaptés au mobile, et d’encapsuler les styles « bureau » dans les requêtes de média. Note: Mediawiki a choisi des points de détermination de 720 pixels et 1000 pixels pour déterminer le type de client, tablette tactile ou ordinateur de bureau.

Comment cibler un thème spécifique ?
MediaWiki fournit plusieurs classes pour les balises  et , dont une qui dépend du thème de l’utilisateur. Celles ci peuvent être ciblées par un simple sélecteur pour les éléments  ou , en incluant les classes imbriquées, suivi par une espace (dans la terminologie CSS, le combinateur descendant).

En règle générale, nous conseillons d’utiliser cette technique par soucis de cohérence de design, plutôt que de cibler les cibles mobiles et bureau car tous les thèmes peuvent être utilisés pour les définitions mobiles et bureau. Également, #Comment je peux cibler les définitions pour la navigation mobile ou station de travail ?.

Dans quel ordre sont surchargés les styles CSS ?
La règle CSS qui est appliquée est choisie par la règle de specificité (en guise d’illustration grossière, un sélecteur comme   est plus spécifique qu’un sélecteur comme .foo { margin: 5px } ). Dans les cas de spécificité égale, le style CSS qui vient en dernier dans le document remplace les styles précédents.

MediaWiki:Commons.css, other site scripts, user scripts and gadgets are loaded in the  section of the page. TemplateStyles stylesheets are loaded in the, so they override site/user script and gadget rules with equal specificity, and in the case of two TemplateStyles rules, the second overrides the first. (Notez cependant que les règles TemplateStyles sont dédoublonnées: si la même feuille de style est référencées plusieurs fois sur une page, elle est insérée seulement la première fois. Note also that "later" has to do with document position, not load order. Gadgets add their CSS after the page has fully loaded, by manipulating the page with Javascript; some add it on-demand when the user does some action such as clicking a button. Nevertheless, they add it to the head, so equally-specific CSS rules in the body get precedence over it.)

Quelles sont les fonctions anti-abus fournies ?
The design choice to store CSS in separate pages was made in part to make integration with the standard anti-abuse toolset easy. TemplateStyles CSS pages have their own content model so changes to them can be tracked or controlled with AbuseFilter, using the   variable.

CSS inclusion is tracked the same way as template transclusion, so you can see where a stylesheet is used via the "What links here" option, see what stylesheets are used on a page under "Page information" (and possibly on the edit screen, depending on what editor you use), and see what recent changes might be affecting a page using "Related changes".

TemplateStyles also leaves identifying information in the HTML code; to find out where a specific rule comes from, look at the page source, and the enclosing  tag will have an attribute like , where 123456 is the revision ID of the stylesheet (viewable with Special:Diff, for example).

Comment les décisions concernant TemplateStyles ont-elles été prises ?
L’idée d’inclure des CSS dans les modèles a été proposée et acceptée dans un appel à commentaire. Les détails techniques ont été déterminés dans un second appel et le mode d’utilisation dans une consultation des utilisateurs.

Qui est chargé de TemplateStyles ?
TemplateStyles was originally a project of the Wikimedia Reading Infrastructure team (preceded by exploratory work Coren did as a volunteer), then people moved around. It is now maintained by an ad hoc WMF team consisting of Brad Jorsch (developer), Chris Koerner (community liaison), Dan Garry (product manager), Gergő Tisza (developer) and Grace Gellerman (project manager).

Où dois-je signaler les erreurs / demander des fonctionnalités ?
Please file tasks under the TemplateStyles component in Phabricator.

Où puis-je voir l'outil en action ?
You can look at some curated examples.

The feature is enabled on all Wikimedia sites.

Template Styles depuis un module Lua
TemplateStyles can be called from a Lua module using.

Voici un code d’exemple :

Voir aussi

 * Extension:TemplateStyles, especially the #Caveats section.