Découper un article en plusieurs pages

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.

Dernière modification de cette page le 14 février 2019

Discussion

49 discussions

  • bonjour

    le script fonctionne tres bien , mais je voudrais simplement deplacer le menu de navigation en dessous de l’article pour qu’il garde la meme place ,,ce qui n’est pas le cas actuellement ,car l’article est decouper avec un nombre different de carateres a chaque page.

    merci...........

    Répondre à ce message

  • 5

    Dites-moi...
    Ce filtre ne pourrait-il pas fonctionner dans un tableau sur une même page ?
    Si oui, on tiendrait enfin LA solution pour publier des textes sur plusieurs colonnes.
     :-o

    • Après quelques modifications du code, il est maintenant possible d’avoir le texte sous forme de tableau ET sur plusieurs pages.

      La variable $nb_colonne indique le nombre de colonne à afficher par page.

      exemple :
      -  $nb_colonne = 2
      -  un texte qui tenait auparavant sur 5 pages

      -  résultat : la première page affiche les pages 1 et 2 sur deux colonnes. La page deux affiche les pages 3 et 4 et la dernière page, la 5.


      function decouper_en_page($texte) {
      global $artsuite, $var_recherche, $nb_colonnes;

      if (empty($artsuite)) $artsuite = 0;

      $nb_colonne = 2; // Nombre de Colonne pour l'affichage

      $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;
      }

      if ($num_pages <= $nb_colonne || !empty($var_recherche) || $artsuite < 0 || $artsuite > $num_pages) {
      $resultat = "

      ";
      for ($i = 1; $i < $nb_colonne; $i++) {

      $resultat .= "

      ";

      $resultat .= "

      ";
      }

      $resultat .= "

      ".$page[0]." ".$page[$i]."
      ";
      return $resultat;
      }

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

      switch (TRUE) {
      case ($artsuite == 0):
      $precedent = "";
      $suivant = ">>";
      break;
      case ($artsuite == ($num_pages-1)):
      $precedent = "<<";
      $suivant = "";
      break;
      default:
      $precedent = "<<";
      $suivant = ">>";
      break;
      }

      $j=0;
      for ($i = 0; $i < $num_pages;
      $i=$i+$nb_colonne) {
      if ($i == $artsuite) {
      $milieu .= " " . ++$j . " ";
      } else {
      $milieu .= " " . ++$j . " ";
      }
      }

      // Ici, on peut personnaliser la présentation
      $resultat = "

      ";

      $resultat .= "

      ";
      for ($i = $artsuite + 1; $i < $artsuite + $nb_colonne; $i++) {

      $resultat .= "

      ";

      $resultat .= "

      ";
      }

      $resultat .= "

      ".$page[$artsuite]." ".$page[$i]."
      ";

      $resultat .= "

      ";
      return $resultat;
      }
      // FIN du Filtre decouper_en_page

      J’espère que cela vous conviendra. ;-)

      Et bien sur, un grand merci au script de GPL.

      Nicolas

    • bonjour,
      le script fonctionne chez moi, la page est bien découpée, mais apparait l’erreur suivante sur chaque debut de page :

      Missing argument 2 for decouper_en_page() in /var/www/spip3/mes_fonctions.php3 on line 37

    • sugardaddy

      je n’obtiens pas les 2 colonnes...
      juste une lettre bizarre au moment de la separation et plus de texte apres, la 2e colonne est zappée.
      mais keskispass ?
      merci de votre aide.

    • Salut !

      J’ai installé la version découper l’article en plusieures pages sans soucis mais quand je tente de mettre en oeuvre la découpe dans un tableau je n’obtiens rien après les 5 - ...

      Y’a t’il quelque chose à mettre en oeuvre afin de faire apparaître la seconde partie du texte ?

      En effet j’aimerais que mes articles soient coupés pour rentrer dans une mise en page (squelette) un peu spécifique avec le début de l’article à gauche de la page et le reste sur la partie droite de la page ...

    • Après bien des tests, je constate que cette contrib remarquable pose un pb avec une boucle document ...

      • Prenons la page article.html de la dist 1.8.2.g
      • Ajoutons *|decouper_en_page|propre à la balise #TEXTE
      • Ajoutons le filtre qui va bien dans mes_fonctions.php3

      Ecrivons un article avec un document joint inséré dans l’article type <docXX|center>( inséré dans le formulaire pas simplement joint...). Je ne saisis même pas les 5 tirets, je fais au plus simple, un article basique avec un doc joint dans le formulaire...

      Alors, la boucle documents-joints avec {mode=document]{doublons} est en échecet renvoie quand meme en double le document inséré dans le texte :(

      C’est possible d’y remédier ?
      ps : j’ai le même pb avec la 1.9

    Répondre à ce message

  • Bonjour

    Magnifique, le filtre. Je suis sous spip 1.9 et ça marche a merveille. Mais j’aimerais savoir si je peux inclure le numéro de la page dans le titre. Dans le fichier article.html qui contient et je voudrais faire ...#TITRE(page XX)...
    Merci

    Répondre à ce message

  • Juste merci pour la contrib. C’est très pratique.

    Répondre à ce message

  • D’abord merci pour cette merveilleuse contribution.
    Je voudrais placer le menu de navigation (pages 1,2 >>) ailleurs que sous le texte de l’article, comment faire ?

    Répondre à ce message

  • 1

    Salut,

    Certains d’entre vous ont peut-être connu ce problème, avec le filtre « decouper_en_page » : lorsque je clique sur « Page suivante » (ou « Page précédente »), l’affichage de l’article ne se met pas à jour. Je suis obligé de « recalculer » la page à chaque fois pour accéder aux parties successives de l’articles.

    Auriez-vous une idée pour régler ce problème ?

    Merci d’avance !

    Répondre à ce message

  • 1

    Bonjour à tous,

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

    Seulement voilà, depuis que j’utilise les « urls propres » (1.8.1), il ne fonctionne plus...

    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 encore

    Répondre à ce message

  • 2

    Bonjour,

    Tout me paraissait si simple que tout finit par se compliquer...

    J’ai créé et placé à la racine du site le fichier mes_fonctions.php3 en ne faisant qu’un simple copier/coller du code proposé.

    Ensuite, dans article.html, j’ai remplacé (#TEXTE) par[(#TEXTE*|decouper_en_page|propre)]

    Erreur : filtre « decouper_en_page » non défini.

    Une solution pour me permettre d’utiliser ce superbe script ?
    Merci par avance

    • Cette fonction est du php, as-tu mis les balises :

         <?php
      et
         ?>

      au début et à la fin de ton fichier mes_fonctions.php3 ?

    • j’ai exactement le même problème..

      filtre « decouper_en_page » non défini, _reportages

      Et ou i j’ai mis les balises ou du moins j’a laissé les balises ouvrantes et fermantes de la page config-fonctions.php3 d’origine

      kelkun pourrait-m’aider ????

      merci

    Répondre à ce message

  • Bonjour,

    Première chose, merci beaucoup pour ce filtre :-) C’est vraiment bien de pouvoir découper les articles pour un meilleur confort de lecture.

    Avec les différentes interventions, j’ai pu déjà le modifier comme je le souhaitais, je bute cependant sur un truc.
    J’ai découpé mon article en plusieurs pages, à chaque page j’ai pu faire en sorte que le chapo, le titre, etc... n’apparaissent pas.
    Dans le même esprit j’aimerais que les champs Extras que j’ai rajouté ne s’affiche que sur la dernière page et pas sur toutes les pages... Vous avez une solution pour ça ?

    Merci d’avance :-)

    Répondre à ce message

  • 1

    Bonjour,

    sur mon poste local (Windows XP) ca fonctionne très bien. Par contre, sur mon serveur Linux, le découpage fonctionne mais, la mise en cache ne se fait pas (une seule page est cachée). Donc lorsque je clique pour aller sur la page suivante, il faut que je recalcule la page, ensuite pour aller encore à la suivante, il faut aussi recalculer la page (et ainsi de suite)....

    J’utilise spip agora.

    Des idées ?

    • Je suis débutant sur spip et je cherche à faire la chose suivante :

      Imaginons une rubrique qui contient 200 articles. J’aimerais afficher mes articles par pages de 10 ou 20, en les classant au choix par date, par auteur ou theme...

      Est-ce possible ? Merci !

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

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