Présentation
Cet outil est une fonctionnalité du plugin Le Couteau Suisse que vous pouvez trouver ici : Le Couteau Suisse.
Pour avoir accès au paramétrage de la balise #INTRODUCTION, il vous faut donc avoir préalablement installé ce plugin, puis activé l’outil « Balise #INTRODUCTION » sur la page d’administration du plugin en espace privé.
La balise #INTRODUCTION proposée par SPIP et placée dans les squelettes, sert en général à la une d’un site ou dans les rubriques, à produire un résumé des articles, des brèves, etc.. La mise en forme du texte original est supprimée et seul un contenu tronqué apparait, invitant le lecteur à aller plus loin.
Exemple d’utilisation à l’intérieur d’une boucle SPIP :
[<div class="intro">(#INTRODUCTION)</div>]
Dans le cas très précis des articles, cette balise renvoie le descriptif intégral, s’il existe. Sinon, elle renvoie un nombre limité de caractères du corps de l’article précédé du chapô. Si ce texte doit être coupé, alors est ajoutée une chaine de caractères spéciale (appelée « points de suite ») indiquant au lecteur que le résumé produit est un texte tronqué...
Il est aussi possible de sélectionner une partie du texte pour qu’il soit pris en compte dans l’introduction grâce aux balises SPIP <intro></intro>. Tapez par exemple :
La balise #INTRODUCTION placée dans votre squelette donnera alors :
Options
- Longueur du résumé
Vous pouvez préciser (en pourcentage par rapport à la valeur utilisée par défaut) la longueur du texte renvoyé par balise #INTRODUCTION. Une valeur nulle ou égale à 100 ne modifie pas l’aspect de l’introduction et utilise donc les valeurs par défaut suivantes : 500 caractères pour les articles, 300 pour les brèves et 600 pour les forums ou les rubriques.
- Points de suite
Par défaut, les points de suite ajoutés au résultat de la balise #INTRODUCTION si le texte est trop long sont [1] : « (...) ». Vous pouvez grâce au Couteau Suisse préciser votre propre chaîne de caratère, celle qui indique au lecteur que le texte tronqué a bien une suite.
- Points de suite cliquables
Le Couteau Suisse peut fabriquer un lien hypertexte sur les points de suite définis ci-dessus afin de mener le lecteur vers le texte original. Exemple pour un article : « Lire la suite de l’article… ». Si vous désirez un saut de ligne, ajoutez le raccourci SPIP adéquat (tiret bas suivi d’un espace) : « _ Lire la suite de l’article… ».
Taille fixe
Afin de préciser une taille particulière à un résumé, la balise #INTRODUCTION reconnait un paramètre numérique qui fixera le nombre caractère à conserver, tout en ignorant le réglage général expliqué ci-dessus : ’Longueur du résumé’.
Attention : dans le cas des articles, le descriptif pourra lui aussi être tronqué.
L’exemple suivant affichera dans tous les cas un résumé de 100 caractères maximum : [(#INTRODUCTION{100})].
Fonctionnement
Le fichier actif de l’outil « Balise #INTRODUCTION » est : introduction_fonctions.php. Lorsque l’outil est activé, ce fichier est inclus par SPIP au même titre que n’importe quel fichier mes_fonctions.php.
Le principe est ici de surcharger la balise #INTRODUCTION prévue par SPIP grâce à la fonction balise_INTRODUCTION(), ce qui permet de gérer un rendu personnalisé du résumé renvoyé par la balise. Pour rappel, les textes concernés ici sont : les articles, les brèves, les messages de forum et les rubriques.
Attention : Avant d’activer cette fonctionnalité, vérifiez bien qu’aucune fonction balise_INTRODUCTION() n’existe déjà dans votre squelette ou vos plugins, la surcharge, qui ne peut avoir lieu qu’une seule fois, produirait alors une erreur d’exécution. Mais rassurez-vous, ce cas est quand même très rare.
Vos commentaires
# Le 10 août 2010 à 16:48, par danslefutur
En réponse à : Réglages pour la balise #INTRODUCTION
Peut-on inclure la première image de notre article avec la balise Introduction à la taille que l’on souhaite. Si oui, comment ? Merci
Répondre à ce message
# Le 13 juin 2010 à 23:18, par DD
En réponse à : Réglages pour la balise #INTRODUCTION
Bonjour,
Comment peut-on faire pour avoir les points suite présents même s’il n’y a pas de texte car dans une page rubrique par exemple on finit par avoir des articles avec « lire la suite » et d’autres sans ces points suite (quand il n’y a que des documents dans l’article par exemple).
Et ce n’est pas très compréhensible pour l’internaute d’avoir des liens seulement pour certains articles.
merci
dd
Répondre à ce message
# Le 12 septembre 2009 à 20:56, par M. Zune
En réponse à : Réglages pour la balise #INTRODUCTION
Parfait, c’est réglé avec la mise-à-jour. Gd merci !
MZ
Répondre à ce message
# Le 8 septembre 2009 à 22:00, par M. Zune
En réponse à : Réglages pour la balise #INTRODUCTION
Bonjour,
J’ai le même problème. J’ai installé un spip 2.0.9, installé le plugin Couteau Suisse et activé l’outil « Balises, filtres, critères », et rien d’autre (pas Crayons donc), et je dois recalculer deux fois pour que le texte d’introduction s’affiche sur la page d’accueil. Je suis sous Firefox 3.5.2.
Le site est http://sites.uclouvain.be/libre
Une piste ?
# Le 12 septembre 2009 à 06:12, par Patrice Vanneufville
En réponse à : Réglages pour la balise #INTRODUCTION
Bonjour.
Ceci devrait être corrigé avec la version 1.8.09.08 du plugin.
Merci du retour de test ;-)
Répondre à ce message
# Le 28 juillet 2009 à 18:07, par Mickaël
En réponse à : Réglages pour la balise #INTRODUCTION
Bonjour à tous
Je me sers de la balise #INTRODUCTION pour mon site (http://www.villagesdeville.com), mais j’ai un problème, c’est que ces intros disparaissent de la page d’accueil, apparemment mises en cache...
Comment empêcher ça ? J’avoue, je suis un peu perdu
Je suis sous SPIP 2.0.3, squelette Morning After...
Merci d’avance pour vos réponses !
# Le 23 août 2009 à 23:16, par Patrice Vanneufville
En réponse à : Réglages pour la balise #INTRODUCTION
Salut, as-tu toujours ce problème ? Avec la toute dernière version du plugin ? As-tu essayé de désactiver les autres plugins un par un pour trouver un conflit éventuel ?
# Le 1er septembre 2009 à 09:22, par ?
En réponse à : Réglages pour la balise #INTRODUCTION
Bonjour.
J’ai le même probleme avec spip 2.0.8 et 2.0.9 et le derniere version, et j’ai vu que c’est un probleme avec crayons. Quand on desactive crayons la balise #INTRODUCTION va bien.
Salut.
# Le 2 septembre 2009 à 17:26, par Patrice Vanneufville
En réponse à : Réglages pour la balise #INTRODUCTION
Ca doit se passer uniquement quand on est loggué alors... Ca le fait avec tous les navigateurs ?
# Le 12 septembre 2009 à 06:06, par Patrice Vanneufville
En réponse à : Réglages pour la balise #INTRODUCTION
Ceci devrait être corrigé avec la version 1.8.09.08 du plugin. Merci du retour de test ;-)
# Le 12 septembre 2009 à 06:08, par Patrice Vanneufville
En réponse à : Réglages pour la balise #INTRODUCTION
Bonjour, ceci devrait être corrigé avec la version 1.8.09.08 du plugin. Merci du retour de test ;-)
Répondre à ce message
# Le 26 juin 2009 à 09:37, par ?
En réponse à : Réglages pour la balise #INTRODUCTION
comment fait -on pour activer la balise #INTRODUCTION ? je voudrais en fait inserer des onglets dans mes aricles avec..... .
merci
Répondre à ce message
# Le 29 mai 2009 à 11:14, par ?
En réponse à : #INTRODUCTION et inclusion d’un doc
Dans le cas de l’inclusion d’un document avec une balise doc dans le corps du texte de l’article, la balise INTRODUCTION affiche le contenu du descriptif donné à docXXX. Peut-on éviter cela ?
Répondre à ce message
# Le 1er décembre 2008 à 15:04, par elektrorl
En réponse à : Le balisage dans #INTRODUCTION
Est-ce normal que le texte retourné par #INTRODUCTION supprime les liens et le formatage (gras et italique part exemple) ? J’ai fouillé dans introduction_fonctions.php mais j’ai pas trouvé mon bonheur. Je comprends le risque d’avoir un lien coupé et du coup, le risque de rendre des liens invalides. Mais j’aimerais tenter le coup.
# Le 1er décembre 2008 à 16:12, par Pat
En réponse à : Le balisage dans #INTRODUCTION
Oui, c’est tout à fait normal. La balise originale de SPIP fait de même. Couper un texte est une opération délicate : il ne faut pas couper n’importe où. L’introduction est là pour donner une idée du contenu, pas pour faire de la mise en forme. Elle doit simplement inviter le visiter à lire l’article...
# Le 1er décembre 2008 à 17:33, par elektrorl
En réponse à : Le balisage dans #INTRODUCTION
C’est ce que je pensais mais que me conseillez-vous alors ? Utiliser #CHAPO sinon #TEXTE, c’est pour le sommaire ou la page rubrique. J’ai besoin que tout le formatage soit apparent.
Répondre à ce message
# Le 15 mars 2008 à 13:10, par Rainer
En réponse à : Lienss clickable pour descriptif résumé
Bonjour,
est-ce qu’il serait possible de prévoir que le lien clickable ne se crée pas seulement quand un résume du texte soit crée, mais aussi quand on résume le déscriptif.
Ceci pour le cas ou on veut pouvoir influencer l’affichage du résume tout en permettant de maintenir toujours la même taille, si on utilise p.ex style :
[(#INTRODUCTION|couper {400})]Merci Rainer
# Le 16 mars 2008 à 00:48, par Patrice Vanneufville
En réponse à : Lienss clickable pour descriptif résumé
euh, tu pourrais expliciter/reformuler ?
# Le 17 mars 2008 à 09:24, par Rainer
En réponse à : Liens pour descriptif résumé
Pardon,
en fait, si j’ai bien compris cette lame du couteau peut-être configuré de manière que à la fin du résumé du texte le (...) soit convertit en lien vers l’article correspondant.
Cela ne semble uniquement fonctionner si la balise INTRODUCTION récupère l’information du texte de l’article en question mais ne fonctionne pas si le champ descriptif contient du contenu et que la balise INTRODUCTION récupère donc le contenu de ce dernier.
Il me semble également que le lien ne soit pas crée si on utilise le filtre
[(#INTRODUCTION|couper{300})]En plus il serait chouette si cette fonctionnalité soit applicable également aux auteurs, sites et rubrique.
C’est que cette lame me semble très utile, Merci
Rainer
# Le 17 mars 2008 à 21:01, par Patrice Vanneufville
En réponse à : Liens pour descriptif résumé
Actuellement, oui. Le descriptif, s’il existe, n’est jamais tronqué, en effet...
Si tu tronques la balise #INTRODUCTION à 300 caractères, tu as peu de chances d’accéder au lien de suite, c’est normal. Le filtre |couper ne doit pas être utilisé dans le cadre du Couteau Suisse : il faut régler la longueur du résumé sur la page de config.
Il n’y a pas de champ ’texte’ pour les auteurs et les sites. En revanche, les rubriques sont déjà prises en charge par la balise.
# Le 18 mars 2008 à 09:35, par ?
En réponse à : Liens pour descriptif résumé
Ok, merci, et c’est vrai, ça marche déjà pour les rubriques.
Je sais que le plugin permet de fixer la taille du résumé, mon problème c’est qu’il le fait pour tout le site de la même manière et que article et rubriques sont résumé de manière différente (au niveau de la taille) alors qu’il me faudrait des résumes de même taille pour ma page principale et cela indépendant si l’origine est un rubrique ou un article, puis j’ai besoin d’autres résumes de plus petites tailles et évidemment j’aimerais partout incluir un lien (...).
Merci en tout cas.
Rainer
# Le 18 mars 2008 à 17:27, par Patrice Vanneufville
En réponse à : Liens pour descriptif résumé
Je vois ce que tu veux dire. Le zip de 18 heure intègre un paramètre de taille pour la balise #INTRODUCTION. Exemple :
[(#INTRODUCTION{100})].# Le 18 mars 2008 à 23:27, par Patrice Vanneufville
En réponse à : Liens pour descriptif résumé
Je viens de modifier la doc afin de prendre en compte cette discussion — que j’ai mis le temps à comprendre ^^.
# Le 19 mars 2008 à 10:44, par Rainer
En réponse à : Liens pour descriptif résumé
Super, merci, faudrait que j’apprenne à m’exprimer mieux
# Le 3 juillet 2008 à 13:33, par Paulo
En réponse à : Liens pour descriptif résumé
Bonjour
Il est utile de préciser que ce paramètre de taille permet non seulement de raccourcir [(#INTRODUCTION100)] mais aussi d’allonger la taille du texte à afficher. Ainsi : [(#INTRODUCTION800)] (si l’on veut afficher une plus grande longueur de texte, dans le sommaire du site, par exemple).
Merci en tout cas pour ces contributions utilissimes.
Répondre à ce message
# Le 27 mai 2008 à 23:27, par dd
En réponse à : Réglages pour la balise #INTRODUCTION [lien_inctroduction ?] ?
Bonjour,
J’obtiens une mention bizarre « [lien_inctroduction ?] » dans la boite « Points de suite cliquables : » lorsque j’active cette balise et je ne peux pas la modifier ??!!
Sinon le couteau suisse c’est trop fort !
merci
dd
# Le 27 mai 2008 à 23:40, par Pat
En réponse à : Réglages pour la balise #INTRODUCTION [lien_inctroduction ?] ?
t’es sûr d’avoir mis à jour ton plugin !?
Répondre à ce message