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 . "'>>></a>";
break;
case ($artsuite == ($num_pages-1)):
$precedent = "<a href='" . $uri_art . "artsuite=" . $p_prec . "'><<</a>";
$suivant = "";
break;
default:
$precedent = "<a href='" . $uri_art . "artsuite=" . $p_prec . "'><<</a>";
$suivant = "<a href='" . $uri_art . "artsuite=" . $p_suiv . "'>>></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
<? } ?>
Discussions par date d’activité
27 discussions
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 :
[(#TEXTE*|monfiltre|propre)]
[(#TEXTE*|texte_script)]
Je vais m’acheter des lunettes !
Merci.
Répondre à ce message
Je suis un super-débutant en spip, et je viens d’installer ce filtre mais j’obtiens le message suivant :
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 ?
ahem...j’avais oublié de mettre les
dans le fichier mes_fonctions.php3...
Promis je recommencerai plus...
Non, aie aie, tapez pas si fort...
Répondre à ce message
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
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
Comment doit-on (peut-on ?) utiliser ce filtre avec les urls simplifiés du type « article24.html » ?
Sa marche tout seul
la preuve :
http://www.noplay.net/article30.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 :
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.
Suivre les commentaires : |