cvs: smarty /docs/fr getting-started.xml language-snippets.ent /docs/fr/appendixes resources.xml tips.xml troubleshooting.xml
[email protected] ("Yannick Torres") Sat, 30 Sep 2006 03:20:52 -0000
| Newsgroups | php.smarty.cvs |
|---|---|
| Message-ID | <cvsyannick1159586452@cvsserver> |
yannick Sat Sep 30 03:20:52 2006 UTC
Modified files:
/smarty/docs/fr/appendixes resources.xml tips.xml
troubleshooting.xml
/smarty/docs/fr getting-started.xml language-snippets.ent
Log:
sync with EN
#Un biberon, un commit ! Merci Ewan ;)
yannick-20060930032052.txt
(text/plain, 36 KB)
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/appendixes/resources.xml?r1=1.4&r2=1.5&diff_format=u
Index: smarty/docs/fr/appendixes/resources.xml
diff -u smarty/docs/fr/appendixes/resources.xml:1.4 smarty/docs/fr/appendixes/resources.xml:1.5
--- smarty/docs/fr/appendixes/resources.xml:1.4 Tue Dec 21 20:31:41 2004
+++ smarty/docs/fr/appendixes/resources.xml Sat Sep 30 03:20:52 2006
@@ -1,16 +1,35 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.4 Maintainer: didou Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.5 Maintainer: didou Status: ready -->
+
<chapter id="resources">
<title>Ressources</title>
<para>
- La page Web de Smarty se trouve à l'adresse suivante : &url.smarty;
- Vous pouvez souscrire à la mailing liste en envoyant un email à
- &ml.general.sub;.
- Les archives de la mailing list se trouvent à l'adresse suivante :
- &url.ml.archive;
+ La page Web de Smarty se trouve à l'adresse suivante :
+ <ulink url="&url.smarty;">&url.smarty;</ulink>
</para>
+ <itemizedlist>
+ <listitem><para>
+ Vous pouvez souscrire à la mailing liste en envoyant un email à
+ <literal>&ml.general.sub;</literal>.
+ Les archives de la mailing list se trouvent à l'adresse suivante :
+ <ulink url="&url.ml.archive;">ici</ulink>
+ </para></listitem>
+ <listitem><para>
+ Les forums sur <ulink url="&url.forums;">&url.forums;</ulink>
+ </para></listitem>
+ <listitem><para>
+ Le wiki sur <ulink url="&url.wiki;">&url.wiki;</ulink>
+ </para></listitem>
+ <listitem><para>
+ Le chat sur <ulink url="&url.wiki;">irc.freenode.net#smarty</ulink>
+ </para></listitem>
+ <listitem><para>
+ La FAQ <ulink url="&url.faq_1;">ici</ulink> et <ulink url="&url.faq_2;">ici</ulink>
+ </para></listitem>
+ </itemizedlist>
</chapter>
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -30,4 +49,4 @@
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--->
+-->
\ No newline at end of file
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/appendixes/tips.xml?r1=1.11&r2=1.12&diff_format=u
Index: smarty/docs/fr/appendixes/tips.xml
diff -u smarty/docs/fr/appendixes/tips.xml:1.11 smarty/docs/fr/appendixes/tips.xml:1.12
--- smarty/docs/fr/appendixes/tips.xml:1.11 Sun Apr 9 21:59:55 2006
+++ smarty/docs/fr/appendixes/tips.xml Sat Sep 30 03:20:52 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.11 Maintainer: didou Status: ready -->
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.12 Maintainer: didou Status: ready -->
<chapter id="tips">
<title>Trucs et astuces</title>
@@ -10,13 +10,21 @@
<para>
Peut-être voudrez-vous des fois afficher une valeur par
défaut pour une variable qui n'a pas été assignée, comme
- pour afficher "&nbsp;" afin que les couleurs de fond
- des tableaux fonctionnent. Beaucoup utiliseraient une
- instruction <link linkend="language.function.if">{if}</link>
+ pour afficher <literal>&nbsp;</literal> afin que les couleurs
+ de fond des tableaux fonctionnent. Beaucoup utiliseraient une
+ instruction <link linkend="language.function.if"><varname>{if}</varname></link>
pour gérer celà, mais il existe un moyen
plus facile dans Smarty : l'utilisation du modificateur
- de variable <link
- linkend="language.modifier.default"><emphasis>défaut</emphasis></link>.
+ de variable
+ <link linkend="language.modifier.default"><varname>default</varname></link>.
+ <note>
+ <para>Les erreurs <quote>de variable indéfinie</quote> seront affichés si
+ la fonction PHP
+ <ulink url="&url.php-manual;error_reporting">
+ <varname>error_reporting()</varname></ulink> vaut <constant>E_ALL</constant>
+ et qu'une variable n'a pas été assignée à Smarty.
+ </para>
+ </note>
</para>
<example>
<title>Afficher &nbsp; quand une variable est vide</title>
@@ -36,8 +44,8 @@
</programlisting>
</example>
<para>
- Voir aussi
- <link linkend="language.modifier.default">default</link> et
+ Voir aussi
+ <link linkend="language.modifier.default"><varname>default</varname></link> et
<link linkend="tips.default.var.handling">la gestion des variables par défaut</link>.
</para>
</sect1>
@@ -46,12 +54,14 @@
<title>Gestion des variables par défaut</title>
<para>
Si une variable est utilisée fréquemment dans vos templates,
- lui appliquer le modificateur par défaut peut être un peu fastidieux.
+ lui appliquer le modificateur
+ <link linkend="language.modifier.default"><varname>default</varname></link>
+ peut être un peu fastidieux.
Vous pouvez remédier à celà en lui assignant une valeur par défaut
- avec la fonction <link linkend="language.function.assign">{assign}</link>.
+ avec la fonction <link linkend="language.function.assign"><varname>{assign}</varname></link>.
</para>
<example>
- <title>assigner une valeur par défaut à une variable de template</title>
+ <title>Assigner une valeur par défaut à une variable de template</title>
<programlisting>
<![CDATA[
{* faites cela quelque part en haut de votre template *}
@@ -64,7 +74,7 @@
</example>
<para>
Voir aussi
- <link linkend="language.modifier.default">default</link> et
+ <link linkend="language.modifier.default"><varname>default</varname></link> et
<link linkend="tips.blank.var.handling">la gestion des variables non-assignées</link>.
</para>
</sect1>
@@ -74,18 +84,18 @@
<para>
Quand la majorité de vos templates utilisent les mêmes en-tête et pied-de-page,
il est d'usage de les mettre dans leurs propres templates et de les inclure
- (<link linkend="language.function.include">{include}</link>).
+ (<link linkend="language.function.include"><varname>{include}</varname></link>).
Mais comment faire si l'en-tête doit avoir un titre différent, selon la page
d'où on vient ? Vous pouvez passer le titre à l'en-tête en tant qu'
<link linkend="language.syntax.attributes">attribut</link> quand il est inclus.
</para>
<example>
- <title>passer le titre au template d'en-tête</title>
+ <title>Passer le titre au template d'en-tête</title>
<para>
<filename>mainpage.tpl</filename> - Lorsque la page principal est construite,
- le titre 'Man Page' est passé au <filename>header.tpl</filename> et sera utilisé
+ le titre <quote>Man Page</quote> est passé au <filename>header.tpl</filename> et sera utilisé
en tant que titre.
</para>
<programlisting>
@@ -98,12 +108,13 @@
<para>
<filename>archives.tpl</filename> - Lorsque la page principal est construite, le titre
- sera 'Archives'. Notez que dans cet exemple, nous utilisons une variable du fichier
+ sera <quote>Archives</quote>. Notez que dans cet exemple, nous utilisons une variable du fichier
<filename>archives_page.conf</filename> au lieu d'une variable classique.
</para>
<programlisting>
<![CDATA[
{config_load file='archive_page.conf'}
+
{include file='header.tpl' title=#archivePageTitle#}
{* corps du template ici *}
{include file='footer.tpl'}
@@ -111,9 +122,9 @@
</programlisting>
<para>
- <filename>header.tpl</filename> - Notez que "Smarty News" est affiché si la variable
- $title n'est pas définie, en utilisant le modificateur de variable par
- <link linkend="language.modifier.default">défaut</link>.
+ <filename>header.tpl</filename> - Notez que <quote>Smarty News</quote> est affiché
+ si la variable <literal>$title</literal> n'est pas définie, en utilisant le modificateur de variable par
+ <link linkend="language.modifier.default"><varname>default</varname></link>.
</para>
<programlisting>
<![CDATA[
@@ -142,18 +153,11 @@
<para>
De façon générale, essayez de toujours passer les dates à Smarty
sous forme de <ulink url="&url.php-manual;time">timestamp</ulink>.
- Celà permet aux designers de templates d'utiliser
- <link linkend="language.modifier.date.format">date_format</link>
+ Cela permet aux designers de templates d'utiliser
+ <link linkend="language.modifier.date.format"><varname>date_format</varname></link>
pour avoir un contrôle total sur le formatage des dates et de comparer
facilement les dates entre elles.
</para>
- <note>
- <para>
- A partir Smarty 1.4.0, vous pouvez passer les dates à Smarty
- sous la forme de timestamps Unix ou MySQL, ou tout autre format de dates
- que comprend <ulink url="&url.php-manual;strtotime">strtotime()</ulink>.
- </para>
- </note>
<example>
<title>Utilisation de date_format</title>
<programlisting>
@@ -166,7 +170,7 @@
</para>
<screen>
<![CDATA[
-Jan 4, 2001
+Jan 4, 2009
]]>
</screen>
<programlisting>
@@ -179,10 +183,13 @@
</para>
<screen>
<![CDATA[
-2001/01/04
+2009/01/04
]]>
- </screen>
- <programlisting>
+ </screen>
+ <para>
+ Les dates peuvent être comparées dans le template en utilisant les timestamps, comme ceci :
+ </para>
+ <programlisting>
<![CDATA[
{if $date1 < $date2}
...
@@ -191,7 +198,8 @@
</programlisting>
</example>
<para>
- En utilisant la fonction <link linkend="language.function.html.select.date">{html_select_date}</link>
+ En utilisant la fonction
+ <link linkend="language.function.html.select.date"><varname>{html_select_date}</varname></link>
dans un template, le programmeur veut en général convertir le
résultat d'un formulaire en un timestamp.
Voici une fonction qui devrait vous être utile.
@@ -210,13 +218,13 @@
function makeTimeStamp($year='', $month='', $day='')
{
if(empty($year)) {
- $year = strftime("%Y");
+ $year = strftime('%Y');
}
if(empty($month)) {
- $month = strftime("%m");
+ $month = strftime('%m');
}
if(empty($day)) {
- $day = strftime("%d");
+ $day = strftime('%d');
}
return mktime(0, 0, 0, $month, $day, $year);
@@ -228,10 +236,10 @@
<para>
Voir aussi
- <link linkend="language.function.html.select.date">{html_select_date}</link>,
- <link linkend="language.function.html.select.time">{html_select_time}</link>,
- <link linkend="language.modifier.date.format">date_format</link> et
- <link linkend="language.variables.smarty.now">$smarty.now</link>,
+ <link linkend="language.function.html.select.date"><varname>{html_select_date}</varname></link>,
+ <link linkend="language.function.html.select.time"><varname>{html_select_time}</varname></link>,
+ <link linkend="language.modifier.date.format"><varname>date_format</varname></link> et
+ <link linkend="language.variables.smarty.now"><parameter>$smarty.now</parameter></link>,
</para>
</sect1>
@@ -311,8 +319,9 @@
Traditionnellemnt, la programmation avec des templates dans les applications
se déroule de la façon suivante : d'abord vous récupérez vos variables
dans l'application PHP (peut-être avec des requêtes en base de données), puis
- vous instanciez votre objet Smarty, <link linkend="api.assign">assign()</link>
- les variables et <link linkend="api.display">display()</link> le
+ vous instanciez votre objet Smarty,
+ <link linkend="api.assign"><varname>assign()</varname></link>
+ les variables et <link linkend="api.display"><varname>display()</varname></link> le
template. Disons par exemple que nous avons un téléscripteur dans
notre template. Nous récupérerions les données dans notre application,
puis les assignerions ensuite pour les afficher. Mais ne serait-ce pas
@@ -329,7 +338,7 @@
<para>
<filename>function.load_ticker.php</filename> -
Efface le fichier du répertoire des
- <link linkend="variable.plugins.dir">$plugins</link>
+ <link linkend="variable.plugins.dir"><parameter>$plugins</parameter></link>
</para>
<programlisting role="php">
<![CDATA[
@@ -367,9 +376,9 @@
</example>
<para>
Voir aussi
- <link linkend="language.function.include.php">{include_php}</link>,
- <link linkend="language.function.include">{include}</link> et
- <link linkend="language.function.php">{php}</link>.
+ <link linkend="language.function.include.php"><varname>{include_php}</varname></link>,
+ <link linkend="language.function.include"><varname>{include}</varname></link> et
+ <link linkend="language.function.php"><varname>{php}</varname></link>.
</para>
</sect1>
<sect1 id="tips.obfuscating.email">
@@ -380,14 +389,13 @@
adresses est de parcourir les pages Web. Voici une façon de remédier
à ce problème : mettre votre adresse email dans du Javascript brouillé
au milieu de votre source HTML, sans que celà ne gêne l'affichage sur le
- navigateur Web. Celà est fait grâce au plugin
- <link linkend="language.function.mailto">{mailto}</link>.
+ navigateur Web. Cela est fait grâce au plugin
+ <link linkend="language.function.mailto"><varname>{mailto}</varname></link>.
</para>
<example>
<title>Exemple de dissimulation d'une adresse email</title>
<programlisting>
<![CDATA[
-{* dans le template *}
<div id="contact">Envoyer une demande à
{mailto address=$EmailAddress encode='javascript' subject='Bonjour'}
]]>
@@ -403,8 +411,8 @@
</note>
<para>
Voir aussi
- <link linkend="language.modifier.escape">escape</link> et
- <link linkend="language.function.mailto">{mailto}</link>.
+ <link linkend="language.modifier.escape"><varname>escape</varname></link> et
+ <link linkend="language.function.mailto"><varname>{mailto}</varname></link>.
</para>
</sect1>
</chapter>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/appendixes/troubleshooting.xml?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/appendixes/troubleshooting.xml
diff -u smarty/docs/fr/appendixes/troubleshooting.xml:1.5 smarty/docs/fr/appendixes/troubleshooting.xml:1.6
--- smarty/docs/fr/appendixes/troubleshooting.xml:1.5 Sun Jul 10 19:27:49 2005
+++ smarty/docs/fr/appendixes/troubleshooting.xml Sat Sep 30 03:20:52 2006
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.4 Maintainer:gerald Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.5 Maintainer:gerald Status: ready -->
+
<chapter id="troubleshooting">
<title>Diagnostic des erreurs</title>
<para></para>
@@ -13,15 +14,15 @@
</para>
<example>
<title>erreurs Smarty</title>
- <screen>
+ <screen>
<![CDATA[
Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah'
- in /path/to/smarty/Smarty.class.php on line 1041
+in /path/to/smarty/Smarty.class.php on line 1041
Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name
- in /path/to/smarty/Smarty.class.php on line 1041
+in /path/to/smarty/Smarty.class.php on line 1041
]]>
- </screen>
+ </screen>
</example>
<para>
@@ -38,131 +39,135 @@
<example>
<title>Erreur d'analyse PHP</title>
- <screen>
+ <screen>
<![CDATA[
Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75
]]>
- </screen>
+ </screen>
</example>
-
<para>
Quand vous rencontrez une erreur d'analyse PHP, le numéro de la ligne
indiqué est celui du fichier PHP compilé et non du template. Vous pouvez alors
regarder le template et détecter l'erreur. Voici quelques erreurs fréquentes :
- balises fermantes pour <link linkend="language.function.if">{if}{/if}</link>
- ou <link linkend="language.function.if">{section}{/section}</link> manquantes, ou
- syntaxe logique incorrecte dans une instruction {if}. Si vous ne trouvez pas l'erreur,
- vous devrez alors ouvrir le fichier PHP compilé et aller à la ligne correspondante pour
- trouver d'où vient l'erreur.
+ balises fermantes pour
+ <link linkend="language.function.if"><varname>{if}{/if}</varname></link>
+ ou
+ <link linkend="language.function.if"><varname>{section}{/section}</varname></link>
+ manquantes, ou syntaxe logique incorrecte dans une instruction <varname>{if}</varname>.
+ Si vous ne trouvez pas l'erreur, vous devrez alors ouvrir le fichier PHP compilé et aller à la
+ ligne correspondante pour trouver d'où vient l'erreur.
</para>
-
-
<example>
<title>Autres erreurs communes</title>
-
- <itemizedlist>
- <listitem>
- <screen>
+ <screen>
<![CDATA[
Warning: Smarty error: unable to read resource: "index.tpl" in...
ou
Warning: Smarty error: unable to read resource: "site.conf" in...
]]>
- </screen>
- <para>
- <itemizedlist>
- <listitem>
- <para>
- Le dossier <link linkend="variable.template.dir">$template_dir</link>
- est incorrect, n'existe pas ou le fichier
- the file <filename>index.tpl</filename> n'est pas dans le dossier
- <filename class="directory">templates/</filename>.
- </para>
- </listitem>
- <listitem>
- <para>
- Une fonction <link linkend="language.function.config.load">{config_load}</link>
- est dans un template (ou
- <link linkend="api.config.load">config_load()</link>
- a été appelé) et soit
- <link linkend="variable.config.dir">$config_dir</link>
- est incohérent, n'existe pas, ou
- <filename>site.conf</filename> n'est pas dans le dossier.
- </para>
- </listitem>
-
- </itemizedlist>
- </para>
-
- </listitem><listitem>
-
- <screen>
-<![CDATA[
-Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist,
-or is not a directory...
-]]>
- </screen>
+ </screen>
+ <para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Le dossier
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>
+ est incorrect, n'existe pas ou le fichier
+ the file <filename>index.tpl</filename> n'est pas dans le dossier
+ <filename class="directory">templates/</filename>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Une fonction
+ <link linkend="language.function.config.load"><varname>{config_load}</varname></link>
+ est dans un template (ou
+ <link linkend="api.config.load"><varname>config_load()</varname></link>
+ a été appelé) et soit
+ <link linkend="variable.config.dir"><varname>$config_dir</varname></link>
+ est incohérent, n'existe pas, ou
+ <filename>site.conf</filename> n'est pas dans le dossier.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <screen>
+ <![CDATA[
+ Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist,
+ or is not a directory...
+ ]]>
+ </screen>
+ <itemizedlist>
+ <listitem>
<para>
Soit le dossier
- <link linkend="variable.compile.dir">$compile_dir</link>
+ <link linkend="variable.compile.dir"><parameter>$compile_dir</parameter></link>
n'est pas correctement défini, le dossier n'existe pas, ou
<filename>templates_c</filename> est un fichier et non un dossier.
</para>
- </listitem><listitem>
- <screen>
-<![CDATA[
-Fatal error: Smarty error: unable to write to $compile_dir '....
-]]>
- </screen>
+ </listitem>
+ </itemizedlist>
+ <screen>
+ <![CDATA[
+ Fatal error: Smarty error: unable to write to $compile_dir '....
+ ]]>
+ </screen>
+ <itemizedlist>
+ <listitem>
<para>
- Le dossier <link linkend="variable.compile.dir">$compile_dir</link>
+ Le dossier <link linkend="variable.compile.dir"><parameter>$compile_dir</parameter></link>
n'est pas accessible en écriture par le serveur web. Voir le bas
de la page sur l'<link linkend="installing.smarty.basic">installation de
- Smarty</link> pour les permissions.
+ Smarty</link> pour les permissions.
</para>
+ </listitem>
+ </itemizedlist>
- </listitem><listitem>
-
- <screen>
+ <screen>
<![CDATA[
Fatal error: Smarty error: the $cache_dir 'cache' does not exist,
or is not a directory. in /..
]]>
- </screen>
+ </screen>
+ <itemizedlist>
+ <listitem>
<para>
Cela signifie que
- <link linkend="variable.caching">$caching</link> est activé et soit
+ <link linkend="variable.caching"><parameter>$caching</parameter></link> est activé et soit
le dossier
- <link linkend="variable.cache.dir">$cache_dir</link>
+ <link linkend="variable.cache.dir"><parameter>$cache_dir</parameter></link>
n'est pas correctement défini, le dossier n'existe pas, ou
<filename>cache</filename> est un fichier et non un dossier.
</para>
+ </listitem>
+ </itemizedlist>
- </listitem><listitem>
-
- <screen>
+ <screen>
<![CDATA[
Fatal error: Smarty error: unable to write to $cache_dir '/...
]]>
- </screen>
+ </screen>
+ <itemizedlist>
+ <listitem>
<para>
Cela signifie que
- <link linkend="variable.caching">$caching</link> est activé et le dossier
- <link linkend="variable.cache.dir">$cache_dir</link>
+ <link linkend="variable.caching"><parameter>$caching</parameter></link> est activé et
+ le dossier
+ <link linkend="variable.cache.dir"><parameter>$cache_dir</parameter></link>
n'est pas accessible en écriture par le serveur web. Voir le bas
de la page sur l'<link linkend="installing.smarty.basic">installation de
- Smarty</link> pour les permissions.
+ Smarty</link> pour les permissions.
</para>
</listitem>
</itemizedlist>
- </example>
+ </example>
<para>
Voir aussi
<link linkend="chapter.debugging.console">le débogage</link>,
- <link linkend="variable.error.reporting">$error_reporting</link> et
- <link linkend="api.trigger.error">trigger_error()</link>.
- </para>
+ <link linkend="variable.error.reporting"><parameter>$error_reporting</parameter></link> et
+ <link linkend="api.trigger.error"><varname>trigger_error()</varname></link>.
+ </para>
</sect1>
</chapter>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/getting-started.xml?r1=1.12&r2=1.13&diff_format=u
Index: smarty/docs/fr/getting-started.xml
diff -u smarty/docs/fr/getting-started.xml:1.12 smarty/docs/fr/getting-started.xml:1.13
--- smarty/docs/fr/getting-started.xml:1.12 Sat Dec 10 22:09:38 2005
+++ smarty/docs/fr/getting-started.xml Sat Sep 30 03:20:52 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
-<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.13 $ -->
+<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready -->
<part id="getting.started">
<title>Pour commencer</title>
@@ -157,8 +157,8 @@
<title>Installation de base</title>
<para>
Copiez les fichiers bibliothèques de Smarty du sous-dossier
- /libs/ de la distribution à un emplacement accessible à PHP.
- Ce sont des fichiers PHP que vous NE DEVEZ PAS
+ <filename>/libs/</filename> de la distribution à un emplacement
+ accessible à PHP. Ce sont des fichiers PHP que vous NE DEVEZ PAS
modifier. Ils sont partagés par toutes les applications et ne seront
mis à jour que lorsque vous installerez une nouvelle version de
Smarty.
@@ -179,25 +179,26 @@
<para>
Smarty utilise une <ulink url="&url.php-manual;define">constante</ulink> PHP appelée <link
- linkend="constant.smarty.dir">SMARTY_DIR</link> qui
- représente le <emphasis role="bold">chemin complet</emphasis> de la bibliothèque Smarty. En fait,
- si votre application trouve le fichier
+ linkend="constant.smarty.dir"><constant>SMARTY_DIR</constant></link> qui
+ représente le <emphasis role="bold">chemin complet</emphasis> de la bibliothèque Smarty.
+ En fait, si votre application trouve le fichier
<filename>Smarty.class.php</filename>, vous n'aurez pas
- besoin de définir la variable <link linkend="constant.smarty.dir">SMARTY_DIR</link>,
+ besoin de définir la variable
+ <link linkend="constant.smarty.dir"><constant>SMARTY_DIR</constant></link>,
Smarty s'en chargera pour vous.
En revanche, si <filename>Smarty.class.php</filename>
n'est pas dans votre répertoire d'inclusion ou que vous ne
donnez pas un chemin absolu à votre application, vous
- devez définir SMARTY_DIR explicitement. SMARTY_DIR
+ devez définir <constant>SMARTY_DIR</constant> explicitement.
+ <constant>SMARTY_DIR</constant>
<emphasis role="bold">doit</emphasis> avoir être terminé par un slash.
</para>
- <para>
- Voici comment créer une instance de Smarty dans vos scripts PHP :
- </para>
-
<example>
- <title>créer une instance de Smarty</title>
+ <title>Créer une instance de Smarty</title>
+ <para>
+ Voici comment créer une instance de Smarty dans vos scripts PHP :
+ </para>
<programlisting role="php">
<![CDATA[
<?php
@@ -305,8 +306,8 @@
une application principalement pour mettre en évidence une
convention de nommage des répertoires. Vous pouvez utiliser le même
environnement pour n'importe quelle autre application, il suffit de
- remplacer "livredor" avec le nom de votre application. Nous allons
- mettre nos répertoires Smarty dans
+ remplacer <quote>livredor</quote> avec le nom de votre application.
+ Nous allons mettre nos répertoires Smarty dans
<filename
class="directory">/web/www.example.com/smarty/livredor/</filename>.
</para>
@@ -322,18 +323,19 @@
<title>Technical Note</title>
<para>
Il est pratique de configurer le serveur Web de
- sorte que 'index.php' soit identifié comme fichier
+ sorte que <filename>index.php</filename> soit identifié comme fichier
par défaut de ce répertoire. Aicnsi, si l'on tape
- 'http://www.example.com/livredor/', le script 'index.php' soit
- exécuté sans que 'index.php' ne soit spécifié dans l'URL. Avec Apache,
- vous pouvez régler cela en ajoutant 'index.php' à la ligne où se
- trouve <emphasis>DirectoryIndex</emphasis> (séparez chaque entrée par un espace)
- dans le httpd.conf.
- </para>
- <para>
- <emphasis>DirectoryIndex
- index.htm index.html index.php index.php3 default.html index.cgi
- </emphasis>
+ <literal>http://www.example.com/livredor/</literal>, le script
+ <filename>index.php</filename> soit exécuté sans que
+ <filename>index.php</filename> ne soit spécifié dans l'URL. Avec
+ Apache, vous pouvez régler cela en ajoutant <filename>index.php</filename>
+ à la ligne où se trouve <literal>DirectoryIndex</literal> (séparez chaque entrée
+ par un espace) dans le <filename>httpd.conf</filename>.
+ <informalexample>
+ <programlisting>
+<![CDATA[DirectoryIndex index.htm index.html index.cgi index.php]]>
+ </programlisting>
+ </informalexample>
</para>
</note>
<para>
@@ -341,7 +343,7 @@
</para>
<example>
- <title>Exemple de structure de fichiers</title>
+ <title>Structure de fichiers</title>
<screen>
<![CDATA[
/usr/local/lib/php/Smarty-v.e.r/libs/Smarty.class.php
@@ -364,13 +366,13 @@
<para>
Smarty a besoin d'<emphasis role="bold">accéder en écriture</emphasis>
aux répertoires <link linkend="variable.compile.dir">
- <emphasis>$compile_dir</emphasis></link> et <link linkend="variable.cache.dir">
- <emphasis>$cache_dir</emphasis></link>,
+ <parameter>$compile_dir</parameter></link> et <link linkend="variable.cache.dir">
+ <parameter>$cache_dir</parameter></link>,
assurez-vous donc que le serveur Web dispose de ces droits d'accès.
Il s'agit généralement de l'utilisateur "nobody" et du group
"nobody". Pour les utilisateurs de OS X, l'utilisateur par défaut
est "web" et le group "web". Si vous utilisez Apache, vous pouvez
- parcourir le fichier httpd.conf (en général dans
+ parcourir le fichier <filename>httpd.conf</filename> (en général dans
"/usr/local/apache/conf/") pour déterminer quel est l'utilisateur
et le groupe auquel il appartient.
</para>
@@ -389,7 +391,7 @@
</example>
<note>
- <title>Note technique</title>
+ <title>Note</title>
<para>
La commande chmod 770 est relativement bien sécurisée, elle donne
à l'utilisateur "nobody" et au groupe "nobody" les accès en
@@ -400,12 +402,13 @@
</note>
<para>
- Nous devons créer le fichier 'index.tpl' que Smarty va charger.
- Il va se trouver dans le dossier <link linkend="variable.template.dir">$template_dir</link>.
+ Nous devons créer le fichier <filename>index.tpl</filename> que Smarty va charger.
+ Il va se trouver dans le dossier
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>.
</para>
<example>
- <title>Edition de /web/www.example.com/smarty/templates/index.tpl</title>
+ <title>Notre /web/www.example.com/smarty/templates/index.tpl</title>
<screen>
<![CDATA[
@@ -420,7 +423,8 @@
<note>
<title>Note technique</title>
<para>
- {* Smarty *} est un <link linkend="language.syntax.comments">commentaire</link>
+ <literal>{* Smarty *}</literal> est un
+ <link linkend="language.syntax.comments">commentaire</link>
de template. Il n'est pas obligatoire mais il est bon de commencer tous vos templates
avec ce commentaire. Celà rend le fichier facilement
reconnaissable en plus de son extension. Les éditeurs
@@ -430,10 +434,11 @@
</note>
<para>
- Maintenant passons à l'édition du fichier 'index.php'. Nous allons
- créer une instance de Smarty, <link linkend="api.assign">assigner</link>
+ Maintenant passons à l'édition du fichier <filename>index.php</filename>. Nous allons
+ créer une instance de Smarty,
+ <link linkend="api.assign"><varname>assigner<varname></link>
une valeur à une variable de template et
- <link linkend="api.display">afficher</link> le résultat avec 'index.tpl'.
+ <link linkend="api.display">afficher</link> le résultat avec <filename>index.tpl</filename>.
</para>
<example>
@@ -495,52 +500,54 @@
propre classe fille et de l'initialiser selon votre environnement.
De la sorte, nous n'aurons plus besoin de configurer à chaques fois les
chemins de notre environnement. Créons un nouveau répertoire
- "/php/includes/livredor/" et un nouveau fichier appelé <filename>setup.php</filename>.
- Dans notre exemple d'environnement, "/php/includes" est notre
+ <filename>/php/includes/livredor/</filename> et un nouveau fichier
+ appelé <filename>setup.php</filename>.
+ Dans notre exemple d'environnement, <filename>/php/includes</filename> est notre
include_path PHP. Assurez-vous de faire la même chose ou alors d'utiliser
des chemins absolus.
</para>
<example>
- <title>édition de /php/includes/livredor/setup.php</title>
+ <title>Édition de /php/includes/livredor/setup.php</title>
<programlisting role="php">
<![CDATA[
<?php
- // charge la librairie Smarty
- require('Smarty.class.php');
+// charge la librairie Smarty
+require('Smarty.class.php');
- // le fichier setup.php est un bon
- // endroit pour charger les fichiers
- // de librairies de l'application et vous pouvez
- // faire celà juste ici. Par exemple :
- // require('livredor/livredor.lib.php');
+// le fichier setup.php est un bon
+// endroit pour charger les fichiers
+// de librairies de l'application et vous pouvez
+// faire celà juste ici. Par exemple :
+// require('livredor/livredor.lib.php');
- class Smarty_livredor extends Smarty {
+class Smarty_livredor extends Smarty {
- function Smarty_livredor() {
+ function Smarty_livredor() {
- // Constructeur de la classe.
- // Appelé automatiquement à l'instanciation de la classe.
+ // Constructeur de la classe.
+ // Appelé automatiquement à l'instanciation de la classe.
- $this->Smarty();
+ $this->Smarty();
- $this->template_dir = '/web/www.example.com/smarty/livredor/templates/';
- $this->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/';
- $this->config_dir = '/web/www.example.com/smarty/livredor/configs/';
- $this->cache_dir = '/web/www.example.com/smarty/livredor/cache/';
+ $this->template_dir = '/web/www.example.com/smarty/livredor/templates/';
+ $this->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/';
+ $this->config_dir = '/web/www.example.com/smarty/livredor/configs/';
+ $this->cache_dir = '/web/www.example.com/smarty/livredor/cache/';
- $this->caching = true;
- $this->assign('app_name', 'Guest Book');
- }
+ $this->caching = true;
+ $this->assign('app_name', 'Guest Book');
+ }
- }
+}
?>
]]>
</programlisting>
</example>
<para>
- Modifions maintenant le fichier 'index.php' pour qu'il utilise 'setup.php'
+ Modifions maintenant le fichier <filename>index.php</filename> pour qu'il utilise
+ <filename>setup.php</filename>
</para>
<example>
@@ -548,13 +555,13 @@
<programlisting role="php">
<![CDATA[
<?php
- require('livredor/setup.php');
+require('livredor/setup.php');
- $smarty = new Smarty_livredor;
+$smarty = new Smarty_livredor();
- $smarty->assign('name','Ned');
+$smarty->assign('name','Ned');
- $smarty->display('index.tpl');
+$smarty->display('index.tpl');
?>
]]>
@@ -563,8 +570,8 @@
<para>
Vous savez maintenant qu'il est facile de créer une instance de Smarty,
- correctement configurée, en utilisant Smarty_livredor qui initialise
- automatiquement tout ce qu'il faut pour votre application.
+ correctement configurée, en utilisant <literal>Smarty_livredor()</literal>
+ qui initialise automatiquement tout ce qu'il faut pour votre application.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/language-snippets.ent?r1=1.5&r2=1.6&diff_format=u
Index: smarty/docs/fr/language-snippets.ent
diff -u smarty/docs/fr/language-snippets.ent:1.5 smarty/docs/fr/language-snippets.ent:1.6
--- smarty/docs/fr/language-snippets.ent:1.5 Sun Jul 3 13:41:56 2005
+++ smarty/docs/fr/language-snippets.ent Sat Sep 30 03:20:52 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<!ENTITY note.parameter.merge '<note>
<title>Note technique</title>
@@ -20,10 +20,33 @@
même template, par exemple, pour avoir des templates compilés
pour différents langages. Une autre utilité pour l'identifiant de compilation
<parameter>$compile_id</parameter> est lorsque vous utilisez plus d'un
-<link linkend="variable.template.dir">$template_dir</link> mais
-seulement un <link linkend="variable.compile.dir">$compile_dir</link>.
+<link linkend="variable.template.dir"><parameter>$template_dir</parameter></link> mais
+seulement un <link linkend="variable.compile.dir"><parameter>$compile_dir</parameter></link>.
Définissez un <parameter>$compile_id</parameter>
-séparé pour chaque <link linkend="variable.template.dir">$template_dir</link>,
+séparé pour chaque
+<link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>,
sinon, les templates du même nom s'effaceront. Vous pouvez également
définir la variable <link linkend="variable.compile.id">$compile_id</link> une seule
-fois plutôt que de la passer à chaque appel à la fonction.</para>'>
\ No newline at end of file
+fois plutôt que de la passer à chaque appel à la fonction.</para>'>
+
+<!ENTITY api.register.snippet '<para>
+ La fonction PHP de callback <parameter>function</parameter> peut être soit :
+ <itemizedlist>
+ <listitem><para>
+ Une chaîne de caractères contenant la fonction <parameter>name</parameter>
+ </para></listitem>
+
+ <listitem><para>
+ Un tableau sous la forme <literal>array(&$object, $method)</literal> où
+ <literal>&$object</literal> est une référence d'objet et
+ <literal>$method</literal> une chaîne contenant le nom de la méthode
+ </para></listitem>
+
+ <listitem><para>
+ Un tableau sous la forme
+ <literal>array(&$class, $method)</literal> où
+ <literal>$class</literal> est le nom de la classe et
+ <literal>$method</literal> est une méthode de la classe.
+ </para></listitem>
+ </itemizedlist>
+ </para>'>
\ No newline at end of file