Découper un article en plusieurs pages et lui ajouter un sommaire

Ceci est une archive périmée mais qui reste intéressante, parfois autant pour l’article que les commentaires associés.

Ce filtre est une mise à jour des filtres de noplay « Sommaire de l’article » et de « gpl » "Découper un article en plusieurs pages".

Ce script contient deux filtres :

  • Un filtre pour afficher le sommaire
  • Un filtre pour découper l’article

Pour installer ces filtres, il faut ajouter ces deux fonctions dans le fichier mes_fonctions.php3.

Afficher le sommaire

/*
 *   +----------------------------------+
 *    Nom du Filtre : Sommaire de l'article                                               
 *   +----------------------------------+
 *    Date : Vendredi 6 juin 2003
 *    Auteur :  Noplay (noplay@altern.org) 
 *              Aurélien PIERARD : aurelien.pierard@sig.premier-ministre.gouv.fr                                     
 *   +-------------------------------------+
 *    Fonctions de ce filtre :
 *      Cette modification permet d'afficher le sommaire de l'article 
 *      généré dynamiquement à partir du texte de l'article. Vous pouvez naviguer 
 *      dans l'article en cliquant sur les titres du sommaires. 
 *
 *      Tous ce qui ce trouve entre {{{ et }}} est considéré comme un titre à ajouter au sommaire de l'article.
 *   +-------------------------------------+ 
 *  
 * Pour toute suggestion, remarque, proposition d'ajout
 * reportez-vous au forum de l'article :
 * http://www.uzine.net/spip_contrib/article.php3?id_article=76
*/
//SOMMAIRE
function sommaire_article($texte)
{
		$artsuite = 0;
        $page = split('-----', $texte);
        $uri_art = generer_url_article($GLOBALS['id_article']);
        $uri_art .= strpos($uri_art, '?') ? '&' : '?';

	$i=0;
	$texte="";
	while($page[$i]){
		// On ajoute une ancre aux intertitres "{{{ }}}" que l'on utilise pour créer le sommaire
		preg_match_all("|\{\{\{(.*)\}\}\}|U",$page[$i], $regs);
	 	$nb=1;
		for($j=0;$j<count($regs[1]);$j++){
			$p=$i+1;
	    	$texte=$texte."<a href=\"". $uri_art . "artsuite=" .$i. "#sommaire_".$nb."\" title=\"".$regs[1][$j]."\">".$regs[1][$j]."</a>, p$p<br />";
			$nb++;
	    }
		$i++;
	}
		return $texte;
}
// Fin du filtre sommaire

Découper l’article

/*
 *   +----------------------------------+
 *    Nom du Filtre : decouper_en_page                                               
 *   +----------------------------------+
 *    Date : Vendredi 6 juin 2003
 *    Auteur :  "gpl"  : gpl@macplus.org  
 *              Aurélien PIERARD : aurelien.pierard@sig.premier-ministre.gouv.fr
 *   +-------------------------------------+
 *    Fonctions de ce filtre :
 *		Il sert a présenter un article sur plusieurs pages  
 *   +-------------------------------------+ 
 *  
 * Pour toute suggestion, remarque, proposition d'ajout
 * reportez-vous au forum de l'article :
 * http://www.uzine.net/spip_contrib/article.php3?id_article=62
*/


