Des intertitres hiérarchisés et des outils pour les manipuler

Des intertitres auxquels on peut faire appel...

Cet article décrit les fonctions du plugin Intertitres hiérarchisés et table des matières qui donne accès à des intertitres de niveaux différents ainsi qu’à des modèles permettant de faire une table des matières, des renvois et d’avoir accès à des extraits d’articles. Ces modèles peuvent s’insérer dans les squelettes ou à l’intérieur des articles.

Cette contrib’ est dérivée de Génération automatique de numérotation, table des matières et références écrit par mortimer et chtitux.

Je l’ai mise sous forme de plugin, adaptée à SPIP>1.9 et fait quelques modifications [1].

Elle permet :

-  d’utiliser des intertitres hiérarchisés (plusieurs niveaux de titres) dans vos articles grâce à de nouveaux raccourcis typographiques,
-  d’afficher grâce à un modèle une table des matières dans vos articles et/ou vos squelettes,
-  d’afficher des renvois vers certaines parties d’un article dans vos articles,
-  d’afficher des extraits plus ou moins longs et plus ou moins ciblés d’un article
-  d’extraire des éléments signifiants d’un article.

Actuellement ce plugin est en développement. Cependant il est assez stable pour être utilisé. Il est par exemple utilisé par un site institutionnel : http://svt.ac-creteil.fr.

Des intertitres hiérarchisés

Ce plugin rajoute des raccourcis typographiques pour gérer des niveaux d’intertitres. Ces raccourcis, imaginés par mortimer, s’inspirent des listes et des énumérations de SPIP. C’est à dire que les intertitres utilisent désormais des * ou des # pour que soit déterminé leur niveau :

-  {{{*exemple de premier niveau}}} est un titre de premier niveau (équivalent à {{{exemple de premier niveau}}}),
-  {{{**exemple de titre de second niveau}}} est un titre de second niveau.

Ainsi ce type de contenu dans un article :

{{{*Les outils}}}
{{{**Les trucs qui vissent}}}
Il y en a plein !
{{{***À la main}}}
{{{****Tourne-vis}}}
- cruciforme
- plat
- etc.
{{{***Assisté}}}
{{{****Visseuse}}}
- à fil
- sans fil
{{{**Les trucs qui coupent}}}
snip...
{{{***Ciseaux}}}
{{{****À bois}}}
c'est dangereux ça !
{{{**Les trucs qui frappent (aïe)}}}
{{{***Marteau}}}
trop dangereux pour moi...

Va donner :

Les outils

Les trucs qui vissent

Il y en a plein !

À la main
Tourne-vis

 cruciforme
 plat
 etc.

Assisté
Visseuse

 à fil
 sans fil

Les trucs qui coupent

snip...

Ciseaux
À bois

c’est dangereux ça !

Les trucs qui frappent (aïe)

Marteau

trop dangereux pour moi...

Si à la place des *, vous utilisez des #, les intertitres seront numérotés en utilisant une numérotation scientifique du genre x.y.z.... Ex. :

