SPIP - Contrib

[ar] [en] [es] [fr] [it]



Accueil du site > Documentation > Archives documentation > Carnet Chantiers Contribs - archives avant 2007

NumerotationEtc

mercredi 26 janvier 2005. Dernier ajout mercredi 7 mars 2007



Voilà, on va essayer de passer cette contrib : Génération automatique de numerotation, table des matières et références

en un plugin qui est bien plus simple à installer.
On n’a plus qu’a la déposer dans le répertoire plugins et le tour est joué.

Tout ce qu’il y a à faire, c’est créer un fichier plug_table_matiere.php3 dans le répertoire ecrire/plugins et d’y insérer ce code :

Note Yves : il semble qu’il y ai un problème avec le WiKi qui n’intègre pas bien le code php. Il faut passer en mode édition et là c’est le bon code.

<?php


function table_des_matieres($texte) {
 global $debut_intertitre, $fin_intertitre;

 $css_debut_intertitre = "\n<h3 class=\"spiphead%num%\">";
 $css_fin_intertitre = "</h3>\n";
 
 $count = preg_match_all("(($debut_intertitre(\\*+)([^<]*)(<([^>]*)>)?$fin_intertitre))",$texte,$matches);
 $table = '';
 $cnt[0] = 0;
 $table = "<p class='spip'><A name='table'/><ul id='tablematiere'>\n";
 $lastlevel = 1;
 $cite['table'] = 'table';
 for ($j=0; $j< $count; $j++) {
        $level = $matches[2][$j];
        $titre = $matches[3][$j];
        $ref = $matches[5][$j];
        if(strlen($level) == 1) {
          for ($i=1; $i < count($cnt); $i++) {
                $cnt[$i] = 0;
          }
          $numeros = ++$cnt[0];
          $titre = $numeros.' '.$titre;
        } else {
          $numeros = $cnt[0].'.';
          for ($i=1; $i < strlen($level)-1; $i++) {
                $numeros .= $cnt[$i].".";
          }
          $numeros = $numeros.(++$cnt[$i]);
          $titre = $numeros.' '.$titre;
        }
        if($lastlevel < strlen($level)) {
          $table .= "<ul>\n";
        }
        if($lastlevel > strlen($level)) {
          for ($i=0; $i < ($lastlevel - strlen($level)); $i++) {
                $table .= "</li>\n</ul>";               
          }
        }
        if($lastlevel >= strlen($level)) {
          if($cnt[0] > 1 || strlen($level) > 1) {
                $table .= "</li>\n";
          }
        }
        $cite[$ref] = $numeros;
        $table .= "<li><A href='#$numeros'>$titre</A>";
        $lastlevel = strlen($level);
        $mdebut_intertitre = str_replace('%num%',$lastlevel,$css_debut_intertitre);
        $mfin_intertitre = str_replace('%num%',$lastlevel,$css_fin_intertitre);
        $texte = str_replace($matches[0][$j],"$mdebut_intertitre<A name='$numeros'>$titre</A>$mfin_intertitre",$texte);
 }
 for ($i=0; $i < $lastlevel; $i++) {
        $table .= "</li>\n</ul>";               
 }
 foreach ($cite as $ref => $num) {
        $texte = str_replace("<$ref>","<A href='#$num'>$num</A>",$texte);       
 }
 $texte = str_replace('#TABLEMATIERES',$table,$texte);
 return $texte;
}

completer_fonction("propre", "", "table_des_matieres");

?>

Rien de bien compliqué en soit. Voici quand même quelques explications :
— la fonction table_des_matieres est décrite dans la contrib originale. Elle va compléter le jeux de raccourcis et remplacer les nouvelles balises par le code HTML qu’il faut.
— il faut que cette fonction soit exécutée après que SPIP ait traité ses propres raccourcis, mais avant le traitement de la typographie (comme on va ajouter du nouveau texte). Ainsi, on l’ajoute après la fonction propre. Pour que SPIP le sache, on appel la fonction :completer_fonction("propre", "", "table_des_matieres");

  • Le premier paramètre dit à SPIP de compléter la fonction propre,
  • Le 2e est la fonction qu’il faudra appeler avant propre,
  • le dernier est celui qui nous intéresse : la fonction a appeler après propre.

Répondre à cet article



Suivre la vie du site RSS 2.0 | Plan du site | Espace privé | Charte et vie SPIP-Contrib | SPIP | L'autre.net