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

  • 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

  • Salut !
    Merci bcp pour la super fonction.

    Pour mes besoins, j’ai ajouté une fonction qui ajoute juste sur la premiere page par exemple le descriptif (et pas sur chaque page)

    Voici le code du fichier html
    (par exemple pour afficher le descriptif)

    (#DESCRIPTIF*

    dans mes_fonctions.php3
    function afficher($texte)
    global $artsuite ;
    if (empty($artsuite))
    return $texte ;

    Desolée : Je vois pas un moyen pour poster le code !?! Les accolades sont interpretés et aussi le code html... donc du coup c peutetre plus difficile à lire.
    de tout facon, dans la fonction, vous savez ou mettre les accolades.

    a+
    eve*

    Répondre à ce message

  • 1
    Sentinelle

    Bonjour et tout d’abord un grand merci pour cette nouvelle fonctionnalité !!

    J’aimerais avoir un menu déroulant pour accéder aux différentes pages, exemple :
    -  [page 1]
    -  [page 2]
    -  [page 3]

    Comment réaliser un tel menu ?

    @++
    sentinelle

    Répondre à ce message

  • 1

    Je n’arrive pas à combiner réduire une image et découpe le texte en chapitre.
    Dans mon squelette « article.html » j’ai le script suivant :

    [(#TEXTE|limit_images_size200,0,1)]

    [(#TEXTE*|sommaire_article|propre)]

    [(#TEXTE*|decouper_en_page|propre|justifier)]

    Ce type de script me redonne deux fois le même texte
    Merci de votre aide, je ne sais plus quoi faire

    Répondre à ce message

  • 3
    Disgraou

    J’ai modifié un tout p’tit peu le filtre pour afficher le sommaire dans un menu déroulant, c’est sans prétention mais ça fonctionne.

    Dans le filtre sommaire la ligne $texte=$texte."<a href=\"". $uri_art . "artsuite=" .$i. "#sommaire_".$nb."\" title=\"".$regs[1][$j]."\">".$regs[1][$j]."</a>, p$p<br />"; est à remplacer par :

    $texte=$texte."<option value=\"".$uri_art . "artsuite=" .$i. "#sommaire_".$nb."\">".$regs[1][$j]."</option>";

    Et dans le squelette article, à la place de[(#TEXTE*|sommaire_article|propre)] :

    <select name="sommaire" size="1" class="menu_deroulant" onchange="if (options[selectedIndex].value) { location = options[selectedIndex].value; }"><option selected value="">Sommaire de l'article</option>[(#TEXTE*|sommaire_article)]</select>

    • Sven Karls

      J’aime beaucoup le menu déroulant « plus sobre » qu’une liste...
      Mais je n’arrive pas à faire en sorte qu’il ne s’affiche que pour les articles comportant plusieurs pages.
      Est-ce qu’il y a une solution pour cela ?

    • dans le filtre sommaire essaye de remplacer

      return $texte ;

      par :

      if ($i!=1)
      {
      return $texte;
      }
    • Bonjour,

      je viens de tester vos petites modifs et le dernier code proposé

      if ($i!=1)
      {
      return $texte;
      }

      fonctionne en effet pour supprimer le contenu du menu déroulant s’il n’y a qu’un intertitre, mais pas le menu déroulant lui-même. On se retrouve donc avec une boîte déroulante intitulée sommaire qui ne sert à rien.

      Quelqu’un a-t-il une idée pour faire disparaître complètement le menu déroulant lorsqu’il n’y a pas plus d’un intertitre ?

      Merci d’avance et chapeau pour toutes ces petites astuces.

    Répondre à ce message

  • ManuDevil

    Bonjour, et merci encore pour ces filtres !

    J’avais essayé une version précédente, et il y avait un énorme problème de cache que cette version semble gérer correctement. Tant mieux !

    Mais deux petits bémols, tout de même.

    -  Tout d’abord, ça met un peu le bronx dans les notes de bas de pages. Certaines s’affichent alors qu’elle ne sont plus sur la page, ce n’est pas parfait.

    -  Concernant le sommaire, y aurait-il une option pour qu’il n’apparaisse que si on a découpé l’article ? Je trouve que ça pourrait être rudement mieux : pas de sommaire pour des articles courts, ce n’est pas nécessaire.

    Merci encore !

    Répondre à ce message

  • 2

    Comment on peut mettre le lien des pages suivantes ou précédentes au début et à la fin de l’article

    on ne dira jamais assez merci à toute l’équipe de SPIP

    • a mon avis il faut bricoler quelque chose de ce genre

      <?php
        
      if ($artsuite != $num_pages-1)
      // si on est pas la derniere page
      {
      LE LIENS VERS LA PAGE SUIVANTE
      }
      ?>

      « on ne dira jamais assez merci à toute l’équipe de SPIP »

      et la communaute

    • Merci pour la réponse

      je ne vois pas ou je dois mettre ce php ???

    Répondre à ce message

  • 3

    Lorsque je place le filtre sommaire_article dans la variable TEXTE (squelette article.html), cela a pour effet de faire disparaitre tout le texte de l’article...!!!

    La liste de mes filtres est un peu longue mais tout fonctionne très bien, notamment decouper_en_page, seul sommaire_article pose donc problème si je le rajoute :

    [(#TEXTE*|liens_ouvrants|propre|target|decouper_en_page|smileys|norm_liensblank|decouper_en_page)]

    • Et si tu essaye sa ?

      [(#TEXTE*|sommaire_article|propre)]
      [(#TEXTE*|liens_ouvrants|propre|target|decouper_en_page|smileys|norm_liensblank)]

    • C’est mieux merci ;-)

      Hélàs c’est pas encore çà pour moi !

      Les liens ne fonctionnent pas au niveau du sommaire en haut de l’article :

      Ex. http://munci.little-pinguin.net/article345.html

      C’est comme si les « ancres » n’existaient pas...

      Une explication ?

      Merci ;-)))

      (ps : j’en protite pour dire que si tu es informaticien professionnel et intéressé par notre asso, on aurait vivement besoin d’un coup de main sur notre site SPIP...)

    • Et en utilisant pour afficher l’article :

      [(#TEXTE*|decouper_en_page|propre|justifier)]

      il existe peut etre un conflit entre deux filtre (mais sa m etonnerait)

    Répondre à ce message

  • Salut,

    Dans le sommaire, comment masquer les liens de références aux pages si l’intertitre est dans la même page (pas de saut de page) ?

    Merci d’avance et bravo pour ce script !

    Répondre à ce message

  • 1

    Bonjour,

    Ce filtre est tout simplement magnifique. Merci beaucoup à son concepteur.

    Je tiens juste à signaler un petit problème, qui vient peut être de chez moi :-/ Lors de la création d’un tableau avec les raccourcis Spip, la mise en page finale ne ce fait pas. Le texte s’affiche avec les pipes.

    QQ’un a-t-il une idée ?

    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