sync with EN

2025-08-06 03:14:27 +02:00 · 2006-09-30 09:12:55 +00:00
parent e6183de5ea
commit 79bca03392
5 changed files with 102 additions and 62 deletions
--- a/docs/fr/designers/chapter-debugging-console.xml
+++ b/docs/fr/designers/chapter-debugging-console.xml
@@ -1,38 +1,41 @@
 <?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>
  Il existe une console de d<>bogage dans Smarty. La console vous indique
-  toutes les templates <link linkend="language.function.include">incluses</link>, 
+  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
-  le formattage de la console.D<>finissez <link linkend="variable.debugging">$debugging</link>
-  <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 
-  contienne le chemin du template <20> utiliser(dans
-  <link linkend="constant.smarty.dir">SMARTY_DIR</link> par defaut).
+  <link linkend="language.config.variables">configuration</link> pour le template courant.
+  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<EFBFBD>finissez <link linkend="variable.debugging">$debugging</link>
+  <20> &true; dans Smarty et, si besoin, vous pouvez d<>finir
+  <link linkend="variable.debug.tpl"><parameter>$debug_tpl</parameter></link>
+  de fa<66>on <20> ce que ce dernier contienne le chemin du template <20> utiliser(dans
+  <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
-  <link linkend="variable.debugging.ctrl">$debugging_ctrl</link> soit activ<69>e.
+  <literal>SMARTY_DEBUG</literal> dans l'url si tant est que l'option
+  <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>,
-    mais seulement lorsque vous utilisez <link linkend="api.display">display()</link>. 
-    C'est en effet un jeu d'instructions javascripts <20> la fin du template qui d<>clenchent 
+    La console de d<>bogage ne fonctionne pas si vous utilisez l'API
+    <link linkend="api.fetch"><varname>fetch()</varname></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>
-   et <link linkend="api.trigger.error">trigger_error()</link>.
+   <link linkend="variable.error.reporting"><parameter>$error_reporting</parameter></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
--- a/docs/fr/designers/config-files.xml
+++ b/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>
-  (voir aussi <link linkend="api.config.load"><command>config_load()</command></link>).
+  linkend="language.function.config.load"><varname>{config_load}</varname></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="variable.config.overwrite">$config_overwrite</link>,
-  <link linkend="api.get.config.vars">get_config_vars()</link>,
-  <link linkend="api.clear.config">clear_config()</link> et
-  <link linkend="api.config.load">config_load()</link>.
+  <link linkend="language.function.config.load"><varname>{config_load}</varname></link>,
+  <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>,
+  <link linkend="api.get.config.vars"><varname>get_config_vars()</varname></link>,
+  <link linkend="api.clear.config"><varname>clear_config()</varname></link> et
+  <link linkend="api.config.load"><varname>config_load()</varname></link>.
 </para>
 </chapter>

--- a/docs/fr/designers/language-builtin-functions.xml
+++ b/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;
--- a/docs/fr/designers/language-modifiers.xml
+++ b/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
-  implicitement.
+  <emphasis>Toutes les fonctions PHP peuvent <20>tre utilis<69>es en tant que modifieurs
+   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>
-  (Affiche le nombre d'<27>lements du tableau $titreArticle.)
+  <literal>@</literal>
+  <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>
-  ou peuvent <20>tre enregistr<74>s explicitement avec <link
-  linkend="api.register.modifier">register_modifier()</link> ; ceci est utile
-  pour partager une fonction dans un scirpt PHP et les templates Smarty.
+  de plugin <link linkend="variable.plugins.dir"><parameter>$plugins_dir</parameter></link>
+  ou peuvent <20>tre enregistr<74>s explicitement avec
+  <link linkend="api.register.modifier"><varname>register_modifier()</varname></link> ;
+  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
-  <literal>@count</literal> ci-dessus utilise la fonction count(), et non un modificateur
-  Smarty. Utiliser des fonctions PHP en tant que modificateur comporte deux 
-  risques: Premi<6D>rement: il arrive que l'ordre des param<61>tres ne soit pas
-  celui attendu (<literal>{"%2.f"|sprintf:$float}</literal> fonctionne,
-  mais demande une syntaxe plus naturelle, par exemple<literal>{$float|string_format:"%2.f"}</literal>
-  fourni dans la distribution Smarty). Deuxi<78>mement : lorsque <link
-  linkend="variable.security">$security</link> est activ<69>, les fonctions PHP
-  utilis<EFBFBD>es en tant que modificateur doivent <20>tre explicitement d<>clar<61>es 
-  comme connues dans le tableau <link linkend="variable.security.settings">
-  $security_settings['MODIFIER_FUNCS']</link>.
- </para>
+  sans autre d<>claration, tel que dans l'exemple ci-dessus.
+  Cepdendant, l'utilisation de fonctions PHP comme modificateurs
+  contient deux petits pi<70>ges <20> <20>viter :
+  <itemizedlist>
+   <listitem><para>Le premier - quelques fois, l'ordre des param<61>tres de la fonction
+     n'est pas celui attendu. Le formattage de <literal>$foo</literal>  avec
+     <literal>{"%2.f"|sprintf:$foo}</literal> fonctionne actuellement, mais
+     n'est pas aussi intuitif que
+     <literal>{$foo|string_format:"%2.f"}</literal>, ce qui est fournit par Smarty.
+    </para></listitem>
+   <listitem><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.function">register_function()</link>,
-  <link linkend="plugins"><EFBFBD>tendre Smarty avec des plugins</link>
-  et <link linkend="plugins.modifiers">les modifieurs</link>.
+  <link linkend="api.register.modifier"><varname>register_modifier()</varname></link>,
+  <link linkend="language.combining.modifiers">les modificateurs combin<69>s</link>.
+  et <link linkend="plugins"><EFBFBD>tendre Smarty avec des plugins</link>.
 </para>

 &designers.language-modifiers.language-modifier-capitalize;
--- a/docs/fr/designers/language-variables.xml
+++ b/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}
@@ -24,13 +27,21 @@

 <body bgcolor="{#bgcolor#}">
 ]]>
-  </programlisting>
+</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;
 &designers.language-variables.language-config-variables;
 &designers.language-variables.language-variables-smarty;
- 
+
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables: