Carnet Wiki

Mémo : les filtres de texte

Version 2 — Novembre 2014 tcharlss

On a parfois besoin Les balises de formatages spécifiques pour les balises produisant du texte (#TEXTE, #DESCRIPTIF,

#CHAPO</code >  #CHAPO  etc.), qu'on obtient au moyen de filtres.
) produisent du texte au format HTML, avec ses tags, ses paragraphes encapsulés dans des <code><p>

, etc.
Dans certaines situations, on a besoin de formatages différents, que l’on obtient en appliquant des filtres. La documentation présente tous les L’ensemble des filtres [dans une seule liste -> http://www [sont documentés->http://www .spip.net/fr_rubrique567.html], mais par commodité sont regroupés dans cet article , les filtres portant sur le textesont récapitulés ici .

Les filtres de texte
Filtre Ça fait quoi ? Mais encore ? J’utilise ça où ? Rendu Balise avant Rendu Balise après
texte backend Formate le texte pour les flux XML. Traduit dans un format compatible avec les flux XML. S’utilise dans Dans les squelettes des flux RSS.  : <title>[(#NOM_SITE_SPIP|texte_backend)]</title>&lt;/code > | <code><p><strong>William Shakespeare</strong> naquit à Stratford-sur-Avon</p> <p><strong>William Shakespeare</strong> naquit à Stratford-sur-Avon </p>
attribut_html Formate le texte pour les attributs Traduit dans un format utilisable sans dommage dans un attribut HTML. S’utilise typiquement Typiquement , dans lesattributs <title>, <alt>, etc. Ex.  : &#91;&lt;img alt="(#TITRE|attribut_html)" src="image.jpg">]&lt;/code > | <code>2 est "supérieur" à 1 2 est "supérieur" à 1
texte_script Formate le texte pour les scripts PHP et JS .  :
&#91;&lt;meta  name="description "  content="(#DESCRIPTIF|textebrut )">] | Traduit dans un format utilisable en toute sécurité dans un {{script PHP ou Javascript}}. | Dans les fichiers PHP ou Javascript. |  Dans les squelettes, seules les apostrophes seront échapées. )  | avant | après |
| &#91;safehtml->http://www &#91;PtoBR->http://www .spip.net/fr_article4310.html] | Echappe le {{code PHP et JS}} | A  utiliser  pour  sécuriser  Avec  les textes issus de l'extérieur (forums, syndications...)  | exemple  avant | exemple  après |
| &#91;textebrut->http://www.spip.net/fr_article4317.html] | Remplace les tags <code><p>

et <br /> par de simple retours retour à la ligne.

S’utilise dans Dans les tags <meta>. Ex. . avant après
[supprimer_tags->http://www.spip.net/fr_article4315.html] Supprime tous les tags HTML tout en conservant le contenu de ces même tags. ... Ex . Dans les squelettes « normaux », quand on veut du texte « pur ». <p><strong>William Shakespeare</strong> naquit à <em>Stratford-sur-Avon</em></p>
William  Shakespeare  William  Shakespeare&lt;/strong >  naquit à Stratford-sur-Avon&lt;/code >  Stratford-sur-Avon |
| &#91;PtoBR->http://www   &#91;safehtml->http://www .spip.net/fr_article4308.html] | Transforme les sauts de paragraphe en simples retours à la ligne | Permet de «resserer» une mise en page | <code><p><strong>William Shakespeare :</strong></p><p style="color:navy;">né à Stratford-sur-Avon </p>
William William Shakespeare :
né à Stratford-sur-Avon</code > Stratford-sur-Avon
lignes_longues Introduit des césures dans les mots « trop longs » ... avant après
liens_absolus Transforme transforme tous les liens (href, src) en liens absolus ... avant après
[liens_ouvrants->http://www.spip.net/fr_article4126.html] ... ... avant après