function decouper_en_page($texte) {
        global $artsuite, $var_recherche, $num_pages;
		
        if (empty($artsuite)) $artsuite = 0;
	
		// on divise la page (séparateur : "-----")        
        $page = split('-----', $texte);
        // Nombre total de pages
        $num_pages = count($page);

        // Si une seule page ou numéro illégal, alors retourner tout le texte.
        // Cas spécial : si var_recherche positionné, tout renvoyer pour permettre à la surbrillance de fonctionner correctement.
        if ($num_pages == 1 || !empty($var_recherche) || $artsuite < 0 || $artsuite > $num_pages) {
			// On place les ancres sur les intertitres
			$texte = preg_replace("|\{\{\{(.*)\}\}\}|U","<a name=\"sommaire_#NB_TITRE_DE_MON_ARTICLE#\">$0</a>", $texte);
			$array = explode("#NB_TITRE_DE_MON_ARTICLE#" , $texte);
			$res =count($array);
			$i =1;
			$texte=$array[0];
			while($i<$res){
				$texte=$texte.$i.$array[$i];
				$i++;
			}
			return $texte;
        } 

        $p_prec = $artsuite - 1;
        $p_suiv = $artsuite + 1;
        $uri_art = generer_url_article($GLOBALS['id_article']);
        $uri_art .= strpos($uri_art, '?') ? '&' : '?';

		// On place les ancres sur les intertitres
		$page[$artsuite] = preg_replace("|\{\{\{(.*)\}\}\}|U","<a name=\"sommaire_#NB_TITRE_DE_MON_ARTICLE#\">$0</a>", $page[$artsuite]);
		$array = explode("#NB_TITRE_DE_MON_ARTICLE#" , $page[$artsuite]);
		$res =count($array);
		$i =1;
		$page[$artsuite]=$array[0];
		while($i<$res){
			$page[$artsuite]=$page[$artsuite].$i.$array[$i];
			$i++;
		}
		// Pagination
	    switch (TRUE) {
			case ($artsuite == 0):
				$precedent = "";
				$suivant = "<a href='" . $uri_art . "artsuite=" . $p_suiv . "'>&gt;&gt;</a>";
				break;
			case ($artsuite == ($num_pages-1)):
				$precedent = "<a href='" . $uri_art . "artsuite=" . $p_prec . "'>&lt;&lt;</a>";
				$suivant = "";
				break;
			default:
				$precedent = "<a href='" . $uri_art . "artsuite=" . $p_prec . "'>&lt;&lt;</a>";
				$suivant = "<a href='" . $uri_art . "artsuite=" . $p_suiv . "'>&gt;&gt;</a>";
				break;
        }
    
        for ($i = 0; $i < $num_pages; $i++) {
			$j = $i;
			if ($i == $artsuite) {
				$milieu .= " <strong>" . ++$j . "</strong> ";
            } 
			else {
				$milieu .= " <a href='" . $uri_art . "artsuite=$i'>" . ++$j . "</a> ";
			}
        }

        // Ici, on peut personnaliser la présentation
        $resultat .= $page[$artsuite];
        $resultat .= "<p class='pagination'><div class='pagination' align='center'>pages : $precedent $milieu $suivant</div></p>";
        return $resultat;
}
// FIN du Filtre decouper_en_page

Utilisation :

