SPIP Blog

Du logiciel libre et de la tendresse

Accueil > Développement > balise : #TABLE_MATIERE

balise : #TABLE_MATIERE

vendredi 11 août 2006, par James

Voilà un début de doc (mince, vlà que spip-blog se met à faire de la doc maintenant....) pour le plugin ancres_intertitres.

C’est pas son emplacement final, c’est pour la terminer avant de la publier sur un truc plus fait pour ça.

Commentaires bienvenus, donc. :)

Objectif

- Ajouter des ancres html calculées en fonction du texte de l’intertitre.
- 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</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_MATIERE

Installation

- télécharger l’archive ancres_intertitres_1.9.zip
- décompresser le fichier et renommer le répertoire en « ancres_intertitres »
- copier ce répertoire ancres_intertitres dans le répertoire « plugins » de votre site spip.
- activer le plugin via l’interface (Configuration/Gestion des plugins : la petite prise electrique rouge...)

Utilisation

Les intertitres seront calculés automatiquement. Pour afficher la table des matières, ajouter la balise #TABLE_MATIERE dans votre squelette à l’interieur d’une boucle.

Note : si vous voulez afficher la table des matieres avant le #TEXTE, procedez de la facon suivante.

(l’appel de #TEXTE calcule la table et les notes. L’astuce permet aussi d’eviter l’affichage des notes en double)

#TABLE_MATIERE affichera les ancres de la maniere suivante par defaut :

- <a href="lienA">intertitreA</a><br />
- <a href="lienB">intertitreB</a><br />

pour faire une belle noisettes
on peut parametrer la balise comme suit :

<li> sera affiche avant chaque lien et </li> après

Messages

  • Ah, mais, il faut annoncer les zoziaux qui renvoient à la table qui renvoie aux intertitres qui précèdent les zoziaux qui renvoient...

    C’est pour voir si je suis ? ;-)

  • exact. Et que l’image est surchargeable en placant un fichier tdm.png dans le dossier squelettes/ (ou de son $dossier_squelettes)...

  • Pourquoi anouter dans le h3 un lien (à priori génant pour les personnes qui navigent de lien en lien dans la page) aors qu’un id sur le h3 ferrait tout aussi bien l’affaire (du moins avec des navigateur de moins de 10 ans) ?

  • Pourquoi c’est à priori gênant, un lien dans le H3 ? tu parles de parcours avec la touche TAB ?

  • tout est ok, sauf que quand je clique sur le zoiseau çà ne remonte pas à la table des matières !

    j’ai dû loupé qqchose mais quoi ?

    merci

    jean

  • Bonjour James :-)

    Très intéressant comme plugin, d’autant que je m’étais un peu penché sur la question et j’ai bricolé un filtre qui sert à produire un sommaire automatiquement dans les corps des articles...

    J’ai proposé la contrib sur Spip’Contrib dernièrement, mais il faudra patienter le temps que les différentes étapes de validation soient faites pour qu’il soit en ligne...

    En attendant, si tu souhaites découvrir ce que j’ai pu faire, je t’invite à jetter un coup d’oeil par ici : Filtre Sommaire Tableau 1.0.

    D’ailleurs, dans la contrib en cours de validation, un participant, Job, me demandais si ton plugin et mon filtre avaient des similitudes, ce que je pense, malgré quelques différences d’approche à mon sens... alors, si tu avais un petit moment, je serais heureux de connaître ton avis sur ce filtre et si c’est possible d’en faire un plugin... ou si tu penses qu’il serait mieux de l’adapter au tiens... bref, ton avis sur l’utilité d’un tel filtre...

    Merci, a+ :-)

  • Hihi, on fait de la doc sur le blog.

    Hihi, on expérimente sur le blog

    Hihi, on peut faire du « débug » sur le blog ossi ?

    En faisant le pitre dans un forum du blog de la tendresse spipienne, il m’a pris de mettre un intertitre sur une réflexion (?)... Je valide et PAF !

    Hihi, un zoziau est arrivé et se mêle de ce qui le regarde pas... Quoique.

    Un patch ? Ah mais ça mon bon mossieu, je sais pas faire qu’on dit chez nous. Mais je reste attentif, hein !

  • ah oui, c’est amusant ça :) ouais va falloir patcher

Un message, un commentaire ?

Qui êtes-vous ?
Se connecter
Votre message

Ce formulaire accepte les raccourcis SPIP [->url] {{gras}} {italique} <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.