Os filtros de texto

Esta tabela resume os filtros que modificam as tags que produzem código HTML, o que elas fazem e em que casos as usar.

Os filtros de texto
Filtro Efeito e utilidade Texto à entrada / texto à saída
textebrut Substitui os <p>, <br> e as quebras de linha duplas por quebras de linha simples; os espaços inquebráveis e os espaços duplos por espaços simples.

Usa-se para inserir o texto nas tags <meta>, e outras tags HTML.		 
<p>William Shakespeare:</p><p>nascido em Stratford-sur-Avon</p>

William Shakespeare:
nascido em Stratford-sur-Avon
texte_backend Formata o texto para os fluxos XML.

Particularmente útil nos templates de feed RSS.		 
<p><strong>William Shakespeare</strong> nascido em Stratford-sur-Avon</p>
&lt;p&gt;&lt;strong&gt;William Shakespeare&lt;/strong&gt; nascido em Stratford-sur-Avon &lt;/p&gt;
attribut_html Formata o texto para os atributos HTML.

Usa-se tipicamente nos atributos <title>, <alt>...		 
2 é "superior" a 1

2 &#233; &quot;superior&quot; a 1
texte_script Formata o texto para os scripts PHP e JS.

Escapa as aspas		 
Bem vindo ao Harry's Bar

Bem vindo ao Harry\'s Bar
safehtml Escapa o código PHP e JS

Usado para garantir a segurança dos textos provenientes de fontes externas (fóruns, sindicações...)		 
<script type="text/javascript">...</script>
<script type="text/javascript">...</script>
supprimer_tags Suprime todas as tags HTML, conservando o conteúdo das mesmas.

Permite obter um texto «puro e simples»		 
<p><strong>William Shakespeare</strong> nasceu em <em>Stratford-sur-Avon</em></p>

William Shakespeare nasceu em Stratford-sur-Avon
charset2unicode Converte em entidades unicode &#129;.

A vantagem deste filtro é que ele não afeta as tags HTML.		 
2 é "superior" a 1

2 &#233; "superior" a 1
echapper_tags Converte os parênteses angulares de tag <...> em entidades HTML.

Útil para texto entre tags <pre>.		 
<p><strong>William Shakespeare</strong> nasceu em Stratford-sur-Avon</p>

&lt;p&gt;&lt;strong&gt;William Shakespeare&lt;/strong&gt; nasceu em Stratford-sur-Avon&lt;/p&gt;
PtoBR Converte as quebras de parágrafo <p> em quebras de linha <br>.

Permite «compactar» o layout.		 
<p><strong>William Shakespeare :</strong></p><p style="color:navy;">nasceu em Stratford-sur-Avon </p>

<strong>William Shakespeare :</strong><br>nasceu em Stratford-sur-Avon
liens_absolus Transforma todos os links (<a href=..., <link href:..., <img src=... e <script src=...) em links absolutos.

Particularmente útil nos templates de fluxo RSS.		 
<img src="IMG/arton01.jpg">

<img src="http://o_site.pt/IMG/arton01.jpg">
liens_ouvrants Altera os links do SPIP que remetem a sites externos de modo a que se abram numa nova janela ou separador. 
<a href="http://www.spip.net/pagina.html">

<a href="http://www.spip.net/pagina.html" target="_blank">

É importante notar que o filtro lignes_longues ainda pode ser usado, mas está obsoleto. É preferível quebrar linhas longas usando propriedades CSS, como word-wrap

lignes_longues Insere quebras nas palávras «muito longas». 
http://www.spip.net/spip.php?page=recherche&recherche=linhas_longas

http://www.spip.net
/spip.
php?page=recherche
&recherche=linhas_longas

Ver igualmente a lista completa de todos os filtros: Les filtres de SPIP

Autor Ricardo Porto Publié le :

Traductions : English, français, Nederlands, Português