cvs: smarty /docs/fr/designers chapter-debugging-console.xml config-files.xml language-builtin-functions.xml language-modifiers.xml language-variables.xml
[email protected] ("Yannick Torres") Sat, 30 Sep 2006 09:12:56 -0000
| Newsgroups | php.smarty.cvs |
|---|---|
| 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
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: