1
0
Fork 0
mirror of https://gitlab.easter-eggs.com/ee/ldapsaisie.git synced 2024-12-24 09:23:47 +01:00
ldapsaisie/doc/conf/LSformat.docbook
2018-09-20 19:28:26 +02:00

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&nbsp;:
<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&nbsp;:
<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>