Version 1 — Novembre 2014 — tcharlss — Version initiale
#TEXTE, #DESCRIPTIF, #CHAPO etc.) produisent du texte au format HTML, avec ses tags, ses paragraphes encapsulés dans des <p>, etc.
Dans certaines situations, on a besoin de formatages différents, que l’on obtient en appliquant des filtres. L’ensemble des filtres sont documentés, mais par commodité, les filtres portant sur le texte sont récapitulés ici.| Filtre | Ça fait quoi ? | J’utilise ça où ? | Balise avant | Balise après |
|---|---|---|---|---|
| texte backend | Traduit dans un format compatible avec les flux XML. | Dans les squelettes des flux RSS. Ex. : <title>[(#NOM_SITE_SPIP|texte_backend)]</title> |
<p><strong>William Shakespeare</strong> naquit à Stratford-sur-Avon</p> |
<p><strong>William Shakespeare</strong> naquit à Stratford-sur-Avon </p> |
| attribut_html | Traduit dans un format utilisable sans dommage dans un attribut HTML. | Typiquement, dans les attributs <title>, <alt>, etc. Ex. : [<img alt="(#TITRE|attribut_html)" src="image.jpg">] |
2 est "supérieur" à 1 |
2 est "supérieur" à 1 |
| texte_script | 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. | exemple avant | exemple après |
| textebrut | Remplace les tags <p> et <br /> par de simple retour à la ligne. |
Dans les tags <meta>. Ex. : [<meta name="description" content="(#DESCRIPTIF|textebrut)">]. |
avant | après |
| supprimer_tags | Supprime tous les tags HTML tout en conservant le contenu de ces même tags. | Dans les squelettes « normaux », quand on veut du texte « pur ». | <p><strong>William Shakespeare</strong> naquit à <em>Stratford-sur-Avon</em></p> |
William Shakespeare naquit à Stratford-sur-Avon |
| safehtml | Echappe le code PHP et JS | Avec les textes issus de l’extérieur (forums, syndications...) | avant | après |
| PtoBR | Transforme les sauts de paragraphe en simples retours à la ligne | Permet de « resserer » une mise en page | <p><strong>William Shakespeare :</strong></p><p style="color:navy;">né à Stratford-sur-Avon </p> |
William Shakespeare :
né à Stratford-sur-Avon |
| lignes_longues | Introduit des césures dans les mots « trop longs » | ... | avant | après |
| liens_absolus | transforme tous les liens (href, src) en liens absolus | ... | avant | après |