mirror of
https://gitlab.easter-eggs.com/ee/ldapsaisie.git
synced 2024-12-23 17:03:47 +01:00
57 lines
2.7 KiB
Text
57 lines
2.7 KiB
Text
<sect2 id='config-LSformat'>
|
|
<title>Format paramétrable</title>
|
|
<para>Un <emphasis>format paramétrable</emphasis> est une chaîne de caractères
|
|
contenant des mots clés formés comme dans l'exemple suivant :
|
|
<programlisting linenumbering="unnumbered">%{[nom du mot clé][:A][:B][! ou _][~][%]}</programlisting>
|
|
Le nom du mot clé peut contenir des lettres de "a" à "z", de "A" à "Z" et des
|
|
chiffres de 0 à 9. Ces mots clés seront remplacés par les valeurs passées en
|
|
paramètres et liées au contexte d'utilisation. Les paramètres <emphasis>:A</emphasis> et
|
|
<emphasis>:B</emphasis> permettent d'extraire une partie de la chaîne complète
|
|
avant la substitution.</para>
|
|
|
|
<para>Le paramètre <varname>A</varname> correspond, lorsque
|
|
<varname>B</varname> n'est pas défini, au nombre maximum de caractères à
|
|
extraire de la chaîne de substitution. <emphasis>A</emphasis> doit être un entier
|
|
dont le signe influ, comme expliqué ci-dessous :
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>Si <varname>A</varname> est positif, les <varname>A</varname>
|
|
premiers caractères de la chaîne de substitution seront extraits.</simpara>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<simpara>Si <varname>A</varname> est négatif, les <varname>|A|</varname>
|
|
derniers caractères de la chaîne de substitution seront extraits.</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
Lorsque le paramètre <varname>B</varname> est défini,
|
|
<varname>A</varname> correspond au rang du premier caractère à partir duquel la
|
|
chaîne de substitution sera découpée et <varname>B</varname> le nombre maximum
|
|
de caractères à extraire. Le signe de <varname>B</varname> influera comme expliqué
|
|
dans le premier cas. Si <varname>B</varname> vaut zéro, la totalité de la longeur
|
|
de la chaîne sera retournée en tenant compte de <varname>A</varname> pour le rang
|
|
du premier caractère.
|
|
</para>
|
|
<para>Il existe par ailleurs des paramètres permettant de modifier la valeur de
|
|
substitution avant son utilisation :
|
|
<itemizedlist>
|
|
<listitem>
|
|
<simpara>Les paramètres <emphasis>!</emphasis> ou <emphasis>_</emphasis> permettre
|
|
respectivement de forcer la mise en majuscule ou en minuscule ;</simpara>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<simpara>Le paramètre <emphasis>~</emphasis> permet de forcer la suppression des
|
|
accents ;</simpara>
|
|
</listitem>
|
|
|
|
<listitem><simpara>Le paramètre <emphasis>%</emphasis> permet de protéger les
|
|
caractères éligibles en entités HTML.</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</para>
|
|
|
|
<important><simpara>Lorsque qu'une seule valeur clé est disponible pour la
|
|
substitution, le nom du mot clé n'importe pas. Tous les mots clés trouvés dans
|
|
le format seront remplacés par cette seule valeur.</simpara></important>
|
|
</sect2>
|