Extension:HTML Tags
 État de la version : stable |
|
|---|---|
| Implémentation | Balise |
| Description | Définit la balise <htmltag> permettant d'utiliser des balises HTML sur la page, parmi un ensemble de balises autorisées et d'attributs pré-specifiés par l'administrateur. |
| Auteur(s) | Yaron Koren <yaron57@gmail.com> |
| Dernière version | 0.3 (2020-01-22) |
| MediaWiki | 1.29+ |
| Modifie la base de données |
Non |
| Licence | Licence publique générale GNU v2.0 ou supérieur |
| Téléchargement | |
| Exemple | Démonstration de l'extension HTML Tags |
|
|
|
|
|
| Traduire l’extension HTML Tags sur translatewiki.net si elle y est disponible | |
L'extension HTML Tags définit la balise <htmltag> utilisable pour afficher sur les pages wiki, des balises HTML qui seraient refusées par l'analyseur MediaWiki.
HTML Tags a été développée intialement pour autoriser la prise en charge de l'utilisation des balises LRMI (Learning Resource Metadata Initiative) à l'intérieur des pages MediaWiki. Voir Implémenter LRMI pour savoir comment implémenter ces éléments en utilisant des balises HTML. Tags.
Une autre utilisation potentielle des balises HTML est de pouvoir inclure des microdonnées (particulièrement celles des types qui ne pouvaient pas être inclus auparavent).
Une démonstration de base de cette exension est disponible ici.
Code et téléchargement
Télécharger le .zip du code des balises HTML.
Ou bien télécharger le code directement de Git à partir du répertoire de code source MediaWiki. A partir de la ligne de commande, entrez :
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/HTMLTags.git
Pour afficher le code en ligne, y compris l'historique des versions de chaque fichier, allez ici.
Installation
 Avertissement : | Faites très attention à la manière dont vous configurez cette extension car si vous autorisez les balises non sécurisées, vous favorisez les failles XSS. Par exemple, en autorisant <a> comme cela est suggéré ci-après, vous permettrez au XSS d'utiliser du code tel que <htmltag tagname="a" href="javascript:alert('XSS');">cliquer ici</htmltag> |
Après avoir obtenu un répertoire 'HTMLTags' (soit après la décompression de fichiers ou suite au téléchargement via Git), placez ce répertoire dans le répertoire 'extensions' de la racine de MediaWiki. Puis au fichier 'LocalSettings.php' du répertoire racine de MediaWiki, ajoutez la ligne suivante :
wfLoadExtension( 'HTMLTags' );
Il faut alors spécifier l'ensemble autorisé des balises HTML, ainsi que celui des attributs de chacune d'elles, en utilisant la variable globale $wgHTMLTagsAttributes.
Par exemple pour autoriser la balise <a>
$wgHTMLTagsAttributes['a'] = [ 'href', 'class' ];
Si vous souhaitez autoriser la balise <fieldset> mais avec aucun attribut autorisé, ajoutez ceci :
$wgHTMLTagsAttributes['fieldset'] = [];
Utilisation
Dès que l'ensemble des balises et des attributs autorisés est spécifié, vous pouvez utiliser <htmltag> pour les placer sur les pages.
Vous utiliserez l'attribut tagname pour indiquer la balise actuelle, et vous ajouterez les autres attributs exactement comme vous voudrez qu'ils apparaissent.
Le contenu de la balise devient le contenu de <htmltag>.
Par exemple, si les lignes ci-dessus sont ajoutées et que vous voulez ajouter un lien sur une page donnée en utilisant la balise <a>, vous pouvez ajouter à la page :
<htmltag tagname="a" href="http://en.wikipedia.org/wiki/Antarctica" class="my-links">Read about Antarctica</htmltag>
Ceci ajoutera les éléments suivants au source HTML de la page :
<a href="http://en.wikipedia.org/wiki/Antarctica" class="my-links">Read about Antarctica</a>
L'appel de <htmltag> avec un nom de balise non autorisé résultera en un message d'erreur; l'appel avec un attribut non autorisé conduira simplement à ignorer cet attribut.
Voir Implémenter LRMI pour une description complète sur la manière dont cette extension et quelques modèles peuvent être utilisés pour ajouter facilement des métadonnées LRMI aux pages.
Auteurs
HTML Tags a été écrite par Yaron Koren, que vous ppouvez contacter à yaron57 -at- gmail.com.
Cette extension fut créée par Creative Commons comme partie du projet LRMI.
Historique des versions
HTML Tags est actuellement à la version 0.3.
L'historique des versions est :
- 0.1 - 1er novembre 2012 - version initiale
- 0.2 - 27 mai 2014 - les messages i18n sont transférés dans des fichiers JSON; et autres corrections
- 0.3 - 22 janvier 2020 - conversion pour l'enregistrement de l'extension
Voir aussi
- Restrictions HTML - liste des extensions qui autorisent l'inclusion de HTML brut
- Extension:AnchorHandler – permet d'insérer les balises d'ancrage
<a>dans le wikicode
| Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |