Files
smarty/docs/fr/designers/language-custom-functions/language-function-textformat.xml
2004-07-02 21:39:32 +00:00

262 lines
5.8 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: gerald Status: ready -->
<sect1 id="language.function.textformat">
<title>textformat</title>
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
<colspec colname="type" align="center" />
<colspec colname="required" align="center" />
<colspec colname="default" align="center" />
<colspec colname="desc" />
<thead>
<row>
<entry>Nom attribut</entry>
<entry>Type</entry>
<entry>Requis</entry>
<entry>Defaut</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry>style</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>style prédéfini</entry>
</row>
<row>
<entry>indent</entry>
<entry>number</entry>
<entry>Non</entry>
<entry><emphasis>0</emphasis></entry>
<entry>Taille de l'indentation pour chaque
ligne</entry>
</row>
<row>
<entry>indent_first</entry>
<entry>number</entry>
<entry>Non</entry>
<entry><emphasis>0</emphasis></entry>
<entry>Taille de l'indentation de la
première ligne</entry>
</row>
<row>
<entry>indent_char</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>(single space)</emphasis></entry>
<entry>Le caractère (ou la chaîne) à utiliser pour
indenter</entry>
</row>
<row>
<entry>wrap</entry>
<entry>number</entry>
<entry>Non</entry>
<entry><emphasis>80</emphasis></entry>
<entry>A combien de caractères doit on ajuster chaque
ligne</entry>
</row>
<row>
<entry>wrap_char</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>\n</emphasis></entry>
<entry>Le caractère (ou chaîne de caractères) avec lequel
terminer les lignes</entry>
</row>
<row>
<entry>wrap_cut</entry>
<entry>boolean</entry>
<entry>Non</entry>
<entry><emphasis>false</emphasis></entry>
<entry>Si true, wrap réduira les lignes au caractère exact
au lieu d'ajuster à la fin d'un mot</entry>
</row>
<row>
<entry>assign</entry>
<entry>chaîne de caractères</entry>
<entry>Non</entry>
<entry><emphasis>n/a</emphasis></entry>
<entry>Le nom de la variable PHP dans laquelle la
sortie sera assignée</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>
textformat est une fonction de bloc utilisée pour formater du texte.
Elle nettoie la chaîne de ses espaces et caractères spéciaux, puis
formate les paragraphes en ajustant ces derniers à une certaine limite,
puis en indentant les lignes.
</para>
<para>
Vous pouvez soit utiliser un style prédéfini, soit définir explicitement
chaque attribut. Actuellement, seul le style prédéfini "email" est
disponible.
</para>
<example>
<title>textformat</title>
<programlisting>
{textformat wrap=40}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
SORTIE:
This is foo. This is foo. This is foo.
This is foo. This is foo. This is foo.
This is bar.
bar foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo bar
foo foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo.
{textformat wrap=40 indent=4}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
SORTIE:
This is foo. This is foo. This is
foo. This is foo. This is foo. This
is foo.
This is bar.
bar foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo.
bar foo bar foo foo. bar foo bar
foo foo.
{textformat wrap=40 indent=4 indent_first=4}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
SORTIE:
This is foo. This is foo. This
is foo. This is foo. This is foo.
This is foo.
This is bar.
bar foo bar foo foo. bar foo bar
foo foo. bar foo bar foo foo. bar
foo bar foo foo. bar foo bar foo
foo. bar foo bar foo foo. bar foo
bar foo foo.
{textformat style="email"}
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is foo.
This is bar.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
bar foo bar foo foo.
{/textformat}
SORTIE:
This is foo. This is foo. This is foo. This is foo. This is foo. This is
foo.
This is bar.
bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo
bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo
foo.
</programlisting>
</example>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->