Découper un texte en pages et/ou en onglets

Un nouveau raccourci typographique qui découpe le texte de vos rubriques ou de vos articles en plusieurs pages, ou crée pour vous des onglets... Rubis sur ongle !

Introduction

Les articles de votre site sont parfois un peu longs et vous vous êtes probablement déjà posé la question de savoir comment alléger vos belles tirades...

Que faire, donc, avec un couteau suisse ? Eh bien une découpe !

Voici notre solution : dans vos textes, il vous suffit d’utiliser quatre signes plus consécutifs (« ++++ ») à l’endroit où doit se trouver la coupure. Ce raccourci n’est pas sans rappeler les quatre signes moins consécutifs (« ---- ») qui indiquent à SPIP l’emplacement d’une ligne horizontale.

L’outil va ensuite ajouter automatiquement une petite zone de navigation en haut et en bas de votre texte, qui peut ressembler à ceci :

Si un extrait du texte est :

met jamais en quatre !
 
++++
 
Le chant à un : c'est le chant du palais

Alors, en passant la souris sur le chiffre « 2 », vous obtiendrez :

En passant la souris sur les liens de navigation, vous apercevez ci-dessus qu’un titre apparaît : il s’agit en fait du début de la première phrase de la page ciblée. Il pourrait également s’agir du premier titre... A vous de composer !

Lorsque votre article comporte plus de quatre pages, alors la navigation prend une forme plus complexe :

Un petit conseil : à l’intérieur de votre texte, il vaut mieux isoler ce raccourci en sautant une ligne de part et d’autre, SPIP saura alors mieux formater vos paragraphes. Vérifiez également qu’aucune balise HTML ou raccourci SPIP ne traverse les quatre plus (« ++++ ») : vous risquez d’endommager l’aspect de votre site, car chaque page ainsi découpée est considérée comme indépendante. Évitez par exemple :

{{Voici une fin de page en gras
 
++++
 
Voici un début de page en gras}}

La bonne syntaxe est :

{{Voici une fin de page en gras}}
 
++++
 
{{Voici un début de page en gras}}

Installation

Cet outil est une fonctionnalité du plugin « Le Couteau Suisse » que vous pouvez trouver ici : Le Couteau Suisse.

Pour avoir accès à la découpe de vos textes en plusieurs pages, il vous faut donc avoir installé ce plugin en suivant la procédure normale d’installation des plugins SPIP.

Ensuite, veuillez activer l’outil « Découpe un texte en pages » en vous rendant sur la page d’administration du plugin en espace privé (Bouton Configuration, et onglet "Le Couteau Suisse").

Petite astuce : afin d’éviter que le raccourci « ++++ » se retrouve automatiquement dans les résumés produits par la balise #INTRODUCTION, activez aussi l’outil « Balise #INTRODUCTION ».

Notes techniques

-  Techniquement parlant, cet outil agit sur toutes les balises #TEXTE trouvées dans vos squelettes et insère une coupure là où il trouve quatre signes plus (« ++++ »). Vous pouvez donc insérer des découpages dans vos articles, vos textes de rubrique, etc.

-  Une condition est cependant nécessaire : la découpe en page ne fonctionnera pas si votre squelette utilise la balise #TEXTE étoilée #TEXTE* »). En effet, cette syntaxe permet de s’affranchir de tous les filtres automatiques et SPIP renvoie donc le texte brut sans aucune transformation. Si vous tenez absolument à mettre une étoile, alors il faut ajouter à votre balise le filtre cs_decoupe, comme ceci : [(#TEXTE*|propre|cs_decoupe)]

-  Le plugin fonctionne tel quel avec la dist de SPIP. Cependant, si votre squelette est construit avec des inclusions, alors il est indispensable de transmettre à la noisette l’indicateur de page {artpage}, ainsi que les options éventuelles {cs} du Couteau Suisse. Par exemple :

<div id="page">
    <div id="contenu">
    <INCLURE {fond=inc-article-corps}{id_article}{id_rubrique}{artpage}{cs}>
    </div>
</div>

Notez que l’argument {env} vous permet de transmettre tout l’environnement au squelette inclus :

<div id="page">
    <div id="contenu">
    <INCLURE {fond=inc-article-corps}{env}>
    </div>
</div>

-  Le développement décrit dans le présent article est inspiré d’un ancien filtre que vous pouvez encore trouver ici : Découper un article en plusieurs pages. Afin d’assurer la compatibilité avec le séparateur « ----- », ajoutez le code suivant à votre fichier config/mes_options.php :

// Compatibilite ascendante avec l'ancien filtre 'decoupe'
@define('_decoupe_COMPATIBILITE', '-----');

Cette constante peut également servir à créer un nouveau raccourci de découpe.

Balise #CS_DECOUPE

Par défaut, le Couteau Suisse insère la pagination en tête et en pied d’article automatiquement. Mais vous avez la possibilité de placer cette pagination ailleurs dans votre squelette qu’en tête de votre article grâce à une balise #CS_DECOUPE. L’utilisation de cette balise doit être activée dans la page de configuration et annule ainsi l’insertion automatique des paginations dans votre article.