-  [(#TEXTE*|sommaire_article|propre)] pour afficher le sommaire de l’article

-  [(#TEXTE*|decouper_en_page|propre|justifier)] pour afficher l’article.

Notez bien l’astérisque après #TEXTE ! Cette astérisque permet de désactiver les traitements par défaut de Spip sur le champ #TEXTE : c’est nécessaire ici parce que je veux traiter cinq traits d’union consécutifs qui sont transformés en <hr> normalement.

-  Rédigez vos articles en utilisant cinq traits d’union consécutifs à l’endroit qui doit recevoir la coupure.

-  Tous ce qui se trouve entre {{{ et }}} est considéré comme un titre à ajouter au sommaire de l’article.

À noter
Pour obtenir une ligne horizontale, la documentation de Spip stipule qu’une succession de quatre traits d’union ou plus est nécessaire. Avec ce filtre, c’est différent : quatre traits d’union provoque une ligne horizontale, cinq provoquent un saut de page. J’ai choisi ceci pour permettre d’avoir, dans l’hypothèse d’un autre squelette avec #TEXTE et non #TEXTE*, une ligne horizontale qui signale le découpage en pages.

Remarques :

Pour intégrer quelques choses uniquement à la dernière page (par exemple le forum de l’article ou le PS) tapez dans votre squellette :

<?
  if ($artsuite==$num_pages-1){ ?>
     #FORMULAIRE_FORUM
  <? } ?>

-  Attention : ce filtre utilise la fonction preg_match_all qui necessite une version de PHP3 superieure a PHP 3.0.9
-  #NOTES fonctionne avec ce filtre. (La numérotation recommence à chaque nouvelle page)

Discussion

27 discussions

  • 1

    Bonjour,

    D’abord bravo et merci pour ce script !

    Chez moi, il ne fonctionne que si je met la valeur « $delais = 0 » dans article-normal.php3 :-o(squelettes EVA).

    Avez-vous une idée... ?

    Merci d’avance.

    Helveto

    • Hello,
      J’ai rencontré le meme problème avec les squelettes EVA.
      Par contre j’ai un autre site avec un squelette perso et il n’y a pas de problèmes.
      Le problème vient vraiment du squelette EVA mais ou est-il ? je ne sais pas !

      Si quelqu’un trouve, merci !

    Répondre à ce message

  • Bonjour à tous,

    Je viens de découvrir un bug :
    si on inclut un lien dans un sous-titre de l’article, l’affichage de ce titre dans le sommaire bug.

    J’ai corrigé ce bug en ajoutant simplement un appel à htmlentities dans la construction du sommaire dans la fonction « sommaire_article » :

    //$texte=$texte.« <a href= »". $uri_art . « artsuite= »
    .$i. « #sommaire_ ».$nb.«  »
    title=\« ».$regs[1][$j].«  »>« .$regs[1][$j]. »</a>,
    p$p<br />" ;

    $texte=$texte.« <a href= »". $uri_art . « artsuite= »
    .$i. « #sommaire_ ».$nb.«  »
    title=\« ».htmlentities($regs[1][$j]).«  »>« .$regs[1][$j]. »</a>,
    p$p<br />" ;

    Merci aux créateurs de ce plugin qui nous est très utile ! (voir par curiosité : http://www.urd.org/newsletter/ )

    Olivier.

    Répondre à ce message

  • 1

    Bonjour,

    existe t il une version de ce filtre compatible avec spip 1.9 car ca ne marche plus au niveau des pages ? par contre aucun problème pour le sommaire

    merci

    • pb de mise en page dans la version 1.9.1 découpage en 1 page
      Mise en italique du menu (qui lui est diminué)
      je cherche a modifie le script mais actuellement sans résultat

    Répondre à ce message

  • pour que ca marche sur ma 1.8.2

    j’ai du faire un appel dans mon squelette comme ceci :

     [(#TEXTE|decouper_en_pages{#ID_ARTICLE}]

    Ensuiote j’ai du injecter dans la focntion l’id_Article :

    function decouper_en_pages($texte,$id_article) {

    Ensuite changer la definition de la variable uri_art :

            $uri_art = generer_url_article($id_article);

    apres ca tout marche nickel :)

    exemple :
    http://www.topspeed.com/car_news/audi_a8_overview-ar5845.html

    Répondre à ce message

  • 5

    J’utilise ce filtre un peu modifié pour la mise en page avec spip 1.8.2-d (standart).
    Un exemple du rendu est visible sur http://www.gigean-village.com/article2.html).

    Je rencontre cependant un problème de taille, je suis obligé de désactiver le système de cache des articles en affectant le délais de rafraichissement à 0.
    Cela n’est pas viable sur un site important.

    J’ai cherché partout où le bas blessait sans rien trouver.
    Une piste serait la bienvenue...

    • Après mult galéres et un echauffement du bulbe intempestif, je crois avoir trouvé la solution.
      Alors accrochez vous !
      Cela vient du système de cache de spip.
      Si j’ai tout bien compris, spip ne cache qu’une page pour une url du type quelque-chose.php3 ?parametre1=x&parametre2=y.
      En fait, il prend le premier paramètre (dans le cas de ce filtre, article.php3 ?id_article=x), et n’interprete pas les suivants (dans le cas de ce filtre, la transmission des pages suivantes|precedentes de la forme artsuite=x).
      Pour le forcer a prendre en compte ces variables et generer une page de cache pour chaque page découpée de l’article, il faut forcer spip a prendre en compte ces variables.
      Admettons que le squelette de la page contenant l’article découpé s’appelle inc-article.html et qu’il est appelé dans le squelette article.html par la commande .
      Il faut modifier ce fichier inc-article.php3 pour que spip prenne en compte la variable $artsuite. Pour cela on ajoute sous la ligne
      $delais = 2 * 3600 ;
      et avant la ligne
      include (inc-public.php3) ;
      la ligne magique :
      $contexte_inclus[artsuite’]=$_GET[artsuite’] ;
      Et voilà le travail !
      Faites moi savoir si vous rencontrez des erreurs avec cette méthode.

    • Manifestement toutes les quotes ne sont pas apparues, donc je réecris la ligne :
      $contexte_inclus[’artsuite’]=$_GET[’artsuite’] ;
      et voili...

    • Un énooorme merci à Erick B., je n’aurais peut-être jamais résolu ce problème sans ton aide !

      Franchement, il fallait chercher loin, et je suis étonné que personne n’ait réellement soulevé ce problème auparavant (j’ai « retourné » le web pour m’en assurer). En tout cas, j’espère que ça en aidera plus d’un à utiliser correctement ce filtre de découpage... indispensable à tout site de publication.

    • Bonjour,

      Le problème de raffraichissement de la page est toujour présent sur spip 1.8.2e malgré les mises à jour faites.

      Roger

    • Pareil pour moi, malgré la modif, je suis obligé de recalculer les pages ou de me priver du cache, j’utilise un systéme à la EVA, de squelettes inclus par mots clés, + un truc étonnant, dans certains articles utilisant le filtre, j’ai des changement de police intempestif, alors que j’ai un span class avant mon #TEXTE...

      dommage, c’est un super filtre

    Répondre à ce message

  • 1

    Bonjour,

    je rencontre un petit pb : en utilisant ce filtre (au demeurant très pratique et fort bien fait), les documents qui sont inclus dans le corp du texte réaparaissent une seconde fois comme documents joints... et ça m’ennuie un peu :-)

    ex : http://www.issyescalade.info/article.php?id_article=24&artsuite=0#sommaire_3

    y’a-t-il un moyen de contrer ce pb ?

    Merci d’avance,

    Matthieu

    • bon, bin j’ai pas trouvé de solution, alors je me passerais de cette contrib... Tant pis, ça avait l’air bien ! snif

      Matthieu

    Répondre à ce message

  • Ce filtre est-il compatible avec la version spip 1.8.2d ?

    Répondre à ce message

  • 7

    une petite URL, pour voir un exemple ?

    • Ici : http://www.trainduvivarais.org/article.php3?id_article=53
      par exemple...

      J’ai adopté de filtre qui me donne entière satisfaction à ce jour !

      JC

    • Merci pour l’url, mais je ne vois pas bien ou se situe ton sommaire

    • bonjour à tous, j’ai le meme problème, je n’arrive pas à écrire la commande dans le fichier .htaccess pour rediriger correctement ce qui fait que l’on rivent toujours sur la première page du sommaire.
      Quelqu’un a t il une idée ?
      Merci à tous les géniaux inventeurs qui travaillent ici.
      ALexis

    • maintenant cela marche du tonère... y ’a qu’a voir...
      http://www.bealiban.com/article7.html
      j’ai été obligé de modifier le code dans mes_fonctions.php pour coder autrement les url, pour ceux qui veulent avoir le code écrivez moi.

    • Et pourquoi ne pas proposer ta modification directement sur Spip-Contrib ;)

    • J’aimerais bien savoir moi aussi comment tu as fait, j’ai le même problème que indiqué plus haut, je n’ai que la première page qui est traitée pour récupérer les titres à intégrer dans le sommaire, pourrais-tu partager avec nous ton savoir-faire ?

    • Avec retard...!! voici donc le code qui permet d’utiliser l’url rewriteing et la contrib.
      En fait il faut réécrire la ligne qui fabrique le lien qui envoie vers les pages de la table des matières. Il faut aussi écrire une ligne dans le htaccess.

      Voilà le fitre...

      function decouper_en_page($texte) {
              global $artsuite, $var_recherche, $num_pages;
      		
              if (empty($artsuite)) $artsuite = 0;
      	
      		// on divise la page (séparateur : "-----")        
              $page = split('-----', $texte);
              // Nombre total de pages
              $num_pages = count($page);
      
              // Si une seule page ou numéro illégal, alors retourner tout le texte.
              // Cas spécial : si var_recherche positionné, tout renvoyer pour permettre à la surbrillance de fonctionner correctement.
              if ($num_pages == 1 || !empty($var_recherche) || $artsuite < 0 || $artsuite > $num_pages) {
      			// On place les ancres sur les intertitres
      			$texte = preg_replace("|\{\{\{(.*)\}\}\}|U","<a name=\"sommaire_#NB_TITRE_DE_MON_ARTICLE#\">$0</a>", $texte);
      			$array = explode("#NB_TITRE_DE_MON_ARTICLE#" , $texte);
      			$res =count($array);
      			$i =1;
      			$texte=$array[0];
      			while($i<$res){
      				$texte=$texte.$i.$array[$i];
      				$i++;
      			}
      			return $texte;
              } 
      
              $p_prec = $artsuite - 1;
              $p_suiv = $artsuite + 1;
      		$var=($GLOBALS['id_article']);
             // $uri_art = generer_url_article($GLOBALS['id_article']);
             // $uri_art .= strpos($uri_art, '?') ? '&' : '?';
      		$uri_art = 'articles'.$var;
      
      		// On place les ancres sur les intertitres
      		$page[$artsuite] = preg_replace("|\{\{\{(.*)\}\}\}|U","<a name=\"sommaire_#NB_TITRE_DE_MON_ARTICLE#\">$0</a>", $page[$artsuite]);
      		$array = explode("#NB_TITRE_DE_MON_ARTICLE#" , $page[$artsuite]);
      		$res =count($array);
      		$i =1;
      		$page[$artsuite]=$array[0];
      		while($i<$res){
      			$page[$artsuite]=$page[$artsuite].$i.$array[$i];
      			$i++;
      		}
      		// Pagination
      	    switch (TRUE) {
      			case ($artsuite == 0):
      				$precedent = "";
      				$suivant = "<a href='" . $uri_art . "-" . $p_suiv . ".html   '>&gt;&gt;</a>";
      				break;
      			case ($artsuite == ($num_pages-1)):
      				$precedent = "<a href='" . $uri_art . "-" . $p_prec . ".html  '>&lt;&lt;</a>";
      				$suivant = "";
      				break;
      			default:
      				$precedent = "<a href='" . $uri_art . "-" . $p_prec . ".html '>&lt;&lt;</a>";
      				$suivant = "<a href='" . $uri_art . "-" . $p_suiv . ".html '>&gt;&gt;</a>";
      				break;
              }
          
              for ($i = 0; $i < $num_pages; $i++) {
      			$j = $i;
      			if ($i == $artsuite) {
      				$milieu .= " <strong>" . ++$j . "</strong> ";
                  } 
      			else {
      
      				//$milieu .= " <a href='" . $uri_art . "artsuite=$i'>" . ++$j . "</a> ";
      				$milieu .= " <a href='" . $uri_art ."-". $i.".html'>" . ++$j . "</a> ";				
      
      			}
              }
      
              // Ici, on peut personnaliser la présentation
              $resultat .= $page[$artsuite];
      		
              $resultat .= "<p class='tm'><center>Pages : $precedent $milieu $suivant</center></p>";
              return $resultat;
      }
      // FIN du Filtre decouper_en_page

      Et mon fichier htaccess

      RewriteRule ^rubrique([0-9]+).html$   /rubrique.php3?id_rubrique=$1 
      RewriteRule ^article([0-9]+).html$    /article.php3?id_article=$1 
      RewriteRule ^breve([0-9]+).html$     /breve.php3?id_breve=$1 
      RewriteRule ^secteur([0-9]+).html$    /secteur.php3?id_rubrique=$1 
      RewriteRule ^articles([0-9]+)-([0-9]+).html$   /article.php3?id_article=$1&artsuite=$2
      RewriteRule ^articles([0-9]+)-([0-9]+)-([0-9]+).html$   /article.php3?id_article=$1&artsuite=$2#sommaire_$3

      Simple non.

    Répondre à ce message

  • 1

    Salut

    Est-ce qu’il y a moyen de n’afficher le sommaire que sur la première page ?

    Merci.

    • peut être une piste, tu testes si tu te trouves bien sur la première page avec :

      <?
       if ($artsuite==0){ ?>
          #FORMULAIRE_FORUM
       <? } ?> 

      À tester...

    Répondre à ce message

  • 2
    davduf

    Bonjour à tous,

    Ce filtre est l’un des plus puissants que j’utilise. Avant tout, merci à ses auteurs.

    Seulement voilà, depuis que j’ai changé de squelette, il fonctionne de manière aléatoire... Je veux dire, parfois, il fait bien les sauts de page ; parfois, non, il renvoie à des pages vierges.

    Bien entendu, il est toujours dans mes squelettes et dans mes.fonctions.php3

    Une idée ?

    Merci d’avance

    • davduf

      Précision... : est ce que ce filtre est compatible avec les « urls propres » (1.8.1) ?

      Merci encore

    • aie, aie, aie... je crains, en effet, qu’ils ne soient pas compatibles. J’ai retiré les « urls propres » et, là, tout a fonctionné. Les articles étaient à nouveau découpés...

      Quelqu’un a t il une idée pour avoir des urls propres tout en faisant fonctionner le script « découpés en page » ?

      Merci

    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