{{{#Avec des numéros}}}
{{{##de plusieurs niveaux}}}
{{{##C'est une notation scientifique...}}}
{{{#Qui s'incrémentent automatiquement}}}

donne :

1- Avec des numéros

1.1- de plusieurs niveaux

1.2- C’est une notation scientifique...

2- Qui s’incrémentent automatiquement

Donc, l’utilisation des * et/ou des # après le raccourci classique pour les intertitres {{{ permet de hiérarchiser.

Coté HTML, les intertitres hiérarchisés sont transformés en headlines de type <hx class="spip">x est un chiffre allant de 3 à 6 [2]. De plus, chaque intertitre (numéroté ou non) contient une ancre <a name='x.y.z...'></a>x.y.z... est le numéro de l’intertitre. Cette ancre est utilisée par les modèles qui accompagnent ce plugin.

Un fichier CSS installé avec le plugin permet de gérer l’aspect des intertitres dans la partie privée de SPIP. Pour la partie publique, il vous suffit de définir hx.spip {} dans vos propres fichiers CSS pour déterminer comment ces intertitres s’affichent.

Notez que les intertitres des enluminures typographiques sont compatibles avec ce plugin.

Une table des matières

Ce plugin fournit un modèle <table_des_matieres> que l’on peut utiliser dans les articles ou dans les squelettes pour afficher une table des matières qui renvoie vers les intertitres. Elle se présente sous la forme d’une liste de puces (hiérarchisées) avec les intertitres sous forme de liens. Cette table des matières est précédée d’une ancre nommée « table_des_matieres » (<a name="table_des_matieres"></a>), elle est dans un bloc ayant pour identifiant « tablematiere » (<div id="tablematieres">blabla</div>).

Dans les articles, le modèle s’utilise ainsi :

<table_des_matieresXXX>XXX est le numéro de l’article dont vous souhaitez afficher la table des matières.

Dans les squelettes, vous pouvez utiliser :

[(#MODELE{table_des_matieres}{id=XXX})]XXX est le numéro de l’article dont vous souhaitez afficher la table des matières. Notez que XXX peut aussi être une balise comme #ID_ARTICLE.

Comme indiqué précédemment, notez que les intertitres des enluminures typographiques sont compatibles avec ce modèle.

Des renvois vers un intertitre (ou autre)

Ce plugin fournit un autre modèle <renvoi>. Il permet d’afficher l’intertitre d’une sous-partie précise d’un article avec un lien vers elle.

Dans les articles il s’utilise ainsi :

<renvoiXXX|partie=YYY>XXX est le numéro de l’article et YYY est le numéro de la sous-partie. Que l’intertitre soit numéroté ou non, le numéro de la sous-partie est de la forme x.y.z... [3].

À partir de L’exemple des outils qui est présenté au début de cet article : <renvoi2567|partie=1.2.3.3> donnera :

À bois

(2567 est le numéro de cet article et 1.2.3.3 correspond à la sous-partie sur le ciseau à bois... Si si ! comptez...)

Donc, écrire <renvoiXXX|partie=YYY> équivaut à écrire [intertitre de la sous-partie YYY|un extrait avec les 20 premiers mots de la sous-partie (...)->XXX#YYY] sauf que l’intertitre et l’extrait sont déterminés automatiquement par le modèle (et modifiés automatiquement si quelqu’un modifie l’article auquel on renvoie).

Dans les squelettes, le principe est le même, et la syntaxe est :

[(#MODELE{renvoi}{id=XXX}{partie=YYY})]

Comme indiqué précédemment, notez que les intertitres des enluminures typographiques sont compatibles avec ce modèle.

Des extraits d’articles ou de sous-parties d’articles

Voici deux modèles <extrait> et <extrait|partie> qui permettent d’afficher des morceaux d’articles ou de sous-parties d’articles.

Pour afficher un extrait d’article dans un autre article, il faut utiliser le modèle <extraitXXX|debut=YY|taille=ZZ>XXX est le numéro de l’article. debut et taille sont optionnels [4]. taille permet de fixer le nombre de mots à afficher dans l’extrait. debut permet de déterminer à partir de quel mot commencer l’extrait (debut est le n° de ce mot, la numérotation commence à 0).

Ex. : <extrait2567|debut=55|taille=38> permet d’afficher un extrait de 38 mots de l’article n°2567 (c’est celui-ci) à partir du 55e mot.

Notez pour la présentation et l’aspect sémantique que les extraits sont affichés entre balises <quote>extrait de l'article</quote>. Ils sont précédés de « (...) » si l’extrait ne commence pas au mot 0, et toujours terminés par « (...) ».

Les raccourcis typographiques qui étaient présents dans les extraits sont retirés automatiquement (le texte passe dans le filtre textebrut).

Il est aussi possible de faire des extraits d’une sous-partie du texte d’un article. Une sous-partie est un morceau du texte délimité par des intertitres de même niveau.

Le principe à peu près le même que pour le modèle précédent.

Pour afficher un extrait d’une sous-partie dans un autre article, il faut utiliser <extraitXXX|partie|partie=x.y.z|debut=YY|taille=ZZZ> qui fonctionne comme précédemment sauf que partie=x.y.z correspond au numéro de l’intertitre de la sous-partie dont on souhaite afficher l’extrait. Voir la documentation des renvois ci-dessus.

Ex. : <extrait2567|partie|partie=1.2.3.3|debut=4|taille=5> permet d’afficher un extrait de 5 mots de la partie sur le ciseau à bois (n°1.2.3.3) de l’article n°2567 (c’est celui-ci) à partir du 4e mot.

Comme précédemment la citation est dépourvue de raccourci typographique. Sauf l’intertitre qui est rajouté au début de la citation.

Bien sûr, ces deux modèles peuvent être utilisés dans les squelettes :

-  [(#MODELE{extrait}{id=XXX}{debut=YY}{taille=ZZZ})]
-  [(#MODELE{extrait_partie}{id=XXX}{partie=x.y.z}{debut=YY}{taille=ZZZ})]

Comme indiqué précédemment, notez que les intertitres des enluminures typographiques sont compatibles avec ce modèle.

Quelques filtres pour afficher des morceaux signifiants d’un article

Ces filtres sont tirés de la contrib’ Résumé d’article automatique.

Compatibilité

Les intertitres fournis par le plugin Plugin Enluminures typographiques pour SPIP 1.9.2 de RealET qui s’écrivent {2{, {3{, {4{, etc. sont pris en compte par ce plugin avec les équivalences : {1{={{{*={{{, {2{={{{**, etc.

Le plugin les transforme à la volée, si bien qu’ils fonctionnent pour tous les modèles, comme si ils étaient écrits avec des {{{*(...)*.

Les utilisateurs de la contrib’ de mortimer et chtitux dont est tiré ce plugin (Génération automatique de numérotation, table des matières et références) auront peu de changements à faire car il y a une certaine compatibilité ascendante.

Il faut noter cependant que :

-  dans la contrib’ originelle, les intertitres étoilés ({{{*(...)*) généraient une numérotation automatique des titres. Désormais, cette numérotation est réservée aux intertitres avec des #. Donc, si vous souhaitez conserver la numérotation, il faudra transformer les * en # dans les articles.
-  La balise #TABLEMATIERES qui placée dans les articles, affichait la table des matières est remplacée par le modèle <table_des_matières> (ce qui permet de choisir entre mettre une table des matières dans les articles ou dans les squelettes). Dans ce plugin #TABLEMATIERES affiche un lien vers la table des matières présente dans la page (lien vers l’ancre « table_des_matieres ») et non la table des matières elle-même.
-  Dans la contrib’ originelle, les raccourcis des intertitres étaient remplacés par des <h3 class="spipheadx">

x est le niveau de titre. Ce plugin les remplace par des <hx class="spip"> ce qui est plus correct du point de vue sémantique/accessibilité.
-  La contrib’ permettait de personnaliser les ancres présentes dans les intertitres (ex. : {{{**mon titre <mon_ancre_à_moi>}}}). Cela reste fonctionnel dans ce plugin et fonctionne avec les modèles.

Changements depuis la toute première version :

  • Version 0.9.4 du 31/07/2012
    Compatibilité SPIP 3.0.
  • Version 0.6 du 08/02/09 :
    correction du bug signalé par gilcot dans le forum corrigé.
  • Version 0.5 du 24/01/09 :
    • L’ancre table_des_matieres est désormais sans accent... C’est plus pratique !
    • Les ancres sont protégées dans le filtre extrait_lien (avant les ancres étaient listées comme des liens)
    • Les caractères accentués sont remplacés par des entités dans le code généré par le plugin
    • des css pour les intertitres du site public (idéal pour ceux qui restent avec la dist. Les autres devront créer les leurs)
    • Compatible Spip 2 grâce au passage aux pipelines (plutôt que les options)
    • renommage de fichiers et de fonctions (attention à ceux qui surchargent)
  • Version 0.4 du 19/12/08 :
    • Amélioration de Stéphane Deschamps : désormais les variables $GLOBALS['debut_intertitre'] et $GLOBALS['fin_intertitre'] sont prises en compte dans la numérotation des headlines des intertitres, quand elles sont définies par le webmestre.
    • Les balises <code> sont protégées dans les extraits
    • Les modèles prennent désormais en compte tous les articles (quel que soit leur statut).
    • Le bug des tables des matières externes est corrigé. Vous pouvez par exemple mettre un <table_des_matieres122> dans l’article 245 sans souci.
  • Version 0.3 du 04/10/08 :
    • Correction d’un bug qui dupliquait les notes de bas de page.
  • Version 0.2 du 21/09/08 :
    • Correction d’un gros bug qui empêchait le plugin de fonctionner correctement (disparition des images ou des autres modèles après un renvoi dans un article).
    • Toutes petites améliorations typographiques.

Développements futurs

-  intégration dans la barre typo V2 (voir travaux de gilcot dans le forum)
-  faire des modèles supplémentaires (notamment pour exploiter les filtres de Résumé d’article automatique), et documenter tout ça ici même.
-  faire en sorte que les intertitres hiérarchisés soient pris en compte par les contribs/plugin qui produisent autre chose que du HTML (du PDF par exemple).

Ce plugin sous licence GPL est développé sur la forge git

Notes

[1Les modifications principales sont :

-  mise en plugin
-  des * pour les titres non numérotés
-  des # pour les titres numérotés
-  #TABLEMATIERES renvoie désormais vers une table des matières située ailleurs grâce au modèle <table_des_matieres>
-  etc.

[2Si vous avez fixé une valeur de $GLOBALS['debut_intertitre'] et $GLOBALS['fin_intertitre'], elle est prise en compte grâce à une modification de Stéphane Deschamps : les intertitres sont numérotés à partir de cette valeur. Voir aussi le message de Stéphane.

[3Notez que ce modèle utilise les ancres, il est donc possible de mettre n’importe quelle ancre de l’article à la place de YYY, s’il n’y a pas d’intertitre associé à l’ancre choisie, le modèle renvoie à la place le titre de l’article

[4si debut et taille ne sont pas indiqués, ce sont leurs valeurs par défaut qui sont utilisées, c’est-à-dire 0 pour debut et 20 pour taille

En attendant la réalisation d’un logo spécifique, le logo de cet article est une photo de timetrax23 sous licence Creative Commons « Paternité-Partage des Conditions Initiales à l’Identique 2.0 Générique » que vous retrouverez .

Discussion

33 discussions

  • 6

    aussitôt la compatibilité SPIP 2 du plugin intertitres hiérarchisés annoncé ;
    j’ai tenté et testé un hack vite fait, largement/honteusement inspiré/pompé des enluminures typographiques : ça fonctionne chez moi :) je le livre donc à un plus large test et critiques

    • bonjour.

      j’ai entre temps travaillé sur une une meilleure intégration à la barre typographique afin d’avoir quelque chose de plus spécifique/adapté aux Intertitres Hiérarchisés (et il y a aussi les renvois et les extraits...)
      voici donc la nouvelle monture pour tests et critiques (pour le problème des ancres personnalisées, j’y travaille encore et au final, je crois que je vais scinder les deux cas car mes compétences en javascript sont à leur limite).

    • Salut !

      1- le bug apparu dans la v0.5 (avec l’espace privé) est corrigé (par un retour du fichier options) ->0.6

      2- j’aime beaucoup tes propositions pour les noms des modèles, je pense qu’on peut les rajouter avec des raccourcis vers les modèles « historiques » (pour compatibilité ascendante) :

      Ex. pour la table des matières, il suffit de rajouter dans modeles le fichier article_table.html :

      [
      
      (#REM) Raccourci vers le modèle de tables matières
      
      
      ]#MODELE{table_des_matieres,id=#ENV{id_article}}

      ou dans article_tdm pour éviter des ambigüités avec d’autres plugins qui manipuleraient des tables (MysQL, ou des tableaux)...

      3- je vais regarder en détail ce que tu as fait pour la BTv2. De prime abord je me demande si c’est compatible avec les enluminures ? Les deux peuvent coexister ?

      4- La BT va disparaitre avec Spip 2.1 remplacée sans doute par le porte plume : il faudra réfléchir à ça aussi.

      5- je t’invite à participer officiellement au développement de ce plugin : tu peux directement travailler sur la Zone !!! (D’ailleurs, tout le monde est invité !!). C’est plus simple a gérer que les zip, les différences entre les versions sont plus faciles à analyser et on sait plus facilement qui fait quoi. Donc gogogo !

      Et encore merci pour les efforts que tu fais pour ce plugin !

    • je vais regarder en détail ce que tu as fait pour la BTv2. De prime abord je me demande si c’est compatible avec les enluminures ? Les deux peuvent coexister ?

      j’ai testé la première monture avec les ET sans soucis (mon test ceci dit est sommaire car je n’utilise par ET : j’ai juste installé les deux et créé un article de test mélangeant des fonctionnalités des deux et vérifiant que la barre ne beugue pas..) donc, il semble que les deux peuvent coexister.
      et bien sur, les intertitres continuent de fonctionner quand BTv2 n’est pas installé (il n’est pas en requis...), et BTv2 fait apparaitre/disparaitre la portion relative aux Intertitres quand le plugin est activé/désactivé ^^

      La BT va disparaitre avec Spip 2.1 remplacée sans doute par le porte plume : il faudra réfléchir à ça aussi.

      j’ai installé et utilise (plus mes rédacteurs car je suis un peu vieille école) la BTv2 et c’est la raison pour laquelle je travaille à son intégration des Intertitres et non celle de FCKeditor par exemple :) je passerai à l’intégration du PP dès que je commencerai à l’utiliser...
      ceci dit, je viens de jeter un œil et je dois avouer qu’il me semble plus facile à programmer et à étendre (parce-que la barre actuelle n’est pas extensible, m’obligeant à modifier le core chaque fois pour un de mes sites et c’est cela aussi qu’essaye d’adresser la BTv2 avec son système de pipeline ; mais écrire des fonctions mélangeants php et js est un poil plus ardu que de déclarer des tableaux associatifs php je trouve) donc j’attends vivement la sortie officielle de PP :)

    • La BTv3 intègre désormais par défaut le fonctionnement avec les raccourcis typo {{{* }}}.

      Par contre, les # ne sont pas intégrés car — de mon point de vue — c’est à la CSS de s’occuper de ça...

    • Oups, je voulais bien sûr parler des ETv3 (Enluminures typographiques V3).

    • La BTv3 intègre désormais par défaut le fonctionnement avec les raccourcis typo *

      Bonne nouvelle cette convergence !
      Est-ce que les ET déposent aussi des ancres (ou des id) dans les titres ?

      Par contre, les # ne sont pas intégrés car — de mon point de vue — c’est à la CSS de s’occuper de ça...

      Dommage, il y a quand même une différence sémantique entre <ol> et <ul> non ?...

      De mon coté j’ai peu de temps, mais je vais essayer de revoir un peu le code du plugin d’ici quelques semaines. Si j’arrive à comprendre comment fonctionne les ETv3 (je suis vraiment nul en PHP) j’essaierai peut-être de terminer cette fusion que tu as entamée.

    Répondre à ce message

  • 3

    Bonjour,
    je suis personnellement un utilisateur d’intertitres hiérarchisés. Cependant, dans la mesure où cela n’est pas dans le core, une fois qu’on utilise un tel outil, difficile de revenir en arrière. Tout d’abord ce plugin assure la compatibilité avec les raccourcis {2{ }2} d’enluminures typo V2. C’est un point important. Cependant, fournit-il les fonctionnalités suivantes (réservées au webmaster du site) :
    -  Convertir en masse les codes {{{** }}} et {{{## }}} en {2{ }2} au cas où l’on décide de désinstaller ce plugin pour le remplacer par Enluminures Typo ?
    -  Convertir en masse les codes {{{** }}} et {{{## }}} en {{{ }}} au cas où l’on souhaite supprimer définitivement le plugin du site (retour en arrière irréversible) ?

    Cette critique n’est pas propre à ce plugin mais à tout plugin ajoutant de nouveaux raccourcis typographiques. Il faut permettre à l’utilisateur de pouvoir désinstaller définitivement le plugin.

    Encore bravo pour ce travail et bien cordialement

    • Bonjour !

      Je suis très heureux que tu sois un utilisateur convaincu des intertitres hiérarchisés !

      Il n’existe pas actuellement de système de désinstallation, et je n’ai malheureusement pas le temps de m’en occuper. Par contre, comme je le disais à Stéphane plus tôt, le développement de ce plugin est un développement ouvert (auquel chacun peut participer) par le SVN de Spip zone : donc libre à toi d’y travailler si tu le peux !

      Toutefois, on peut très bien faire cohabiter ce plugin avec les enluminures typo (comme tu le disais) et donc continuer à utiliser les {2{ }2} sans souci (il n’est pas nécessaire de passer aux {{{** }}} lorsque l’on installe le plugin Intertitres hiérarchisés et table des matières !).

      Par contre, il est sûr que l’utilisation de plugins qui rajoutent des raccourcis typographiques est sans retour (comme le mentionne très bien la contrib’ sur les enluminures typo).

      Désolé de ne pas pouvoir t’apporter plus d’éléments ! Ce que je peux ajouter est qu’une telle désinstallation demande de vérifier toutes les entrées de la base de données : de les passer dans une expression régulière qui va rétablir les raccourcis originaux. Puis remettre l’article modifié dans la base. Cela me paraît un énorme calcul, surtout pour les grosses bases de données (la base de données du site pour lequel ce plugin a été conçu contient plus de 3000 articles... Je connais au moins un site Spip qui l’utilise aussi avec plus 50000 (oui, cinquante mille) articles !!!).

    • bonjour Joseph.
      puisqu’aucun de ces deux plugins n’est installé sur spip-contrib, on peut comparer le résultat de leur désactivation ici :)

      avec Intertitres Hiérachisés

      {{{** Les trucs qui coupent}}}
      snip...
      {{{*** Ciseaux}}}
      de toutes les sortes... 
      {{{**** À bois}}}
      c'est dangereux ça !

      produit ce qui suit..

      Les trucs qui coupent

      snip...

      Ciseaux

      de toutes les sortes...

      À bois

      c’est dangereux ça !

      avec Enluminures Typographiques

      {2{ Les trucs qui coupent}}
      snip...
      {3{ Ciseaux}}
      de toutes les sortes... 
      {4{ À bois}}
      c'est dangereux ça !

      produit ce qui suit..

      2 Les trucs qui coupent
      snip...
      3 Ciseaux
      de toutes les sortes...
      4 À bois
      c’est dangereux ça !

      conclusion

      certe on a introduit de nouveaux raccourcis, mais ceux des intertitres hiérachisés restent compatibles avec le fonctionnement normal de SPIP et quand le plugin est désinstallé, les titres demeurent des titres (ils ne perdent que leur hiérarchisation sémantique (Hx) et visuelle (via les CSS), mais on devine dans les titres normaux SPIP les niveaux d’importance des titres qui sont écrits comme dans les documents purement textuels (ils sont souvent doublés de tirets de soulignement pour ne pas être confondu avec de simples listes) :)

      en tout cas, pour ma part, c’est bien moins gênant si on décide de revenir en arrière (encore que je me demande bien pourquoi).

    • bon, j’ai validé par inadvertance avant de terminer ma conclusion :( je termine donc et complète mon long message :)

      pour ce qui est donc du fait de :

      Convertir en masse les codes {{{** }}} et {{{## }}} en {{{ }}} au cas où l’on souhaite supprimer définitivement le plugin du site (retour en arrière irréversible) ?

      le retour en arrière est irréversible quand on utilise des raccourcis non standards de SPIP (sauf si on peut retoucher les articles à la main...) mais ce n’est pas si dommageable avec ce plugin... et comme le souligne Bert, ce genre d’opération est très lourde (et pas forcément efficace).

      concernant le fait de :

      Convertir en masse les codes {{{** }}} et {{{## }}} en {2{ }2} au cas où l’on décide de désinstaller ce plugin pour le remplacer par Enluminures Typo ?

      ce type de conversion est du même acabit que que le précédant (transformer les {{{** en {{{ : trop lourd (et risqué). mais la compatibilité assurée par ce plugin —comme tu l’as notée— permet de ne pas avoir à faire de conversion quand on a été utilisateur des Enluminures Typo. mieux, si tu as une préférence pour celle-là, les deux plugins peuvent cohabiter sans problème (et tu devrais pouvoir utiliser la table des matières sans la syntaxe —quand même meilleure— ainsi que certaines autres fonctionnalités)

      plus de compatibilité avec la core et moins de casse...

      je voudrais poursuivre sur le choix des raccourcis fournis et leur résultat lorsque l’on désactive ou désinstalle le plugin.
      ainsi, les * ou # rajoutés aux {{{ ne sont pas si pénalisants (de mon point de vue). j’aurais de la même façon voulu que les ancres personnalisés utilisés avec les intertitres soient de vrais ancres spipiennes (donc encadrés de [<code> et <code><-]) et non ce qui fait penser à un raccourci (donc encadrés de <<code> et <code>>) : cela aurait aussi l’avantage de ne pas casser les liens existants et même de récupérer ceux qui existent avant l’activation du plugin...

      dans le même ordre d’idée (casser le moins quand on désinstalle/désactive le plugin car en n’apportant que la cerise sur le gâteau par simple extension de la syntaxe existante), j’ai pour ma part renommé les modèles de façon à suggérer qu’il s’agit de l’extension de du modèle de base article (et garder donc les liens —mais sans les bonus et la présentation— lorsqu’on désactive) :
      -  table_des_matieres en article_table (avec la prise en compte des niveau et des numéreaux, il s’agit d’une véritable table des matières et non d’un sommaire)
      -  renvoi en article_renvoi
      -  extrait en article_extrait (ce renommage est moins pertiant)
      -  extrait_partie en article_partie (ce renommage est moins pertiant)

      voilà mes réfléxions actuelles sur ce plugin :/

    Répondre à ce message

  • 5

    voilà un plug-in que j’aime bien car j’utilise pas mal les intertitres et c’est le seul qui me faisait quelque chose de correct (aussi bien dans la syntaxe que dans le résultat). mais je suis hélas passé à la v2 de spip et ça ne fonctionne plus ; j’ai droit à cinq erreur sql : « U.url, U.date, O. FROM spip_articles AS O LEFT JOIN spip_urls AS U ON (U.type=’article’ AND U.id_objet=O.id_article) WHERE O.id_article=63 ORDER BY U.date DESC LIMIT 1
    You have an error in your SQL syntax. Check the manual that corresponds to your MySQL server version for the right syntax to use near ’FROM db216715564.spip_articles AS O LEFT JOIN db216715564.s »

    • Oui, j’ai constaté que ça ne fonctionnait plus...

      Par contre, je n’ai pas d’erreur SQL... Et je ne vois pas bien d’où elles peuvent venir !

      Pour que le plugin passe à la V2 de Spip, je crois qu’il va falloir remanier son code. Le code utilisé par le plugin, réalisé par Mortimer il y a longtemps est prévu pour fonctionner avec des vieux Spip : il utilise des mécanismes d’intégration un peu anciens, qui n’ont plus court avec la V2, je le crains. Pour les spécialistes, je précise qu’il va falloir migrer ce qui est dans mes_options dans des pipelines...

      C’est à la limite de ce que je sais faire, donc l’adaptation va prendre un peu de temps, car il faut que je me documente un peu...

      Je suis désolé pour cette déconvenue, je vais faire de mon mieux d’autant que je pense que ce travail initié par Mortimer sur les intertitres est vraiment fondamental pour Spip !

      (NB : si d’ici là des Spipeurs habiles qui manient les pipelines sans y penser peuvent jeter un œil à tout ça tant mieux, le plugin est en libre développement sur la zone !)

    • Ça y est, la dernière version du plugin (0.5 du 24 janvier 2009) fonctionne avec Spip 2 grâce au passage aux pipelines.

      Il y ’a aussi quelques autres améliorations dans cette version.

    • j’active le plugin nouveau, et je me rend à la page http://monsite/ecrire/?exec=accueil, et là :

      Fatal error : Call to undefined function IntertitresTdm_table_des_matieres() in /chemin/de/mon/htdocs/plugins/intertitres_hierarchises/intertitres_tdm_fonctions_typo.php on line 18

      je crois que c’est lié à la présence, dans plugin.xml, de l’ante-penultième ligne :

      <fonctions>intertitres_tdm_fonctions.php</fonctions>

      pour ma part, je vire cette cette ligne et met toutes les fonctions dans intertitres_tdm_fonctions_typo.php sans être certain

    • Je n’ai pas ce bug...

      Je vais faire des tests plus poussés ce WE. Toutefois, la solution que tu préconises ne me parait pas bonne (elle risque de produire plus de bugs qu’elle n’en répare) !

      Essaies dans plugin.xml de mettre la ligne :

      <fonctions>intertitres_tdm_fonctions.php</fonctions>

      avant :

      <!-- Definitions des fonctions qui s'inserent dans les pipelines -->

      Et dis moi si ça fonctionne mieux comme ça.

    • je viens de tester, en ayant soin de désactiver le plugin et vider le cache depuis l’espace privé, puis de supprimer de mon disque la version modifiée et de la retélécharger, enfin de la déziper et faire la modification et rebalancer le tout par ftp; puis en retournant dans l’espace privé et en l’activant, même erreur... (idem pour la page /ecrire/?exec=forum —en fait toutes les pages où on calcule et affiche du contenu...— ; mais la liste des rédacteurs ou la gestion des plugins par exemple sont saufs)

      je ne sais pas comment SPIP « parse » ce fichier xml, mais je ne pense pas que l’ordre des éléments de même niveau ait de l’importance. maintenant, en regardant un peu la documentation du fichier, je lis :

          <!-- précise le fichier à charger à chaque recalcul, partie publique -->
          <fonctions>chemin du fichier </fonctions>

      est-ce à dire que ce n’est pris en compte que dans la partie publique ? or l’une des fonctions de ce fichier est utilisée par une des surcharges (pipeline) et doit donc être déclarée au préalable (d’où ma solution en attendant)

    Répondre à ce message

  • pour l’intégration à BTv2, je crois qu’il faut regarder ce que fait Enluminures Typographiques... je vais jetter un coup d’oeil dans le week-end. :)

    Répondre à ce message

  • 1

    SUPER ! Quelle réactivité... Je teste ça dans l’après-midi. Merci encore.

    A bientôt,

    G.

    Répondre à ce message

  • 2

    Merci pour ta réponse rapide.

    Bon, comme tu m’as fais douter, je viens de retester mon histoire de table des matières de l’article X affichée dans l’article Y, X et Y sont publiés. Je confirme que les liens de la table des matières de X affichés dans Y pointent vers Y et non pas vers X...

    J’ai cette version du plugin :

    Version : 0.3 | en développement

    récupérée à http://files.spip.org/spip-zone/intertitres_hierarchises.zip.

    J’ai aussi les plugins enluminures typographiques et barre typo V2, squelettes sarkaspip et thickbox... Peut-être une incompatibilité ??

    • Oups ! tu as raison, c’est moi qui n’avait pas compris : la tdm s’affiche bien, mais ce sont les liens qui ne pointent pas au bon endroit...

      Je vois la source du bug. D’ici quelques jours je vais corriger ça, dans la foulée je ferais quelques vérifications pour valider le plugin pour Spip 2.0.

      Encore un peu de patience...

      Merci beaucoup pour le retour !

    • Bon allez hop, c’était plutôt simple à corriger et j’avais 10min devant moi : c’est corrigé dans la version 0.4 du 19/12/08.

      On verra plus tard pour Spip 2.0 (mais je pense que comme la plupart du code n’est pas de moi : ça devrait fonctionner...)

    Répondre à ce message

  • 1

    Merci pour ce plugin qui répond à un besoin fondamental non couvert par le core SPIP.
    Mon problème : si je veux la table des matières de l’article 122 dans le 245, ça fonctionne avec <table_des_matieres122>, mais les liens dans la table des matières affichée ne renvoient pas vers l’article 122, mais vers le 245 et du coup il ne se passe rien au clic... C’est dommage, non ?...
    En tous les cas, bravo pour votre superbe travail.

    • Ah tiens ? Je ne reproduis pas ton bug...

      Dans ton article 245, c’est bien <table_des_matieres122> que tu as mis ??

      Si oui, les deux articles sont-ils publiés (surtout le 122) ?

    Répondre à ce message

  • 3

    Bonjour et merci pour ce plugin,

    J’ai un souci parce que vous fixez en dur le niveau des intertitres en partant de h3 ; or sur mon site ils partent de h2.

    Comme je ne dois pas être le seul dans ce cas je vous fais la remontée pour contribuer comme je peux... ;)

    Je suppose qu’il doit être possible de repartir de mes_fonctions et de parser ces réglages :

    • $GLOBALS['debut_intertitre'] = "\n<h2>";
    • $GLOBALS['fin_intertitre'] = "</h2>\n";

    afin de récupérer le nombre.

    Ensuite il suffira de retourner ce nombre dans tous les calculs de type :

    • $lastlevel+2
    • $my_debut_intertitre=trim("\n<h([3-9]) class=\"spip\">");
    • $my_fin_intertitre=trim("</h[3-9]>\n");
    • etc.

    Voilà, en tout cas merci pour l’idée.

    • Effectivement, le h3 avait été choisi car c’est la config par défaut de Spip.

      Ton idée est bonne ! Mais je ne vais pas avoir le temps de le faire avant longtemps (trop trop de choses à faire en retard).

      Par contre, ce plugin étant développé sur la zone, tu peux peut-être commiter les changements toi-même ?

    • Je risque de tout casser, non ?

    • Je pense que le mieux est d’essayer ne pas tout casser.

      Mais, récupérer la globale concernant le niveau d’intertitre me paraît une excellente idée !

      Donc, si les modifs fonctionnent chez toi, elles ont des chances de fonctionner partout. Et on essaiera !

      Et si ça marche pas, SVN permet toujours de revenir en arrière (revert).

      Donc comme diraient les dév de Spip et des principaux plugins : « gogogo » !

    Répondre à ce message

  • 5

    Bonjour,
    Je viens d’installer ce plugin qui répond exactement à mes besoins.
    Malheureusement, lorsque dans un article (par exemple le 90) j’ajoute la balise
    <table_des_matieres90>, la table est correctement générée mais toutes les images insérées dans l’article (que ce soit avec <emb> ou <doc> ou <img>) disparaissent !
    J’avoue que je ne comprends pas pourquoi ?
    Une idée ?
    Avez-vous le même problème ?

    • Je confirme. J’ai le même comportement sur mes sites, ce qui m’a amené à ne plus utiliser cette balise. C’est dommage.

    • Alors... pas de solution ? Snif !

    • J’ai constaté le bug...

      Je n’ai pas encore trouvé de solution simple... Mais je vais y travailler (petit problème de débordement en ce moment...) Je vous tiens au courant.

    • Toujours pas de solution ?
      C’est dommage !

    • Ce problème avec les modèles est corrigé dans la dernières version du plugin (celle du 21/09/08).

      Pouvez-vous tester et me dire si tout va bien ?

    Répondre à ce message

  • Olivier CARETTE

    Bonjour,
    Ce type de plugin me semble bien mais j’ai une surcharge de mes pages espace privé avec du code que je ne comprend pas.
    Peut -être y-a-t-il une incompatibilité avec un autre plugin ?
    Voici une partie du texte visible :

    o� x>3 * * - encore une modif, tr�s moche : pour permettre de n’afficher que la table, * quand on utilise ceci comme un filtre avec unn second param�tre : * [(#TEXTE|table_des_matierestable_seule)] * - ajout d’une fonction qui converti les intertitres des enluminures en * intertitres compatibles avec cette contrib’ */ function IntertitresTdm_table_des_matieres($texte,$tableseule=false) global $debut_intertitre, $fin_intertitre ; // d�finition de la balise pour les titres des sections %num% sera remplac� // par la profondeur de la section // les raccourcis soient remplac�s par des headlines () $css_debut_intertitre = « \n » ; $css_fin_intertitre = « \n » ; // on cherche les noms de section commen�ant par des * et # $my_debut_intertitre=trim($debut_intertitre) ; //astuce des trim trouv�e l� : http://www.spip-contrib.net/Generation-automatique-de#forum383092 $my_fin_intertitre=trim($fin_intertitre) ; // pour que les diff�rents niveaux d’intertitres soient g�r�s quand on repasse sur le texte dans le cadre d’un filtre avec tableseule if ($tableseule) $my_debut_intertitre=trim(« \n ») ; $my_fin_intertitre=trim(« \n ») ; // on cherche les noms de section commen�ant par des * et # $count = preg_match_all( « (($my_debut_intertitre([\*#]*)(.* ?)(<(.* ?)>) ?$my_fin_intertitre)) », $texte, $matches ) ; $table = ’’ ; //initialisation du compteur $cnt[0] = 0 ; // initialisation du code de la table des mati�res // s’articule autour d’un et d’un

    $table = "\n

    Mes autre plugins sont :
    Accès restreint
    Agenda
    Article PDF
    Barre typo generalisée
    Barre typo V2
    Barre typo dans le texte
    CFG
    CS
    Crayon
    Definitions mots clés
    En travaux
    Forms and tabs
    Google analytics
    Google sitemaps
    Imprimer document
    Inscription 2
    Notation des articles
    Boite à outils pour articles
    Spip listes
    Spip notification
    Spip surcharge
    Widget Calendrier

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

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

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom