Découper un article en plusieurs pages

Published : 26 January 2003 – updated on 21 December 2021 – by gpl – 93 commentaires

1
2
3
4
5
3 Votes
Un filtre pour découper l’affichage public d’un article en plusieurs pages.
Pour SPIP 1.7, voir Découper un article en plusieurs pages et lui ajouter un sommaire.
Pour les versions plus récentes de SPIP, voir Découper un texte en pages et/ou en onglets et En onglets dans le texte de SPIP, ou ailleurs....

Marche à suivre

1. Ajouter la fonction qui suit dans mes_fonctions.php3 :

/*
 *   +----------------------------------+
 *    Nom du Filtre : decouper_en_page                                               
 *   +----------------------------------+
 *    Date : mardi 28 janvier 2003
 *    Auteur :  "gpl"  : gpl@macplus.org                                      
 *   +-------------------------------------+
 *    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;
        
        if (empty($artsuite)) $artsuite = 0;
        
        $page = split('-----', $texte);
        
        $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) {
                return $texte;
        } 

        $p_prec = $artsuite - 1;
        $p_suiv = $artsuite + 1;
        $uri_art = generer_url_article($GLOBALS['id_article']);
        $uri_art .= strpos($uri_art, '?') ? '&' : '?';
        
        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 .= " <B>" . ++$j . "</B> ";
                } else {
                        $milieu .= " <A HREF='" . $uri_art . "artsuite=$i'>" . ++$j . "</A> ";
                }
        }

        // Ici, on peut personnaliser la présentation
        $resultat = "<P><DIV CLASS='pagination'>$precedent $milieu $suivant</DIV></P>";
        $resultat .= $page[$artsuite];
        $resultat .= "<P CLASS='pagination'><DIV CLASS='pagination'>$precedent $milieu $suivant</DIV></P>";
        return $resultat;
}
// FIN du Filtre decouper_en_page

2. Remplacer le [(#TEXTE)] présent dans article.html (ou dans votre propre squelette, bien sûr) par:

[(#TEXTE*|decouper_en_page|propre)]

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.

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

À 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.

Un exemple?

Voyez http://alor.univ-montp3.fr/c.renais... pour un exemple sur un site existant.

Discussion

5 years 1 year 3 months Without limit
par date
Filter

49 discussions

  • francoisd

    Bonjour,

    J’avais cette modif sur une vers 1.9 de spip et j’ai appliqué la modif de votre dernier message suite à la mise à jour en version 2. Cependant, maintenant que spip est passé en version 3, le paramètre $id_article n’est pas transmis à “mes_fonctions/php” et me génère donc des messages d’erreurs.

    Comment corriger ce problème?

    Merci d’avance.

    Reply to this message

  • 1
    bdegoy

    Vin’S a écrit : “Il faut donc passer en paramètre #ID_ARTICLE et #ENVartsuite lors de l’appel de la fonction decouper_en_page() dans le squelette, pour que la fonction php connaisse la valeur de ces deux variables. Après ça miracle, tout roule !”

     

    Pour que cela fonctionne avec SPIP 2.x, il faut :
    -  appeler le filtre sous la forme : decouper_en_page{#ID_ARTICLE}
    -  changer la fonction pour function decouper_en_page($texte, $id_article)
    -  supprimer les globales, et les remplacer par $artsuite = $_GET['artsuite'];
    -  remplacer $uri_art = generer_url_article($GLOBALS['id_article']); par :  $uri_art = generer_url_entite($id_article', "article");

     

    Voilà ce que cela donne :

    function decouper_en_page($texte,  $id_article) {
        //[spip20]global $artsuite, $var_recherche, $num_pages;
        $artsuite = $_GET['artsuite'];  //[spip20]
        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 id=\"sommaire_#NB_TITRE_DE_MON_ARTICLE#\"></a>$0", $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;
        //[spip20]$uri_art = generer_url_article($id_article);
        $uri_art = generer_url_entite($id_article, "article"); //[spip20] 
        $uri_art .= strpos($uri_art, '?') ? '&' : '?';

		// On place les ancres sur les intertitres
		$page[$artsuite] = preg_replace("|\{\{\{(.*)\}\}\}|U","<a id=\"sommaire_#NB_TITRE_DE_MON_ARTICLE#\"></a>$0", $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 .= "<div class='pagination' style='text-align:center'>pages : $precedent $milieu $suivant</div>";
        return $resultat;
}
// FIN du Filtre decouper_en_page

    Il est vrai que j’ai omis de régler le problème du surlignage des mots de la recherche, je réfléchis à cela.

    Bien cordialement à tous.

    • bdegoy

      Je fais suite à mon précédent message dans lequel j’ai oublié de préciser quelquechose. Je dis :“appeler le filtre sous la forme : decouper_en_page#ID_ARTICLE”.

      Il faut donc modifier aussi la fonction sommaire_article :

      //[spip2]function sommaire_article($texte)
function sommaire_article($texte, $id_article)     //[spip2]
{
        $artsuite = 0;
        $page = split('-----', $texte);
        //[spip20]$uri_art = generer_url_article($GLOBALS['id_article']);
        $uri_art = generer_url_entite($id_article, "article"); //[spip2]
        $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."<li><a href=\"". $uri_art . "artsuite=" .$i. "#sommaire_".$nb."\" title=\"".$regs[1][$j]."\">".$regs[1][$j]."</a>,&nbsp;p$p</li>\n";
            $nb++;
        }
        $i++;
    }
        if (empty($texte)) $texte="";
        else $texte="<ul>\n".$texte."</ul>\n";
        return $texte;
}
// Fin du filtre sommaire

    Reply to this message

  • mowa

    Bonjour,
    j ai mis spip 2,0,5 et je n arrive pas a faire marcher le script, comment passer en parametre #Id_ARTICLE et #ENV_artsuite ??
    la fonction decouper_en_page() ne veux pas accepter 2arguments ?
    J’ai essayer pleins de possibilités ?? As tu renommez le .php3 en .php ou laisser comme ca ??

    Merci pour vos furtures reponses.

    Reply to this message

  • Vin’S

    Personnellement j’ai utilisé deux astuces de derrière les fagots pour faire marcher cette contrib’ sous la 2.0.5.
    Comme je ne suis pas un as du .php, j’ai pu identifier d’où venaient les problèmes mais je ne sais pas pourquoi ça marchait dans les vieilles version de Spip et pas dans la nouvelle.
    Les deux soucis viennent des variables globales.
    Je ne sais pas par quelle magie la déclaration “global $artsuite” récupérait le numéro généré dans l’URL, mais ça ne marche plus dans la 2.0.x.
    Idem pour GLOBALS[’id_article’] qui ne marche plus dans les nouvelles versions de Spip.
    Il faut donc passer en paramètre #ID_ARTICLE et #ENVartsuite lors de l’appel de la fonction decouper_en_page() dans le squelette, pour que la fonction php connaisse la valeur de ces deux variables.
    Après ça miracle, tout roule !

    Si certains ont des questions et ont besoin de ce script, je peux répondre ici.

    Reply to this message

  • Spoun

    Bonjour, quelqu’un aurait-il une solution pour faire marcher cette contrib sous spip 2.0.x ?

    Reply to this message

  • maude

    bonjour. g un petit souci,
    en faite je souhaite découper mon site en page; c un long bandeau de 1000px(ou +) de largeur(chaque page est dc l’une a coté de l’autre) et chaque page est une rubrique. on peut naviguer par scrooling, mais je souhaiterai ajouter un menu rapide qui permettrai d’acceder directement a tel ou tel page en un clic.
    je pense que c la même chose que de découper un article en page, sauf que c’est sur la largeur, est ce que c’est possible en css?
    help!

    Reply to this message

  • 1
    fulvio

    comment insérer des séparateurs entre les numéros de pages en bas de l’article? Soit 1. 2. 3. .. soit 1 | 2 | 3 ... je ne sais pas ou placer ca dans le code

    Reply to this message

  • 2
    Willy

    Bonjour,
    Comment modifier la fonction pour que la découpe des pages se fasse de façon automatique par rapport à un nombre de caractère par exemple.
    Je me doute que c’est “$page = split(’-----’, $texte);” qu’il faut remplacer cependant je ne vois pas comment.

    Je sais bien qu’une telle découpe automatique n’est pas conseillé mais je souhaite juste savoir comment est il possible de le faire. Merci de vos réponses.

    • Willy

      J’ai enfin trouvé la réponse sur un forum php : l’utilisation de wordwrap().
      Wordwrap() permet nottament d’insérer un séparateur tous les n caractères en revenant au mot précédent pour ne pas le couper.

      j’ai pu ainsi intégrer automatiquement des ’-----’ à partir de x caractères et laisser ainsi le “split” fonctionner normalement.

      Donc : en fait, pour un découpage automatique :
      je remplace : $page = split(’-----’, $texte);
      par $texte2 = wordwrap($texte, 2000, ’-----’, 1);
      $page = split(’-----’, $texte2);
      voila ^^

    • cedricici

      Bonjour sur le même principe, j’ai modifié le filtre pour qu’il découpe l’article en ’n’ paragraphes entiers, la somme des caractères de ces paragraphes par pages étant inférieurs à la limite ajouté en argument du filtre (=2000 par defaut)

      // $page = split(’-----’, $texte);

      devient : avec $limite =2000 par defaut

      // on coupe tous les paragraphes et on regroupe ceux < $limite caractères

      $paragraphe = split(’’\n\n’’, $texte);

      $page[] = ’’’’;

      foreach($paragraphe as $par)

       if((strlen($page[sizeof($page)-1])+strlen($par)) <= $limite)

         $page[sizeof($page)-1] = $page[sizeof($page)-1].’’\n\n’’.$par;

         else

          $page[]=’’\n\n’’.$par;

        

      // $page = split(’-----’, $texte)

    Reply to this message

  • 1
    Dom

    Je viens de l’installer sur une 1.9.2, ça marche parfaitement du premier coup.

    Par contre cela semble assez difficile à personnaliser. N’y a-t-il pas d’autres moyens ou plugins ? Cette fonction n’est pourtant pas si exotique pour un logiciel de publication d’articles.

    Merci en tous cas, ça fonctionne très bien.

    Reply to this message

  • Jérémy Zucchi

    Bonjour, et tout d’abord bravo pour ce filtre très pratique! J’utilise le squelette EGT et sous Firefox il y a un problème au niveau du menu dépliable depuis que j’ai ajouté le fitre pour découper les articles (voir exemple). Par contre le découpage marche même sous Firefox, c’est juste le menu qui bugue. Si quelqu’un a une idée...

    Reply to this message

Add a comment

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.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom