Extension:HTML Tags

From mediawiki.org
This page is a translated version of the page Extension:HTML Tags and the translation is 100% complete.
Manuel des extensions MediaWiki
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
  • $wgHTMLTagsAttributes

  • ‎<htmltag>
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 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>, avec seulement les attributs href et class, vous ajouterez ceci à LocalSettings.php, après avoir inclus LocalSettings.php :

$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