Cette balise renvoie la pagination seule quand elle existe (quand l’article est découpé), et se comporte un peu comme la balise #TEXTE : elle doit être placée à l’intérieur d’une boucle ARTICLES. Depuis la version 1.8.36.01 du Couteau Suisse, la balise #CS_DECOUPE accepte un paramètre numérique permettant d’accéder directement à un article par son id_article, évitant ainsi une boucle dédiée.

Exemples : #CS_DECOUPE{2}, #CS_DECOUPE{#GET{toto}} ou #CS_DECOUPE{#ENV{id_article}}.

Attention, ce raccourci ne doit pas être utilisé à l’intérieur d’une boucle du même article, sous peine d’un appel SQL inutile. Exemple évident à éviter : <BOUCLE01(ARTICLES)>#CS_DECOUPE{#ID_ARTICLE}</BOUCLE01>

Les Surcharges

Les images

Si vous désirez changer les images utilisées pour la navigation (par défaut, ce sont de petits triangles noirs), il est préférable de recopier le dossier couteau_suisse/img/decoupe/ directement dans votre squelette. En effet, SPIP va d’abord chercher le dossier en question dans votre squelette avant d’aller explorer les répertoires du plugin : c’est le mécanisme des surcharges. Du coup, vous pouvez créer un dossier monsquelette/img/decoupe/ afin de remplacer celui du Couteau Suisse et y mettre vos propres images. Ainsi, la mise à jour de votre plugin à tendance helvétique préféré pourra se faire sans crainte de perdre votre personnalisation.

Les images doivent obligatoirement se nommer ainsi : debut.gif, debut_off.gif, precedent.gif, precedent_off.gif, suivant.gif, suivant_off.gif, fin.gif, fin_off.gif. Si debut.gif ou fin.gif n’est pas trouvé, alors les images precedent.gif ou suivant.gif seront doublées (cf l’exemple ci-dessus).

Les fonds

Si les fonds proposés par défaut pour la pagination ne vous satisfont pas, alors il suffit pour vous de les surcharger dans votre propre squelette (y copier les originaux avant de les modifier). Les fichiers en question sont : fonds/decoupe_item.html (calcul des numéros) et fonds/decoupe.html (inclusion du fond précédent et ajout des flèches de navigation). Toutes les possibilités CSS vous seront alors ouvertes !

Attention : toute modification d’un fichier ou d’un dossier surchargé nécessite une recompilation des outils du Couteau suisse, obtenue en se rendant simplement sur la page de configuration du plugin ou en ré-affichant celle-ci.

La découpe en AJAX

AJAX est une petite merveille qui permet d’isoler un fragment HTML au sein d’une page et réagissant aux localement clics. En gros, plus besoin de charger la page entière pour en modifier seulement qu’une partie... Ici, la découpe de vos articles se marie très bien avec cette idée, puisqu’il n’est pas nécessaire de tout reconstruire la page (les menus, les entêtes, etc.) alors qu’on ne fait que changer de fragment d’article découpé, comme si on feuilletait les pages d’un livre.

Si vous êtes sous SPIP 2.0 minimum, on continue, sinon, sautez à l’intertitre suivant en attendant de mettre à jour votre CMS préféré.

Pour mettre en place un fragment AJAX, il faut isoler ce qui concerne l’article proprement dit dans un fichier à part que l’on nommera inc-article-corps.html, et y mettre par exemple la boucle suivante (mettez-y, bien sûr, le contenu que vous voulez, le plus important, c’est d’y avoir la balise #TEXTE) :

<div class="inc_article">
<BOUCLE_inc_article(ARTICLES){id_article}>
	<div class="#EDIT{titre} titrearticle">#TITRE</div>
	[<div class="#EDIT{chapo} chapo">(#CHAPO)</div>]
	<div class="#EDIT{texte} texte">#TEXTE</div>
</BOUCLE_inc_article>
</div>

Ensuite, dans votre fichier article.html, censé afficher la page complète, mettez simplement quelque chose comme :

<BOUCLE_article_page(ARTICLES){id_article}>
<!DOCTYPE bla bla bla>
<head>bla bla bla, notamment un #TITRE</head>
<body>
Divers trucs de présentation, avant...
... Et surtout :
	<INCLURE{fond=inc-article-corps}{ajax}{id_article}{artpage}{cs}>
Divers trucs de présentation, après...
</body>
</html>
</BOUCLE_article_page>
</B_article_page>
<INCLUDE{fond=404}>
<//B_article_page>

Avec ce mécanisme, la pagination ne fonctionnera qu’à l’intérieur du <div class="inc_article"> et un clic de souris ne rechargera pas la page entière, mais bien le seul fragment concernant les contenus SPIP de votre article (dans l’exemple ci-dessus : le titre, le chapo éventuel et le texte).

Notez le critère magique {ajax} disponible à partir de SPIP 2.0, l’id de l’article {id_article} nécessaire à la boucle BOUCLE_inc_article, l’indispensable indicateur de page {artpage} à transmettre au fragment, et les options éventuelles {cs} du Couteau Suisse.

Les filtres

Un paramètre artpage ajouté à l’URL de votre article permet au plugin de connaître le numéro de la page à afficher. Il est composé de deux nombres séparés par un tiret : artpage=PC-NB, où PC est le numéro de la page en cours et NB est le nombre total de pages.

Il existe trois filtres pour tirer partie de ce paramètre :

-  artpage($artpage=false, $index=0) : renvoie l’un ou l’autre des deux nombres.
Par défaut (si $index=0), la fonction renvoie la page en cours.
Si $index=1, la fonction renvoie le nombre de pages. Attention : si ce nombre est absent du paramètre artpage ou si ce paramètre est introuvable, alors la fonction renvoie 0.

-  artpage_fin($artpage=false) : renvoie vrai si la page en cours est la dernière. Si le nombre de pages est absent du paramètre artpage ou si ce paramètre est introuvable, alors la fonction renvoie faux.

-  artpage_debut($artpage=false) : renvoie vrai si la page en cours est la première.

Dans vos squelettes, il vous uffit donc d’utiliser :

-  #ENV{artpage}|artpage pour la page en cours
-  #ENV{artpage}|artpage{1} pour le nb de pages, s’il est présent

Deux exemples équivalents :

-  [(#ENV{artpage}|artpage|=={1}|oui) Youpi, ceci est la première page !]
-  [(#ENV{artpage}|artpage_debut|oui) Youpi, ceci est la première page !]

Notez que le filtre oui est introduit par SPIP 2.0. Il permet de rendre vraie une expression au sens SPIP et doit notamment être appliqué sur un filtre de type boolean (vrai/faux). Pour les versions antérieures de SPIP, les exemples précédents sont également valides : le Couteau Suisse contient les filtres oui et non dans ses fonctions et vous permet de les utiliser sans crainte dans vos squelettes.

Astuces

-  En manipulant les styles css, Il vous est possible de désactiver une des deux lignes de navigation (ou les deux si vous le souhaitez, mais le bon sens n’y vois aucun intérêt !). Dans le head de votre squelette ou dans un fichier css, il vous suffit d’insérer « div.decoupe_haut{display:none !important;} » pour supprimer la navigation placée en haut du texte, et « div.decoupe_bas{display:none !important;} » pour supprimer celle d’en bas.

-  Dans les fichiers de votre squelette, vous avez peut-être une balise #TEXTE destinée à l’impression du texte complet, non découpé en pages. Le Couteau Suisse met à votre disposition un filtre « cs_imprimer » qui produira le texte dans son ensemble, où les pages sont simplement séparées par un mince filet pointillé. La syntaxe pourrait être celle-ci : [(#TEXTE*|cs_imprimer|propre)]. Mais ceci est un peu lourd, lisez le point suivant.

-  Dans votre navigateur, ajouter à l’adresse d’une page le paramêtre « cs=print » permet d’obtenir le même effet décrit ci-dessus et force le Couteau Suisse à afficher l’article entier. Par exemple : www.monsite.ici/spip?article999&cs=print
Aussi, ce paramétrage est automatique dans les squelettes suivants : « print.html », « imprimer.html », « imprimir_articulo.html », « imprimir_breve.html » ou « article_pdf.html » (donc ici : « page=print », « page=imprimer », etc.). Lisez ici le paragraphe « Particularités » pour en savoir davantage.

-  Le découpage d’un article peut permettre très facilement de se composer rapidement un diaporama que vous pouvez éventuellement commenter (astuce de Ch. Guigueno). Il suffit de placer une photo par page et le tour est joué ! Voici un exemple (emb1 et emb2 doivent être des images) :

{{{Mon titre 1}}}
Voici ma photo 1 : <emb1|center>
<center>{Remarquez ces couleurs !}</center>
++++
{{{Mon titre 2}}}
Voici ma photo 2 : <emb2|center>
<center>{Remarquez ces textures !}</center>
++++
etc. !

-  Cet outil « Découpe un texte en pages » se marie très bien avec l’utilisation d’un outil voisin, le Sommaire Automatique : « Un sommaire pour vos articles ». Si ce dernier est activé, le sommaire détecte en effet les découpages et ajoute le numéro de la page où les différents intertitres SPIP ont été trouvés.

Les onglets dans vos articles

Vous pouvez trouver de très nombreux exemples d’utilisation des onglets dans les articles : par ici ou par ici...

Depuis la version 1.7.8.07 du plugin, l’outil « Découpe un texte en pages » offre (pour peu de code supplémentaire !) la possibilité de construire des onglets dans vos articles (ou même dans vos squelettes). La syntaxe est basée sur le même séparateur (« ++++ ») que l’on place très simplement à l’intérieur des balises <onglets> et </onglets>. Par exemple :

<onglets>
Titre 1
 
Mon 1er Texte après deux sauts de ligne
++++
Titre 2
 
Mon 2ème Texte après deux sauts de ligne
</onglets>

Voici en image ce que donne un usage par défaut :

Dont voici le code :

<onglets>Introduction
  
blah blah
++++Développement
 
blah blah blah
++++Conclusion
 
blah blah blah blah
</onglets>

Cette fonctionnalité utilise les librairies JQuery, simplifiant grandement la tâche des programmeurs et utilisées par SPIP lui-même.

Afin d’afficher correctement les onglets demandés par le rédacteur, le plugin fournit le code HTML suivant :

<div class="onglets_bloc_initial">
   <div class="onglets_contenu">
        <h2 class="cs_onglet"><a href="#">Introduction</a></h2>
        blah blah
   </div>
   <div class="onglets_contenu">
        <h2 class="cs_onglet"><a href="#">Développement</a></h2>
        blah blah blah
   </div>
   <div class="onglets_contenu">
        <h2 class="cs_onglet"><a href="#">Conclusion</a></h2>
        blah blah blah blah
   </div>
</div>

jQuery va ensuite construire à la volée le système d’onglets et mettre en rapport les onglets cliquables et les contenus. Les ancres sont introduites dans certaines balises <div> sous forme : id="mon_ancre".

Cela donne donc au final le code HTML suivant :

<div class="onglets_bloc" id="ongl_0">
  <div class="onglets_liste">
      <h2 class="onglets_titre" id="onglets_titre_0">
         <a href="#">Introduction</a>
      </h2>
      <h2 class="onglets_titre selected" id="onglets_titre_1">
         <a href="#">Développement</a>
      </h2>
      <h2 class="onglets_titre" id="onglets_titre_2">
         <a href="#">Conclusion</a>
      </h2>
  </div>
  <div class="onglets_contenu" id="onglets_contenu_0">
      blah blah
  </div>
  <div class="onglets_contenu selected" id="onglets_contenu_1">
      blah blah blah
  </div>
  <div class="onglets_contenu" id="onglets_contenu_2">
      blah blah blah blah
  </div>
</div>

Aspect visuel

Dans le code ci-dessus, il est facile de repérer les différents blocs <div> ou <h2>, affublés de classes qui vous permettrons de changer l’aspect des onglets à votre guise, comme ceci par exemple, les onglets créés par Douglas Bowman :

dont j’ai reconstitué pour vous le fichier CSS adapté au Couteau Suisse qui devra être interprété APRES les styles définis par défaut :

Voici d’autres onglets créés par Douglas Bowman :

Je mentionne également une contribution similaire de Pi r, ayant adapté pour SPIP les scripts d’Erik Arvidsson, programmés en Javascript pur. Mais aujourd’hui, autant utiliser directement les librairies jQuery de SPIP et alléger le temps de chargement des pages. Les versions 1.7.9.12 et suivantes du Couteau Suisse comprennent la syntaxe de ce plugin, assurant ainsi une compatibilité pour d’anciens articles basés sur ces travaux.

Ancres et paramètres

Chaque bloc d’onglets est affublé d’une ancre : #ongl_0, #ongl_1, etc. Ajoutée à l’url de votre page, l’ancre placera automatiquement le navigateur en tête de bloc.

Pour activer un onglet particulier sur une page lors du chargement de cette dernière, il vous suffit d’ajouter un paramètre dans votre url. Par exemple : « onglet=2 » (ou "http://www.spip-contrib.net/Decouper-un-texte-en-pages-et-ou?onglet=2").

Notez que le premier onglet est noté zéro ; l’exemple précédent activera donc le troisième onglet de la page entière.

Les onglets dans vos squelettes

Depuis la version 1.7.9.12 du plugin, de nouvelles balises (#ONGLETS_DEBUT, #ONGLETS_TITRE et #ONGLETS_FIN) ont été introduites afin de vous permettre de construire des onglets directement dans votre squelette (fichiers *.html). Voici un exemple de syntaxe :

[(#ONGLETS_DEBUT{Introduction})]
	blah blah
[(#ONGLETS_TITRE{Développement})]
	blah blah blah 
[(#ONGLETS_TITRE{Conclusion})]
	blah blah blah blah
#ONGLETS_FIN

Au sein d’une boucle SPIP et sur un bloc d’onglets principal (non imbriqué dans un autre bloc d’onglets), vous pouvez omettre #ONGLETS_DEBUT, le Couteau Suisse construira quand même le bloc correctement (version 1.8.06.01 minimum du plugin). Si votre bloc d’onglet est imbriqué, alors il faut jouer avec la balise #COMPTEUR_BOUCLE et vérifier que le premier appel de balise est bien #ONGLETS_DEBUT. L’intérêt ici est de pouvoir placer un champ de cette boucle dans le titre des onglets.

Par exemple, le code :

<B_sites>
<BOUCLE_sites(SITES){syndication=oui}>
	[(#COMPTEUR_BOUCLE|=={1}|?{' '})#ONGLETS_DEBUT{#NOM_SITE}]
	[(#COMPTEUR_BOUCLE|>{1}|?{' '})#ONGLETS_TITRE{#NOM_SITE}]
	<BOUCLE_articles(SYNDIC_ARTICLES){id_syndic}{par date}{inverse}>
	&bull; #TITRE<br/>
	</BOUCLE_articles>
</BOUCLE_sites>
#ONGLETS_FIN
</B_sites> 

s’il n’est pas contenu dans un autre bloc d’onglets, peut être simplifié en :

<B_sites>
<BOUCLE_sites(SITES){syndication=oui}>
	#ONGLETS_TITRE{#NOM_SITE}
	<BOUCLE_articles(SYNDIC_ARTICLES){id_syndic}{par date}{inverse}>
	&bull; #TITRE<br/>
	</BOUCLE_articles>
</BOUCLE_sites>
#ONGLETS_FIN
</B_sites> 

Dépendances

-  La librairie jQuery est requise pour le fonctionnement des Onglets, dans la construction et la manipulation des jeux d’onglets présents sur la page finale. Ces fonctions Javascript très utile a été intégré au core dès la version 1.9.2 de SPIP. Pour les versions inférieures, il vous faut installer et activer le plugin Jquery que vous pouvez télécharger ici : http://zone.spip.org/files/spip-zon....

-  Les styles CSS et les fonctions Javascript du plugin sont insérés grâce à la balise #INSERT_HEAD qui doit absolument être présente (en un seul exemplaire) dans le head de vos squelettes (entre les balises <head> et </head> des fichiers HTML). Si vous ne trouvez pas cette balise dans vos codes et que les liens n’ont pas l’apparence voulue, alors activer l’outil "Balise #INSERT_HEAD" permet au Couteau Suisse d’insérer automatiquement cette balise sans manipulation de votre part.

-  Bug ! Manu_TJ nous a écrit : « sur mon site, l’utilisation des onglets ne fonctionne pas sur de très longs articles : la page affichée est blanche, le texte est bien en base mais ne s’affiche pas à l’écran (espace public comme privé). Dès que j’enlève les balises "onglets", l’article réapparaît. Et sur les articles avec moins de texte, pas de soucis non plus ». Il s’avère que son site est interprété par PHP v5.2.9 et il semble que sous cette version du célèbre langage, la fonction preg_replace_callback() en mode "ungreedy" perd le texte en cours de route s’il est trop long : l’expression ',<onglets([0-9]*)>(.*?)</onglets\1>,ms' ne fonctionne plus alors que ',<onglets([0-9]*)>(.*)</onglets\1>,ms' fonctionne toujours... En regardant le début du fichier outils/decoupe_fonctions.php on voit l’expression régulière qui nous intéresse en define(). Il suffit donc de la surcharger dans le fichier /config/mes_options.php en ajoutant la ligne suivante :

define('_onglets_REGEXPR', ',<onglets([0-9]*)>(.*)</onglets\1>,ms');

Cela annulera l’effet ungreedy de l’expression mais interdira du coup les multiples systèmes d’onglets dans un article. Cependant, cette expression contourne le bug de PHP 5.2.9 ...

Voir aussi

-  Le plugin autonome (non dépendant du couteau suisse) : En onglets dans le texte de SPIP, ou ailleurs...

Discussion

103 discussions

  • 6

    Bonjour,

    je viens de mettre en place ton super CS pour découper une page en plusieurs via le génial ajax sous SPIP 2.18 et CS uptodate.

    J’utilise #CS_DECOUPE et j’’ai un problème car il y a 2 paginations à s’afficher sur la ligne. Je ne veux pas de la pagination de droite 2>. J’ai essayé de trifouiller le fichier decoupe_item.html sans succès. Je ne veux que les pavés rouges de droite.

    • Hmm... Je ne vois pas d’où peut venir cette double pagination... Le fond d’origine du plugin présente-t-il aussi cette erreur ?

      Tu as un lien public peut-être ?

    • C’est ici : http://www.jp.guihard.net/spip.php?article130.

      Je n’ai modifié aucun des tes fichiers mis à part la css decoupe.css.

      J’ai un autre petit problème, si tu as le temps. J’ai des des title qui ne s’affichent pas toujours correctement sur les flèches gauche ou droite.

    • J’ai trouvé où se trouvait la merdouille. Cela venait d’une class de css que j’utilisais déjà et que j’appelle aussi .pagination. Cela faisait tout se mélanger.

      Cela dit, si tu as le temps et le courage, j’aimerai bien un procédé de personnalisation de ce que l’on veut afficher. Pour ma part , je ne vois pas l’intérêt d’afficher une flèche quand elle ne pointe vers rien. J’ai contourné la chose en remplaçant tes precedent_off en une image vide. En outre, pouvoir mettre un message avant les icônes, du genre Lire la suite de l’article truc truc, message qui varierait si nous sommes en cours d’article ou à la fin. Truc à mettre dans ton fichier decoupe_item par exemple.

      En tous les cas, merci pour cette lame et pour le CS en général.

    • La réponse est dans tes propres messages. Pour personnaliser cette pagination, il suffit de surcharger dans ton squelette les deux fichiers suivants :
      -  decoupe_item.html, qui s’occupe des numéros
      -  decoupe.html, qui s’occupe des flèches et intège le précédent

      N’hésite pas à nous faire part de tes travaux, cela pourra intéresser d’autres utilisateurs ! Auncun besoin d’image vide, donc ;-)

      Rappel : la surcharge dans un squelette perso est indispensable afin de profiter des mises à jour régulières du Couteau Suisse. Surtout ne pas modifier les fichiers originaux du plugin.

    • Je suis en train de vouloir ajouter un texte du genre lire les pages suivantes de l’article XX et lire les pages précédentes de l’article XX si on est à la fin. Sais tu comment passer l’id de l’article dans le fichier decoupe.html. J’ai essayé de rajouter ce paramètre [(#CS_DECOUPE{id_article})] sans succès. En récupérant #ENV dans le fichier decoupe.html, je n’ai pas l’id de l’article.

    • Oui c’est normal, comme tu peux le voir dans le contenu de decoupe.html, il n’y a pas l’id. Cette pagination est prévue pour le découpage d’un seul article, pas le découpage d’un texte en plusieurs articles...

      Je vais modifier la balise #CS_DECOUPE : voir l’article ci-dessus pour son utilisation.

    Répondre à ce message

  • 2

    Bonjour

    J’utilise la balise #CS_DECOUPE et souhaiterai que s’affiche avant la flèche de gauche un texte de mon choix (par exemple page).

    Mais si je fait un truc du genre [page (#CS_DECOUPE)] j’obtiens bien le texte page mais pas au bon endroit. En jouant avec des CSS j’arrive à le centrer au dessus.

    Mais est il possible de modifiez la balise #CS_DECOUPE et comment ?

    merci d’avance.

    F.M BILLARD

    • En CSS, cela doit pouvoir se régler. Essayez encore en modifiant les styles à la volée grâce à Firefox/Firebug.

      Sinon, la pagination est contruite grâce au fond couteau_suisse/fonds/decoupe.html que vous pouvez copier puis modifier dans votre propre squelette : mon_squelette/fonds/decoupe.html.

    • Bonjour

      oui avec les CSS j’ai bidouillé un système qui fonctionne.

      Je vais jeter un coup d’oeil au fichier decoupe.html

      merci

      F.M BILLARD

    Répondre à ce message

  • 1

    Les onglets sont stylés par la feuille de style header.css insérée dans le head de la page, assez pénible à surcharger : comment peut-on empêcher l’insertion de cette feuille de style ?

    • La feuille header.css est issue de la compilation finale de tous les outils activés. Pour surcharger les styles, il faut surcharger chacune des feuilles utilisées par les outils. En l’occurence, les onglets utilisent le fichier outils/decoupe.css qu’il est facile de recopier dans son squelette puis de modifier à volonté.

      Attention toutefois à certaines propriétés indispensables au bon fonctionnement des onglets : z-index, position, display, float et Cie j’imagine...

      Je n’insisterai jamais assez, que pour un fonctionnement optimum du plugin, chaque surcharge nécessite une recompilation complète du plugin :
      -  soit réafficher sa page d’admin,
      -  soit valider la config d’un outil,
      -  soit ajouter le paramètre « cs=calcul » dans l’URL

    Répondre à ce message

  • 3

    Bonjour,

    Merci pour ce plugin que j’ai plusieurs fois utilisé par le passé.

    Aujourd’hui, je me trouve confronté à une situation inédite.
    J’utilise ce plugin pour découper des articles auxquels sont joints plusieurs dizaines d’images.
    A partir de ces images, je génère une galerie.

    Mon objectif : arriver à relier certaines images à certaines pages (découpées avec ce plugin), afin que ma galerie n’affiche que les images liées à la page en cours.

    Ma première idée : utiliser une numérotation au début du titre de chaque image (ex : 1. titre pour toutes les images de la page 1, etc)

    Je numérote donc mes images, et je teste le code suivant basé sur un test du titre par expression régulière :

    <B_GALERIE>
    
    <h1><:galerie:></h1>
    
    <ul>
    
    <BOUCLE_GALERIE(documents) {mode==image} {id_article} {doublons} {par num titre} {titre==^[3]}>
    
    <li><a href="#URL_DOCUMENT" title="#DESCRIPTIF">[(#FICHIER|image_reduire{0,100}|inserer_attribut{'alt',#TITRE})]</a></li>
    </BOUCLE_GALERIE>
    
    </ul>
    
    </B_GALERIE>

    Ca marche, dans ce cas, ma galerie ne contient plus que les images dont le titre commence par « 3 », c’est à dire celle que j’associerai à la page « 3 » de mon découpage.

    Il est temps de remplacer mon 3 par un code qui me donnera le numéro de la page en cours dynamiquement.

    Je sais que [(#ENV{artpage}|artpage)] me donne le numéro de la page en cours.
    Et celui me renvoit bien toujours « 1 » pour les articles non découpés, et toujours le numéro de la page en cours pour articles découpés. Cela parait exploitable pour mon problème

    Hélas, je ne pourrai pas l’utiliser tel quel dans un critère de boucle (on ne peut pas utiliser de balises filtrées dans un critère).

    J’essaie donc un truc à base de PHP :

    <B_GALERIE>
    
    <h1><:galerie:></h1>
    
    <ul>
    
    <BOUCLE_GALERIE(documents) {mode==image} {id_article} {doublons} {par num titre} {titre==^[<?php echo "[(#ENV{artpage}|artpage)]"; ?>]}>
    
    <li><a href="#URL_DOCUMENT" title="#DESCRIPTIF">[(#FICHIER|image_reduire{0,100}|inserer_attribut{'alt',#TITRE})]</a></li>
    </BOUCLE_GALERIE>
    
    </ul>
    
    </B_GALERIE>

    Cela ne fonctionne pas.
    Probablement dû à l’ordre dans lequel SPIP interprète les pages ?

    Si vous avez une piste pour résoudre mon problème, je suis preneur...

    Merci de m’avoir lu.

    • Le php n’est pas du tout autorisé. Il faut peut-être utiliser #SET et #GET (non testé) :

      #SET{page,[(#ENV{artpage}|artpage)]}

      Puis utiliser #GET{page} dans le critère de la boucle...

    • Bonjour,

      Merci pour réponse, elle m’a mis sur la bonne piste.

      J’avais déjà exploré cette piste (SET, GET) hier sans succès.
      En ré-essayant aujourd’hui, je me suis rendu compte d’un pb de syntaxe lors de la définition du #SET.

      J’ai maintenant un code qui fonctionne et qui ressemble à cela :

       #SET{numero_page,#ENV{artpage}|artpage}
      <B_GALERIE>
      <h1><:galerie:></h1>
      <ul>
      <BOUCLE_GALERIE(documents) {mode==image} {id_article} {doublons} {par num titre} {titre==^[#GET{numero_page}]}>
      
      <li><a href="#URL_DOCUMENT" rel="prettyPhoto[gal01]" title="#DESCRIPTIF">	
      [(#FICHIER|image_reduire{0,100}|inserer_attribut{'alt',#TITRE})]</a></li>
      
      </BOUCLE_GALERIE>
      </ul>
      </B_GALERIE>

      On remarquera la syntaxe particulière du filtre dans la définition de SET (sans parenthèses, ni crochets).
      C’est cette page qui m’a mis sur la bonne voie quant à la syntaxe : http://www.mail-archive.com/spip@rezo.net/msg11944.html

      Reste maintenant à résoudre le cas des articles non découpés avec images non numérotées (non numérotées en 1), en effet, il est apparemment impossible de distinguer (par son environnement, ENV) une article non découpé, de la première page d’un article découpée.
      J’ai vérifié, et hélas sur la page 1 d’une série de 5 pages par exemple, le code #ENV{artpage}|artpage{1} renvoie 0 au lieu de renvoyer 5.

      Au pire, je demanderai à l’utilisateur de signaler le découpage d’un article par le biais d’un mot clé associé par exemple qui lui permettra de choisir entre une galerie découpée ou une galerie unifiée pour l’article en question.

      Dans tous les cas, merci pour votre aide qui m’a permis d’aboutir rapidement...

    • A moins de créer un nouveau filtre, tu peux déjà déceler le découpage de l’article en cherchant le séparateur dans le #TEXTE**, par exemple (non testé) :

      	#SET{sep, #EVAL{preg_quote(_decoupe_SEPARATEUR)}}
      	[(#TEXTE**|match{#GET{sep}}|oui) découpage OK !]

      Doc : http://www.spip.net/fr_article4299.html

      Sinon, je reconnais que le filtre |artpage{1} se limite à décoder le parametre d’url... Du coup, si on se trouve sur une première page d’article, sans paramètre, ce filtre renvoie zéro alors que l’article est quand même découpé... Pour remédier à cela, il faudrait créer une balise du genre #NB_ARTPAGES (utilisable seulement à l’intérieur d’une boucle ARTICLE) qui irait examiner le texte brut stocké en base et rendrait alors le nombre réel de pages....

    Répondre à ce message

  • Bonjour,

    Actuellement, je voudrais utiliser le plugin couteau suisse et tout specialement les onglets, mais ceux-ci s’affichentcorrectement dans l’espace privé, mais ne sachant pas quoi et oû modifier dans le squelette pour les faire apparaitre dans mon espace public.
    J’utilise le plugin Giseh et spip 2.1.2

    Répondre à ce message

  • 1

    Bonjour,
    Débutant sous Spip, je découvre peu à peu toutes les possibilités...
    Actuellement, j’aurai bien aimé faire apparaitre des onglets dans l’un de mes articles, mais ceux-ci s’affichent les uns en dessous des autres...
    L’affichage est correct dans l’interface privé de Spip (2.0.10)
    En désactivant le squelette (Multiflex), l’affichage est correct dans le site par contre.
    Pouvez m’indiquer où je dois regarder/corriger afin que cela fonctionne ?
    Merci par avance )

    • Tu as un lien public ? C’est sûrement un problème de CSS inline/block, le couple Firefox/Firebug te permettra facilement de mettre au point tout ça.

    Répondre à ce message

  • 2

    Bonjour,
    Je découvre un grave pb dans l’utilisation épatante des onglets :

    Sur la page : http://education.cyberindre.org/cddp36/escapages/?-Les-activites-

    Avec Firefox : les 6 onglets apparaissent bien

    Avec Internet Explorer : seuls 4 onglets apparaissent

    Queklqu’un a-t-il une modif ou solution à proposer ou dois-je repenser mes articles ?
    merci

    Détail : spip2.1 + zpip + couteau suisse
    Syntaxe utilisée :
    Titre 1
    Placez votre texte ici
    ++++Titre 2
    Placez votre texte ici

    • Salut.

      Es-tu sûr qu’il n’y a pas d’erreur de syntaxe dans ton code source ? Il se peut que Firefox fasse une correction qu’IE ne sait pas faire... Pourrais-tu simplifier le contenu des onglets afin d’en avoir le coeur net ?

      Si une erreur de balise non fermée est présente dans l’un des blocs, il est possible que cela mette en péril l’affichage des onglets sous IE.

    • Merci et bravo, j’avais une balise de couleur [vert]qui n’était pas fermée. le problème est donc réglé.

    Répondre à ce message

  • 2

    Bonjour !

    1) Ceci marche aussi avec SPIP 2.1 — ajouter le mot-clé ?

    2) Pour surcharger le fichier .CSS que proposes-tu ? Devrions-nous mettre les styles que nous souhaitons changer dans un autre fichier ? Si nous changeons decoupe.css alors nos changements seront perdus à la mise à jour du couteau n’est-ce pas ?

    • Mon problème avec (2) est que même si je mets #INSERT_HEAD_CSS dans le squelette avant l’appel à mon propre fichier de styles, decoupe.css est inséré quand même après. Je ne peux pas le surcharger donc.

    • Salut,

      La solution basique est effectivement de surcharger outils/decoupe.css en le recopiant/modifiant dans ton squelette : tu ne risques pas beaucoup en te privant des éventuelles futures mises à jour puisque ces styles seront parfaitement adaptés à ton squelette.

      Sinon, le nouveau pipeline #INSERT_HEAD_CSS n’est pas (encore ?) pris en compte par le Couteau Suisse.

    Répondre à ce message

  • 1

    bonjour,
    j’ai un petit souci avec cette fonction.

    je compose mon texte + illustrations. j’ajoute les « ++++ » pour faire la decoupe en onglet.
    la découpe se fait mais le problème c’est que quand je clique sur les différents onglet la page revient toujours sur l’onglet 1 et ne continue pas sur les autres onglets.
    solution ?
    merci

    Répondre à ce message

  • 4

    Surcharge des CSS
    Je cherche à surcharger decoupe.css et pour éviter de perdre mes modifs à la prochaine mise-à-jour, je souhaite créer un fichier decoupe.css dans mes squelettes. J’ai placé un tel fichier dans squelettes puis dans outils/squelettes, mais il n’est pas pris en compte dans l’un ou l’autre de ces deux cas...
    Ce ne doit pas être le bon endroit pour placer ce fichier personnalisé... Où faut-il le mettre ?
    PS : Merci encore pour ce super outil et tout le travail réalisé !

    • bonjour,

      Pour surcharger il te faut créer un fichier surcharge-decoupe.css pour surcharger decoupe.css

    • Pffioouuuu, super rapide comme réponse ! Cela dit, ça ne fonctionne pas chez moi : la feuille de style n’est pas prise en compte (SPIP 2.1 - CS : 1-8-18)....

    • Bonjour,

      Il ne faut pas modifier le nom des fichiers surchargés. Il suffit de les placer dans le même dossier que l’original. Ici : monsquelette/outils/decoupe.css

      Ensuite, il faut recompiler le Couteau suisse en affichant sa page d’admin et vider les caches de SPIP. Attention également à la compression JS et CSS et le cache client qui peuvent parfois masquer la modification d’un paramètre ou d’un fichier du site...

    • Yessss ! C’était bien ça.... je n’avais pas en tête qu’il fallait repasser par la case « recompilation » pour que ce soit opérationnel... J’ai donc remis sagement le fichier dans/squelettes/outils et ça roule ! Merci beaucoup !

    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