Objectif
L’objectif de ce plugin est d’ajouter des ancres html calculées en fonction du texte de l’intertitre, et de fournir une balise pour afficher la « table des matières » d’un article (contenu de #TEXTE
)
Fonctionnement
Les intertitres ( notés {{{intertitre}}}
) seront transformés en <h3 class="spip"><a name="intertitre"></a>intertitre <a href="tdm"><img ... /></a></h3>
Le contenu de l’attribut name est calculé selon une méthode approchant celle des urls propres de spip. Aussi un intertitre {{{ceci est un intertitre spécial}}}
sera transforme en <h3 class="spip"><a name="ceci-est-un-intertitre-special"></a>ceci est un intertitre spécial</h3>
Chaque intertitre est mémorisé avec son ancre correspondante pour être reproduite dans la balise #TABLE_MATIERES
Installation
Télécharger l’archive ci-joint, puis décompresser le fichier. Copier ce répertoire tables_matieres dans le répertoire « plugins » de votre site spip. Alternativement, vous l’aurez trouvé dans l’interface de chargement automatique de SPIP, il se trouve alors dans plugins/auto
Configuration
Le plugin dispose d’un menu de configuration qui permet de choisir :
- si la table des matières doit s’insérer automatiquement ou via l’appel de la balise
#TABLE_MATIERES
- A partir de combien d’intertitres minimum, il faut générer la table des matières
- Le format des ancres générées
- ....
Utilisation
Les intertitres seront calculés automatiquement. Pour afficher la table des matières, ajouter la balise #TABLE_MATIERES
dans votre squelette à l’intérieur d’une boucle ARTICLES.
#TABLE_MATIERES
affichera les ancres de la manière suivante par défaut :
<div id="tdm" class="divers">
<h2 class="menu-titre">Table des matières</h2>
<ul>
<li><a href="#intertitre-1">intertitre-1</a></li>
<li><a href="#intertitre-2">intertitre-2</a></li>
<li><a href="#intertitre-3">intertitre-3</a></li>
</ul>
</div>
Ce qui est un modèle CSS connu puisque tout proche de celui des noisettes de la barre de navigation des squelettes par défaut de SPIP.
Notez la présence d’un noeud DOM #tdm
pour permettre l’aller/retour entre la table et les intertitres par simple clic, personnaliser l’habillage en CSS ou jouer avec la table en jQuery.
Personnalisation
Il est possible de personnaliser le modèle fourni en surchargeant le fichier modeles/tables_matieres.html
Prérequis
Ce plugin nécessite une version de SPIP récente (révision minimum : 9738, introduction de la balise #FOREACH)
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |