Accueil du site > Rédaction > Archives Rédaction > Filtres Mise en page pour avant SPIP 1.9 > Découper un article en plusieurs pages et lui ajouter un sommaire

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

24 juin 2003 – par Aurélien PIERARD, Noplay – 63

1 vote

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 :

P.-S.

- 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)

Vos commentaires

0 | 10 | 20

# Le 4 décembre 2009 à 17:17, par OSarrat

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 " ;
$texte=$texte."<a href=\"". $uri_art . "artsuite="
.$i. "#sommaire_".$nb."\"
title=\"".htmlentities($regs[1][$j])."\">".$regs[1][$j]."</a>,
p$p " ;

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
# Le 25 novembre 2006 à 15:42, par flo

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
- # ^ Le 15 décembre 2006 à 11:35, par vinniepod
  
  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
# Le 31 mars 2006 à 20:12, par philooo

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/au...

Répondre à ce message
# Le 24 octobre 2005 à 10:54, par Erick B.

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/artic...).

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...
- # ^ Le 30 octobre 2005 à 14:27, par Erick B.
  
  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.
- # ^ Le 30 octobre 2005 à 14:35, par Erick B.
  
  Manifestement toutes les quotes ne sont pas apparues, donc je réecris la ligne :
  $contexte_inclus[’artsuite’]=$_GET[’artsuite’] ;
  et voili...
- # ^ Le 31 octobre 2005 à 19:36, par Ben
  
  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.
- # ^ Le 11 décembre 2005 à 14:22, par Roger (Bordeaux)
  
  Bonjour,
  
  Le problème de raffraichissement de la page est toujour présent sur spip 1.8.2e malgré les mises à jour faites.
  
  Roger
- # ^ Le 12 décembre 2005 à 13:19, par Mat
  
  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
# Le 2 novembre 2005 à 20:02, par matthieu

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
- # ^ Le 25 novembre 2005 à 10:53, par 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
# Le 18 septembre 2005 à 20:58, par Marso

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

Répondre à ce message
# Le 30 juin 2003 à 12:40, par Sylvain

une petite URL, pour voir un exemple ?
- # ^ Le 30 juin 2003 à 14:47, par JC
 
 Ici : http://www.trainduvivarais.org/arti...
 par exemple...
 
 J’ai adopté de filtre qui me donne entière satisfaction à ce jour !
 
 JC
- # ^ Le 10 octobre 2003 à 14:46, par Dody
 
 Merci pour l’url, mais je ne vois pas bien ou se situe ton sommaire
- # ^ Le 20 janvier 2004 à 15:55, par ALexis
 
 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
- # ^ Le 22 février 2004 à 13:40, par 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.
- # ^ Le 22 février 2004 à 19:34, par Noplay
 
 Et pourquoi ne pas proposer ta modification directement sur Spip-Contrib ;)
- # ^ Le 3 juin 2005 à 17:24, par BL
 
 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 ?
- # ^ Le 4 septembre 2005 à 07:10, par ?
 
 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 '>>></a>"; break; case ($artsuite == ($num_pages-1)): $precedent = "<a href='" . $uri_art . "-" . $p_prec . ".html '><<</a>"; $suivant = ""; break; default: $precedent = "<a href='" . $uri_art . "-" . $p_prec . ".html '><<</a>"; $suivant = "<a href='" . $uri_art . "-" . $p_suiv . ".html '>>></a>"; break; } for ($i = 0; $i < $num_pages; $i++) { $j = $i; if ($i == $artsuite) { $milieu .= " " . ++$j . " "; } 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 .= "<center>Pages : $precedent $milieu $suivant</center>"; 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
# Le 10 janvier 2005 à 00:34, par nerveos

Salut

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

Merci.
- # ^ Le 25 juillet 2005 à 08:46, par DoriaN
 
 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
# Le 31 mai 2005 à 13:17, par 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
- # ^ Le 31 mai 2005 à 13:24, par davduf
  
  Précision... : est ce que ce filtre est compatible avec les "urls propres" (1.8.1) ?
  
  Merci encore
- # ^ Le 2 juin 2005 à 23:35, par davduf
  
  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
# Le 7 janvier 2005 à 13:28, par rachouan

Salut
le filtre est impecable...sauf que j’est 2 problème...
1) je ne sais pas si c’est a cause de lui, mais lorsque je valide mon text pour l’entrer, il ne reconnait pas les sauts de lignes ; il faut que je fait 2 sauts de ligne pour le reconnaitre
2) le sommaire marche trés bien... sauf que les titre du sommaire dans le texte agissent bizarement lors d’un survol de la sourie
merci pour tout

Répondre à ce message