sync with EN

docs/fr/designers/chapter-debugging-console.xml

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+
 <chapter id="chapter.debugging.console">
  <title>Console de d<>bogage</title>
  <para>
@@ -8,31 +9,33 @@
   toutes les templates <link linkend="language.function.include">incluses</link>,
   les variables <link linkend="api.assign">assign<EFBFBD>es</link> et charg<72>es depuis un fichier de
   <link linkend="language.config.variables">configuration</link> pour le template courant.
-  Un template appel<65> "debug.tpl" est inclus dans la distribution de Smarty qui contr<74>le
+  Un template appel<65> <literal>debug.tpl</literal> est inclus dans la distribution de Smarty qui contr<74>le
   le formattage de la console. D<>finissez <link linkend="variable.debugging">$debugging</link>
-  <20> true dans Smarty et, si besoin, vous pouvez d<>finir
+  <20> &true; dans Smarty et, si besoin, vous pouvez d<>finir
-  <link linkend="variable.debug.tpl">$debug_tpl</link> de fa<66>on <20> ce que ce dernier 
+  <link linkend="variable.debug.tpl"><parameter>$debug_tpl</parameter></link>
-  contienne le chemin du template <20> utiliser(dans
+  de fa<66>on <20> ce que ce dernier contienne le chemin du template <20> utiliser(dans
-  <link linkend="constant.smarty.dir">SMARTY_DIR</link> par defaut).
+  <link linkend="constant.smarty.dir"><constant>SMARTY_DIR</constant></link> par defaut).
   Lorsque vous chargez la page, une console javascript est cens<6E>e surgir
   et vous donner les noms de toutes les variables inclues et assign<67>es dans
   votre page courante. Pour voir toutes les variables d'un template particulier,
-  voir la fonction <link linkend="language.function.debug">{debug}</link>.
+  voir la fonction <link linkend="language.function.debug"><varname>{debug}</varname></link>.
   Pour d<>sactiver la console de d<>bogage, d<>finissez 
-  <link linkend="variable.debugging">$debugging</link> <20> false.
+  <link linkend="variable.debugging"><parameter>$debugging</parameter></link> <20> &false;.
   Vous pouvez <20>galement temporairement activer le d<>bogage en indiquant
-  SMARTY_DEBUG dans l'url si tant est que l'option
+  <literal>SMARTY_DEBUG</literal> dans l'url si tant est que l'option
-  <link linkend="variable.debugging.ctrl">$debugging_ctrl</link> soit activ<69>e.
+  <link linkend="variable.debugging.ctrl"><parameter>$debugging_ctrl</parameter></link>
+  soit activ<69>e.
  </para>
   <note>
    <title>Note technique</title>
    <para>
     La console de d<>bogage ne fonctionne pas si vous utilisez l'API
-    <link linkend="api.fetch">fetch()</link>,
+    <link linkend="api.fetch"><varname>fetch()</varname></link>,
-    mais seulement lorsque vous utilisez <link linkend="api.display">display()</link>. 
+    mais seulement lorsque vous utilisez
+    <link linkend="api.display"><varname>display()</varname></link>.
     C'est en effet un jeu d'instructions javascripts <20> la fin du template qui d<>clenchent
     l'ouverture de la fen<65>tre. Si vous n'aimez pas javascript, vous pouvez modifier
-    debug.tpl pour formater les donn<6E>es de la fa<66>on qui vous conviendra le
+    <literal>debug.tpl</literal> pour formater les donn<6E>es de la fa<66>on qui vous conviendra le
     mieux. Les donn<6E>es de d<>bogage ne sont pas mises en cache et les
     informations de debug.tpl ne sont pas incluses dans la sortie de la
     console de d<>bogage.
@@ -47,10 +50,11 @@
   <para>
    Voir aussi
    <link linkend="troubleshooting">troubleshooting</link>,
-   <link linkend="variable.error.reporting">$error_reporting</link>
+   <link linkend="variable.error.reporting"><parameter>$error_reporting</parameter></link>
-   et <link linkend="api.trigger.error">trigger_error()</link>.
+   et <link linkend="api.trigger.error"><varname>trigger_error()</varname></link>.
    </para>
  </chapter>
+
  <!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml

docs/fr/designers/config-files.xml

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+
 <chapter id="config.files">
  <title>Fichiers de configuration</title>
  <para>
@@ -63,13 +64,13 @@ pass=foobar
   section, la variable de section est prioritaire.
   Si vous appelez deux variables dans une m<>me section de la m<>me fa<66>on,
   la derni<6E>re d<>clar<61>e prime. (voir
-  <link linkend="variable.config.overwrite">$config_overwrite</link>)
+  <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>)
  </para>
  <para>
   Les fichiers de configuration sont charg<72>s dans le template gr<67>ce aux
   fonctions <link
-  linkend="language.function.config.load"><command>{config_load}</command></link>
+  linkend="language.function.config.load"><varname>{config_load}</varname></link>
-  (voir aussi <link linkend="api.config.load"><command>config_load()</command></link>).
+  (voir aussi <link linkend="api.config.load"><varname>config_load()</varname></link>).
  </para>
  <para>
   Vous pouvez masquer des variables ou des sections enti<74>res en pr<70>fixant
@@ -82,11 +83,11 @@ pass=foobar
  </para>
  <para>
   Voir aussi
-  <link linkend="language.function.config.load">{config_load}</link>,
+  <link linkend="language.function.config.load"><varname>{config_load}</varname></link>,
-  <link linkend="variable.config.overwrite">$config_overwrite</link>,
+  <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>,
-  <link linkend="api.get.config.vars">get_config_vars()</link>,
+  <link linkend="api.get.config.vars"><varname>get_config_vars()</varname></link>,
-  <link linkend="api.clear.config">clear_config()</link> et
+  <link linkend="api.clear.config"><varname>clear_config()</varname></link> et
-  <link linkend="api.config.load">config_load()</link>.
+  <link linkend="api.config.load"><varname>config_load()</varname></link>.
  </para>
 </chapter>
 

docs/fr/designers/language-builtin-functions.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
 
 <chapter id="language.builtin.functions">
  <title>Fonctions natives</title>
@@ -14,10 +14,10 @@
  </para>
  <para>
   Quelques-unes de ces fonctions ont un attribut
-  <emphasis role="bold">assign</emphasis> qui r<>cup<75>re le r<>sultat de la
+  <parameter>assign</parameter> qui r<>cup<75>re le r<>sultat de la
   fonction et la place dans une variable nomm<6D>e dans le template plut<75>t que
   de l'afficher.tout comme la fonction
-  <link linkend="language.function.assign">{assign}</link>.
+  <link linkend="language.function.assign"><varname>{assign}</varname></link>.
  </para>
 
  &designers.language-builtin-functions.language-function-capture;

docs/fr/designers/language-modifiers.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.23 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.25 Maintainer: gerald Status: ready -->
 
 <chapter id="language.modifiers">
  <title>Modificateurs de variables</title>
@@ -14,8 +14,9 @@
   est succeptible d'accepter des param<61>tres additionnels, qui en affectent
   le comportement. Ces param<61>tres suivent le nom du modificateur et
   sont s<>par<61>s par un <literal>:</literal> (deux points).
-  De plus, toutes les fonctions PHP peuvent <20>tre utilis<69>es en tant que modifieurs
+  <emphasis>Toutes les fonctions PHP peuvent <20>tre utilis<69>es en tant que modifieurs
-  implicitement.
+   implicitement</emphasis> (plus d'informations ci-dessous) et les modificateurs peuvent
+  <20>tre <link linkend="language.combining.modifiers">combin<EFBFBD>s</link>.
  </para>
  <example>
   <title>Exemple de modificateur</title>
@@ -57,41 +58,64 @@
 ]]>
   </programlisting>
  </example>
+ <itemizedlist>
+ <listitem>
  <para>
   Si vous appliquez un modificateur de variable <20> un tableau plut<75>t qu'<27> une
   variable simple, le modificateur sera appliqu<71> <20> chaque valeur du tableau.
   Si vous souhaitez que le modificateur travaille r<>ellement avec le tableau
   en tant que tel, vous devez pr<70>fixer le nom du modificateur avec un symbole
-  <literal>@</literal> comme ceci: <literal>{$titreArticle|@count}</literal>
+  <literal>@</literal>
-  (Affiche le nombre d'<27>lements du tableau $titreArticle.)
+  <note>
+   <title>Exemple</title>
+   <para><literal>{$articleTitle|@count}</literal> - affichera le nombre
+    d'<27>l<EFBFBD>ments dans le tableau <parameter>$articleTitle</parameter> en utilisant
+    la fonction PHP <ulink url="&url.php-manual;count"><varname>count()</varname></ulink>
+    comme modificateur.
    </para>
+  </note>
+ </para>
+</listitem>
+
+ <listitem>
   <para>
   Les modificateurs sont charg<72>s automatiquement depuis votre r<>pertoire
-  de plugin <link linkend="variable.plugins.dir">$plugins_dir</link>
+  de plugin <link linkend="variable.plugins.dir"><parameter>$plugins_dir</parameter></link>
-  ou peuvent <20>tre enregistr<74>s explicitement avec <link
+  ou peuvent <20>tre enregistr<74>s explicitement avec
-  linkend="api.register.modifier">register_modifier()</link> ; ceci est utile
+  <link linkend="api.register.modifier"><varname>register_modifier()</varname></link> ;
-  pour partager une fonction dans un scirpt PHP et les templates Smarty.
+  ceci est utile pour partager une fonction dans un scirpt PHP et les templates Smarty.
  </para>
+</listitem>
+
+  <listitem>
  <para>
   Toutes les fonction PHP peuvent <20>tre utilis<69>es comme modificateur,
-  sans autre d<>claration. (L'exemple avec
+  sans autre d<>claration, tel que dans l'exemple ci-dessus.
-  <literal>@count</literal> ci-dessus utilise la fonction count(), et non un modificateur
+  Cepdendant, l'utilisation de fonctions PHP comme modificateurs
-  Smarty. Utiliser des fonctions PHP en tant que modificateur comporte deux 
+  contient deux petits pi<70>ges <20> <20>viter :
-  risques: Premi<6D>rement: il arrive que l'ordre des param<61>tres ne soit pas
+  <itemizedlist>
-  celui attendu (<literal>{"%2.f"|sprintf:$float}</literal> fonctionne,
+   <listitem><para>Le premier - quelques fois, l'ordre des param<61>tres de la fonction
-  mais demande une syntaxe plus naturelle, par exemple<literal>{$float|string_format:"%2.f"}</literal>
+     n'est pas celui attendu. Le formattage de <literal>$foo</literal>  avec
-  fourni dans la distribution Smarty). Deuxi<78>mement : lorsque <link
+     <literal>{"%2.f"|sprintf:$foo}</literal> fonctionne actuellement, mais
-  linkend="variable.security">$security</link> est activ<69>, les fonctions PHP
+     n'est pas aussi intuitif que
-  utilis<EFBFBD>es en tant que modificateur doivent <20>tre explicitement d<>clar<61>es 
+     <literal>{$foo|string_format:"%2.f"}</literal>, ce qui est fournit par Smarty.
-  comme connues dans le tableau <link linkend="variable.security.settings">
+    </para></listitem>
-  $security_settings['MODIFIER_FUNCS']</link>.
+   <listitem><para>
- </para>
+     Le deuxi<78>me - Si <link linkend="variable.security">
+      <parameter>$security</parameter></link> est activ<69>, toutes les fonctions PHP
+     qui devront <20>tre utilis<69>es comme modificateurs, doivent <20>tre d<>clar<61>es dans l'<27>l<EFBFBD>ment
+     <literal>MODIFIER_FUNCS</literal> du tableau
+     <link linkend="variable.security.settings">
+      <parameter>$security_settings</parameter></link>.
+    </para></listitem>
+  </itemizedlist>
+ </para></listitem>
+  </itemizedlist>
  <para>
   Voir aussi
-  <link linkend="api.register.modifier">register_modifier()</link>,
+  <link linkend="api.register.modifier"><varname>register_modifier()</varname></link>,
-  <link linkend="api.register.function">register_function()</link>,
+  <link linkend="language.combining.modifiers">les modificateurs combin<69>s</link>.
-  <link linkend="plugins"><EFBFBD>tendre Smarty avec des plugins</link>
+  et <link linkend="plugins"><EFBFBD>tendre Smarty avec des plugins</link>.
-  et <link linkend="plugins.modifiers">les modifieurs</link>.
  </para>
 
  &designers.language-modifiers.language-modifier-capitalize;

docs/fr/designers/language-variables.xml

@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+
 <chapter id="language.variables">
  <title>Variables</title>
  <para>
@@ -15,7 +16,9 @@
   conditionnelles, etc.
   Pour afficher une variable, il suffit de l'entourer par des
   <link linkend="variable.left.delimiter">d<EFBFBD>limiteurs</link> de
-  telle sorte qu'elle soit la seule chose qu'ils contiennent. Exemple :
+  telle sorte qu'elle soit la seule chose qu'ils contiennent.
+  <example>
+   <title>Exemple de variables</title>
   <programlisting>
 <![CDATA[
 {$Nom}
@@ -25,6 +28,14 @@
 <body bgcolor="{#bgcolor#}">
 ]]>
 </programlisting>
+</example>
+<note>
+ <title>Astuce</title>
+ <para>La fa<66>on de la simple d'analyser les variables Smarty est
+  d'utiliser la
+  <link linkend="chapter.debugging.console">console de d<>bogage</link>.
+ </para>
+</note>
  </para>
 
  &designers.language-variables.language-assigned-variables;