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

  • 2

    Bonjour. Je m’étonne d’une chose :

    Dans la documentation de SPIP (cf lien plus bas), il est précisé que le filtre |propre est un correcteur typographique, et que c’est |typo qui gere les raccourcis spip.

    D’où ma question : n’est-il pas nécessaire de rajouter le filtre |typo pour que les autres raccourcis SPIP tel que les liens internes, ou meme le passage en gras, fonctionne ?

    A plus !

    • Dans la documentation de SPIP il est précisé que le filtre |propre est un correcteur typographique, et que c’est |typo qui gere les raccourcis spip.
      D’où ma question : n’est-il pas nécessaire de rajouter le filtre |typo pour que les autres raccourcis SPIP tel que les liens internes, ou meme le passage en gras, fonctionne ?

      en fait tu as mal lu : typo est un filtre typographique, grosso modo il va rajouter (ou enlever) des espaces là ou il le faut (et pas mal d’autres petites choses), propre va gérer tous les raccourcis de spip (gras, liens...).

      donc pas de problème B-)

      Rappel :

      • pour un filtre spécial [(#TEXTE*|monfiltre|propre)]
      • pour le javascript, php [(#TEXTE*|texte_script)]
    • Je vais m’acheter des lunettes !

      Merci.

    Répondre à ce message

  • 1

    Je suis un super-débutant en spip, et je viens d’installer ce filtre mais j’obtiens le message suivant :

    Erreur : filtre « sommaire_article » non défini
    Erreur : filtre « decouper_en_page » non défini

    J’ai créé un fichier mes_fonctions.php3 dans lequel j’ai copié le contenu du script. Et je l’ai uploadé dans le rep spip de mon site.

    Dans le fichier article.html, j’ai remplacé le #TEXT par les 2 lignes indiquées.

    Ce n’est pas ce qu’il fallait faire ?

    • kronky l’étourdi...

      ahem...j’avais oublié de mettre les

      <?php et ?>

      dans le fichier mes_fonctions.php3...

      Promis je recommencerai plus...

      Non, aie aie, tapez pas si fort...

    Répondre à ce message

  • 1

    Je ne comprends pas à quoi correspond ce #NB_TITRE_DE_MON_ARTICLE# dans le filtre decouper_en_page.

    • ça correspond au nombres de titres (ie {{{blabla}}}) présents, le filtre crée le sommaire (avec des ancres) puis va couper le texte comme il faut.

    Répondre à ce message

  • Vraiment le filtre que j’attendais, merci pour la compile de 2 très bon filtres :-D

    Une amélioration serait de mettre le titre dans le sommaire si plus d’une ancre existe ... cela permettrait d’afficher réellement la première page sans effet d’ascenceur...

    Bravo encore !

    Répondre à ce message

  • 1

    Quelque chose de moins classique, genre
    -  .-.-.-.
    -  —saut—

    ne serait’il pas moins dangereux ??

    Le simple ----- étant une suite un peut trop commune .


    • est déja utilisé dans SPIP pour couper un article en plusieurs morceau grace à une ligne horizontale, ainsi la conversion des articles pour ce filtre ne pose pas de probléme

    Répondre à ce message

  • Super ce filtre !
    Ca marche impecc’

    Merci :-)

    Répondre à ce message

  • 1

    Comment doit-on (peut-on ?) utiliser ce filtre avec les urls simplifiés du type « article24.html » ?

    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