Extension:TemplateStyles/fr

L'extension TemplateStyles introduit une balise pour spécifier qu'une feuille de style doit être chargée d'une page wiki. En l'insérant dans un modèle celui-ci pourra avoir des styles personnalisés sans avoir à les mettre dans.

Voir pour les instructions concernant l'utilisation de l'extension en tant qu'éditeur sur un wiki.

Utilisation
D'abord la page CSS doit être créée. Par défaut toute sous-page de l'espace de noms Template ayant un titre qui se termine par « .css » sera créée avec le CSS normalisé ; l'ensemble d'espaces de noms peut être ajusté avec, ou  peut être utilisé sur n'importe quelle page. Puis dans le wikicode du modèle, ajoutez la balise pour charger les styles.

Le CSS savegardé en utilisant le modèle de contenu CSS normalisé correspond strictement aux règles de validité : le CSS non valide, les règles 'at' non reconnues, et les propriétés, ou les valeurs de proriété non reconnues ou non prises en charge, ne pourront pas être sauvegardées. Si du CSS non valide est néanmoins sauvegardé, les constructions en faute seront retirées lorsque le CSS sera envoyé au navigateur.

La valeur de l'attribut  sur la balise est le titre de la page, par défaut dans l'espace de noms. Par exemple, va charger la page « Template:Example/styles.css ». Ceci va échouer si cette page n'existe pas ou si elle a un modèle de contenu différent de CSS normalisé.

Les styles peuvent être étendus dans la page en utilisant le paramètre facultatif  dans la balise, par exemple  étend les styles chargés dans n'importe quel  à l'intérieur du contenu principal analysé. Toute séquence de sélection CSS simple peut être utilisée pour le paramètre. Ceci est fait pour permettre la comparaison côte à côte de la version courante d'un modèle avec celle du bac à sable.

L'utilisation du CSS normalisé se fait comme la transclusion des modèles, et apparaît comme une transclusion sur.

Mises en garde

 * Les styles ajoutés par TemplateStyles sont étendus pour éviter de perturber l'interface utilisateur en dehors du contenu principal analysé.
 * Pour utiliser TemplateStyles pour mettre en forme quelque chose comme w:MediaWiki:Protectedpagetext, vous devrez inclure le contenu du message dans.
 * Les styles doivent être écrits pour cibler des classes CSS spécifiques, et tout ce qui génère des éléments avec ces classes doit s'assurer d'inclure également les styles lui-même plutôt que de s'appuyer sur un autre modèle pour le faire.
 * Les styles inclus par un modèle peuvent actuellement affecter le contenu de la page en dehors du contenu généré par ce modèle, mais cette capacité peut être supprimée à l'avenir et ne doit pas être invoquée.
 * TemplateStyles autorisent certaines propriétés CSS non standard. Les demandes pour prendre en charge des propriétés supplémentaires doivent être faites dans les projets css-sanitizer et TemplateStyles de Phabricator.
 * Les demandes doivent inclure des liens vers des documents de suivi des normes (par exemple sur w3.org) décrivant la syntaxe des propriétés demandées, et une analyse de la prise en charge du navigateur actuel pour les propriétés (par exemple, un lien vers une page caniuse.com à propos des propriétés).
 * Les propriétés préfixées par le fournisseur (par exemple, tout élément commençant par,   ou  ) sont susceptibles d'être refusées si elles ne sont pas nécessaires pour les navigateurs modernes.
 * Les règles  doivent utiliser un   préfixé avec TemplateStyles. Ceci devrait grandement empêcher de redéfinir les fontes utilisées partout dans le document.
 * Pour cibler des styles basés sur les habillages, utilisez un sélecteur tel que ; la spécification de l'élément   est nécessaire et doit être suivie d'un combinateur descendant (par exemple 'espace'). Les autres classes sur les éléments   ou   peuvent être ciblées de la même manière.

Autres dépendances
doit être configuré pour ne pas utiliser le rangement ou RemexHtml. Si utilisé avec l'un des pilotes Raggett, une balise au milieu d'un paragraphe (y compris dans un modèle en ligne) provoquera la rupture du paragraphe à ce point. Les autres pilotes n'ont pas été testés pour ce problème.

Erreurs possibles

 * - L'erreur peut apparaître lorsque l'on essaie de sauvegarder une page CSS du wiki ou lorsque l'on modifie les pages du modèle de contenu CSS normalisé. Ceci peut provenir de certains bogues qui nécessitent que  soit exécuté même lorsque l'extension n'a pas été installée à partir de Git.

Voir aussi

 * - utilisé pour la normalisation du CSS.
 * T483 « Appel à commentaires pour autoriser la mise en forme à partir de modèles » (concerne la possibilité de déployer cette extension sur les wikis Wikimedia)
 * Requests for comment/Allow styling in templates
 * T56864 « ResourceLoader: implémente la prise en charge de LESS dans les modules wiki (utilisateur et site), pour supporter par exemple MediaWiki:Common.less »
 * - la meilleure façon d'enregistrer le CSS sur le wiki.
 * T155813 « Décide des méthodes de stockage et de diffusion pour le CSS de TemplateStyles »
 * Il est maintenant plus facile de fabriquer du contenu pour les appareils mobiles : architecture du web dynamique à l'échelle de Wikipedia sur le blog Wikimedia.
 * Il est maintenant plus facile de fabriquer du contenu pour les appareils mobiles : architecture du web dynamique à l'échelle de Wikipedia sur le blog Wikimedia.