Extension:HTML Tags/fr

L'extension HTML Tags définit la balise 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.

Un autre usage potentiel des balises HTML est de pouvoir inclure des microdonnées (particulièrement d'un type qui ne peut déja pas être inclus en utilisant $1).

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 :

Pour afficher le code en ligne, y compris l'historique des versions de chaque fichier, allez ici.

Installation
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 :

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

Si vous souhaitez autoriser la balise mais avec aucun attribut autorisé, ajoutez ceci :

Utilisation
Dès que l'ensemble des balises et des attributs autorisés est spécifié, vous pouvez utiliser 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.

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, vous pouvez ajouter à la page :

Ceci ajoutera les éléments suivants au source HTML de la page :

L'appel de 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

 * - liste des extensions qui autorisent l'inclusion de HTML brut
 * Extension:AnchorHandler – permet d'insérer les balises d'ancrage dans le wikicode