cvs: smarty /docs/fr/designers chapter-debugging-console.xml config-files.xml language-builtin-functions.xml language-modifiers.xml language-variables.xml

"Yannick Torres" <[email protected]> Sat, 30 Sep 2006 09:12:56 -0000
Newsgroups gmane.comp.php.cvs.smarty
Message-ID <cvsyannick1159607576@cvsserver>
yannick		Sat Sep 30 09:12:56 2006 UTC

  Modified files:              
    /smarty/docs/fr/designers	chapter-debugging-console.xml 
                             	config-files.xml 
                             	language-builtin-functions.xml 
                             	language-modifiers.xml 
                             	language-variables.xml 
  Log:
  sync with EN

-- 
Smarty CVS Mailing List (http://cvs.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
yannick-20060930091256.txt (text/plain, 15.8 KB)
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/chapter-debugging-console.xml?r1=1.6&r2=1.7&diff_format=u
Index: smarty/docs/fr/designers/chapter-debugging-console.xml
diff -u smarty/docs/fr/designers/chapter-debugging-console.xml:1.6 smarty/docs/fr/designers/chapter-debugging-console.xml:1.7
--- smarty/docs/fr/designers/chapter-debugging-console.xml:1.6	Tue May 24 20:07:09 2005
+++ smarty/docs/fr/designers/chapter-debugging-console.xml	Sat Sep 30 09:12:55 2006
@@ -1,38 +1,41 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- 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ées</link> et chargées depuis un fichier de
-  <link linkend="language.config.variables">configuration</link> pour le template courant. 
-  Un template appelé "debug.tpl" est inclus dans la distribution de Smarty qui contrôle
-  le formattage de la console.Définissez <link linkend="variable.debugging">$debugging</link>
-  à true dans Smarty et, si besoin, vous pouvez définir
-  <link linkend="variable.debug.tpl">$debug_tpl</link> de façon à ce que ce dernier 
-  contienne le chemin du template à 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é <literal>debug.tpl</literal> est inclus dans la distribution de Smarty qui contrôle
+  le formattage de la console. Définissez <link linkend="variable.debugging">$debugging</link>
+  à &true; dans Smarty et, si besoin, vous pouvez définir
+  <link linkend="variable.debug.tpl"><parameter>$debug_tpl</parameter></link>
+  de façon à ce que ce dernier contienne le chemin du template à utiliser(dans
+  <link linkend="constant.smarty.dir"><constant>SMARTY_DIR</constant></link> par defaut).
   Lorsque vous chargez la page, une console javascript est censée surgir
   et vous donner les noms de toutes les variables inclues et assigné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> à false.
+  <link linkend="variable.debugging"><parameter>$debugging</parameter></link> à &false;.
   Vous pouvez é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é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é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 à 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 à la fin du template qui déclenchent
     l'ouverture de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier
-    debug.tpl pour formater les données de la façon qui vous conviendra le
+    <literal>debug.tpl</literal> pour formater les données de la façon qui vous conviendra le
     mieux. Les donné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
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/config-files.xml?r1=1.8&r2=1.9&diff_format=u
Index: smarty/docs/fr/designers/config-files.xml
diff -u smarty/docs/fr/designers/config-files.xml:1.8 smarty/docs/fr/designers/config-files.xml:1.9
--- smarty/docs/fr/designers/config-files.xml:1.8	Sun Jul 10 19:27:49 2005
+++ smarty/docs/fr/designers/config-files.xml	Sat Sep 30 09:12:55 2006
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+
 <chapter id="config.files">
  <title>Fichiers de configuration</title>
  <para>
@@ -63,13 +64,13 @@
   section, la variable de section est prioritaire.
   Si vous appelez deux variables dans une même section de la même façon,
   la dernière déclaré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és dans le template grâ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ères en préfixant
@@ -82,11 +83,11 @@
  </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>
 
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions.xml?r1=1.7&r2=1.8&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions.xml
diff -u smarty/docs/fr/designers/language-builtin-functions.xml:1.7 smarty/docs/fr/designers/language-builtin-functions.xml:1.8
--- smarty/docs/fr/designers/language-builtin-functions.xml:1.7	Sun Apr  9 21:59:55 2006
+++ smarty/docs/fr/designers/language-builtin-functions.xml	Sat Sep 30 09:12:55 2006
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- 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ère le résultat de la
+  <parameter>assign</parameter> qui récupère le résultat de la
   fonction et la place dans une variable nommée dans le template plutô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;
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-modifiers.xml?r1=1.11&r2=1.12&diff_format=u
Index: smarty/docs/fr/designers/language-modifiers.xml
diff -u smarty/docs/fr/designers/language-modifiers.xml:1.11 smarty/docs/fr/designers/language-modifiers.xml:1.12
--- smarty/docs/fr/designers/language-modifiers.xml:1.11	Sun Apr  9 21:59:55 2006
+++ smarty/docs/fr/designers/language-modifiers.xml	Sat Sep 30 09:12:55 2006
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.23 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.12 $ -->
+<!-- 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ètres additionnels, qui en affectent
   le comportement. Ces paramètres suivent le nom du modificateur et
   sont séparés par un <literal>:</literal> (deux points).
-  De plus, toutes les fonctions PHP peuvent être utilisées en tant que modifieurs
-  implicitement.
+  <emphasis>Toutes les fonctions PHP peuvent être utilisées en tant que modifieurs
+   implicitement</emphasis> (plus d'informations ci-dessous) et les modificateurs peuvent
+  être <link linkend="language.combining.modifiers">combiné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 à un tableau plutôt qu'à une
   variable simple, le modificateur sera appliqué à chaque valeur du tableau.
   Si vous souhaitez que le modificateur travaille réellement avec le tableau
   en tant que tel, vous devez préfixer le nom du modificateur avec un symbole
-  <literal>@</literal> comme ceci: <literal>{$titreArticle|@count}</literal>
-  (Affiche le nombre d'élements du tableau $titreArticle.)
+  <literal>@</literal>
+  <note>
+   <title>Exemple</title>
+   <para><literal>{$articleTitle|@count}</literal> - affichera le nombre
+    d'élé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és automatiquement depuis votre répertoire
-  de plugin <link linkend="variable.plugins.dir">$plugins_dir</link>
-  ou peuvent être enregistré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 être enregistré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 être utilisé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èrement: il arrive que l'ordre des paramè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èmement : lorsque <link
-  linkend="variable.security">$security</link> est activé, les fonctions PHP
-  utilisées en tant que modificateur doivent être explicitement déclaré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èges à éviter :
+  <itemizedlist>
+   <listitem><para>Le premier - quelques fois, l'ordre des paramè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ème - Si <link linkend="variable.security">
+      <parameter>$security</parameter></link> est activé, toutes les fonctions PHP
+     qui devront être utilisées comme modificateurs, doivent être déclarées dans l'élé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">é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és</link>.
+  et <link linkend="plugins">étendre Smarty avec des plugins</link>.
  </para>
 
  &designers.language-modifiers.language-modifier-capitalize;
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-variables.xml?r1=1.6&r2=1.7&diff_format=u
Index: smarty/docs/fr/designers/language-variables.xml
diff -u smarty/docs/fr/designers/language-variables.xml:1.6 smarty/docs/fr/designers/language-variables.xml:1.7
--- smarty/docs/fr/designers/language-variables.xml:1.6	Sun Jul 10 19:27:49 2005
+++ smarty/docs/fr/designers/language-variables.xml	Sat Sep 30 09:12:55 2006
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- 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é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ç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: