cvs: smarty /docs/fr/appendixes bugs.xml tips.xml troubleshooting.xml
"Mehdi Achour" <[email protected]>
| Newsgroups | gmane.comp.php.cvs.smarty |
|---|---|
| Message-ID | <cvsdidou1085327396@cvsserver> |
didou Sun May 23 11:49:56 2004 EDT
Modified files:
/smarty/docs/fr/appendixes bugs.xml tips.xml troubleshooting.xml
Log:
WS and added revcheck
--
Smarty CVS Mailing List (http://cvs.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
didou-20040523114956.txt
(text/plain, 21.3 KB)
http://cvs.php.net/diff.php/smarty/docs/fr/appendixes/bugs.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/fr/appendixes/bugs.xml
diff -u smarty/docs/fr/appendixes/bugs.xml:1.1 smarty/docs/fr/appendixes/bugs.xml:1.2
--- smarty/docs/fr/appendixes/bugs.xml:1.1 Sun Mar 28 10:18:13 2004
+++ smarty/docs/fr/appendixes/bugs.xml Sun May 23 11:49:55 2004
@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<chapter id="bugs">
- <title>BUGS</title>
- <para>
- Vérifiez le fichier de BUGS fourni avec la dernière version de Smarty ou
- consultez le site Web.
- </para>
+ <title>BUGS</title>
+ <para>
+ Vérifiez le fichier de BUGS fourni avec la dernière version de Smarty ou
+ consultez le site Web.
+ </para>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
@@ -26,4 +27,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/diff.php/smarty/docs/fr/appendixes/tips.xml?r1=1.2&r2=1.3&ty=u
Index: smarty/docs/fr/appendixes/tips.xml
diff -u smarty/docs/fr/appendixes/tips.xml:1.2 smarty/docs/fr/appendixes/tips.xml:1.3
--- smarty/docs/fr/appendixes/tips.xml:1.2 Mon Apr 19 13:08:12 2004
+++ smarty/docs/fr/appendixes/tips.xml Sun May 23 11:49:55 2004
@@ -1,5 +1,9 @@
+
+Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56
+
+Warning: Unknown modifier 'l' in /home/user/didou/cvs/smarty/docs/fr/clean.php on line 56
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- EN-Revision: 1.4 Maintainer: didou Status: ready -->
<chapter id="tips">
<title>Trucs et astuces</title>
@@ -7,14 +11,14 @@
<sect1 id="tips.blank.var.handling">
<title>Gestion des variables non-assignées</title>
<para>
- Peut-être voudrez-vous des fois afficher une valeur par
+ 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 {if} pour gérer cela, mais il existe un moyen
- plus facile dans Smarty : l'utilisation du modificateur
+ des tableaux fonctionnent. Beaucoup utiliseraient une
+ instruction {if} pour gérer cela, mais il existe un moyen
+ plus facile dans Smarty : l'utilisation du modificateur
de variable <emphasis>default</emphasis>.
- </para>
+ </para>
<example>
<title>afficher &nbsp; quand une variable est vide</title>
<programlisting>
@@ -35,35 +39,35 @@
</programlisting>
</example>
</sect1>
-
- <sect1 id="tips.default.var.handling">
- <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.
- Vous pouvez remédier à cela en lui assignant une valeur par défaut
- avec la fonction <link linkend="language.function.assign">assign</link>.
- </para>
-<example>
-<title>assigner une valeur par défaut à une variable de template</title>
+
+ <sect1 id="tips.default.var.handling">
+ <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.
+ Vous pouvez remédier à cela en lui assignant une valeur par défaut
+ avec la fonction <link linkend="language.function.assign">assign</link>.
+ </para>
+ <example>
+ <title>assigner une valeur par défaut à une variable de template</title>
<programlisting>
{* faites cela qq part en haut de votre template *}
{assign var="title" value=$title|default:"no title"}
{* si $title est vide, il contiendra alors no "no title" *}
{$title}</programlisting>
-</example>
- </sect1>
- <sect1 id="tips.passing.vars">
- <title>Passage du titre à un template d'en-tête</title>
- <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.
- 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 quand il est inclus.
- </para>
-<example>
-<title>passer le titre au template d'en-tête</title>
+ </example>
+ </sect1>
+ <sect1 id="tips.passing.vars">
+ <title>Passage du titre à un template d'en-tête</title>
+ <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.
+ 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 quand il est inclus.
+ </para>
+ <example>
+ <title>passer le titre au template d'en-tête</title>
<programlisting>
mainpage.tpl
@@ -96,32 +100,32 @@
----------
</BODY>
</HTML></programlisting>
-</example>
- <para>
+ </example>
+ <para>
Quand la page principale est conçue, le titre "Main page" est passé à header.tpl
et sera donc utilisé pour le titre. Quand la page d'archive est conçue,
le titre sera "Archives". Notez que dans l'exemple des archives, on utilise
le fichier archives_page.conf plutôt que des variables codées en dur.
Remarquez aussi que "BC News" est affichée si la variable $title
n'est pas définie, grâce au modificateur de variable <emphasis>default</emphasis>.
- </para>
- </sect1>
- <sect1 id="tips.dates">
- <title>Dates</title>
- <para>
- De façon générale, essayez de toujours passer les dates à Smarty
- sous forme de timestamp. Cela permet aux designers de templates d'utiliser
- <link linkend="language.modifier.date.format">date_format</link>
- pour avoir un contrôle total sur le formatage des dates et de comparer
- facilement les dates entre elles.
- </para>
- <para>
- NOTE : à 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 strtotime().
- </para>
-<example>
-<title>utilisation de date_format</title>
+ </para>
+ </sect1>
+ <sect1 id="tips.dates">
+ <title>Dates</title>
+ <para>
+ De façon générale, essayez de toujours passer les dates à Smarty
+ sous forme de timestamp. Cela permet aux designers de templates d'utiliser
+ <link linkend="language.modifier.date.format">date_format</link>
+ pour avoir un contrôle total sur le formatage des dates et de comparer
+ facilement les dates entre elles.
+ </para>
+ <para>
+ NOTE : à 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 strtotime().
+ </para>
+ <example>
+ <title>utilisation de date_format</title>
<programlisting>
{$startDate|date_format}
@@ -140,14 +144,14 @@
{if $date1 < $date2}
...
{/if}</programlisting>
-</example>
- <para>
- En utilisant la fonction {html_select_date} 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.
- </para>
-<example>
-<title>conversion des éléments date d'un formulaire en timestamp</title>
+ </example>
+ <para>
+ En utilisant la fonction {html_select_date} 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.
+ </para>
+ <example>
+ <title>conversion des éléments date d'un formulaire en timestamp</title>
<programlisting>
// cela suppose que vos éléments de formulaire soient nommés
// startDate_Day, startDate_Month, startDate_Year
@@ -165,22 +169,22 @@
return mktime(0,0,0,$month,$day,$year);
}</programlisting>
-</example>
- </sect1>
- <sect1 id="tips.wap">
- <title>WAP/WML</title>
- <para>
- Les templates WAP/WML nécessitent un en-tête "Content-Type" qui doit être
- passé avec le template. Le moyen le plus facile de faire cela est d'écrire
- une fonction utilisateur qui écrit l'en-tête. Si vous utilisez le cache,
- cela ne fonctionnera pas. Nous utiliserons donc une balise d'insertion
+ </example>
+ </sect1>
+ <sect1 id="tips.wap">
+ <title>WAP/WML</title>
+ <para>
+ Les templates WAP/WML nécessitent un en-tête "Content-Type" qui doit être
+ passé avec le template. Le moyen le plus facile de faire cela est d'écrire
+ une fonction utilisateur qui écrit l'en-tête. Si vous utilisez le cache,
+ cela ne fonctionnera pas. Nous utiliserons donc une balise d'insertion
(rappelez-vous que les balises d'insertion ne sont pas mises en cache !).
Assurez-vous qu'aucune sortie
- rien n'est transmise au navigateur avant l'appel du template, sans quoi
+ rien n'est transmise au navigateur avant l'appel du template, sans quoi
la modification de l'en-tête échouera.
- </para>
-<example>
-<title>utilisation d'insert pour écrire un en-tête Content-Type WML</title>
+ </para>
+ <example>
+ <title>utilisation d'insert pour écrire un en-tête Content-Type WML</title>
<programlisting>
// assurez-vous que Apache est configuré pour les extensions .wml !
// mettez cette fonction qq part dans votre applications
@@ -218,37 +222,37 @@
</p>
</card>
</wml></programlisting>
-</example>
- </sect1>
- <sect1 id="tips.componentized.templates">
- <title>Templates composants</title>
- <para>
- Cette astuce tient plus du hack qu'autre chose mais n'en demeure pas
- moins une idée plutôt chouette. Utilisez-la à vos propres risques. ;-)
- </para>
- <para>
- 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, assignez les variables et affichez 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
- mieux de pouvoir ajouter ce téléscripteur à n'importe quelle application
- en incluant directement le template sans avoir à se soucier de la récupération
- des données.
- </para>
- <para>
- Vous pouvez intégrer du PHP dans vos templates avec les balises
- {php}{/php}. Avec cette méthode, vous pouvez inclure des templates complets,
+ </example>
+ </sect1>
+ <sect1 id="tips.componentized.templates">
+ <title>Templates composants</title>
+ <para>
+ Cette astuce tient plus du hack qu'autre chose mais n'en demeure pas
+ moins une idée plutôt chouette. Utilisez-la à vos propres risques. ;-)
+ </para>
+ <para>
+ 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, assignez les variables et affichez 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
+ mieux de pouvoir ajouter ce téléscripteur à n'importe quelle application
+ en incluant directement le template sans avoir à se soucier de la récupération
+ des données.
+ </para>
+ <para>
+ Vous pouvez intégrer du PHP dans vos templates avec les balises
+ {php}{/php}. Avec cette méthode, vous pouvez inclure des templates complets,
dans la mesure où ils récupèrent leurs propres données pour les assigner
à leurs propres variables. Avec le traitement intégré
- de cette façon, vous pouvez garder le template et le traitement ensemble.
- Ainsi, on ne se soucie plus d'où vient le contenu du template,
- tout vient comme un seul et unique composant.
- </para>
-<example>
-<title>template composant</title>
+ de cette façon, vous pouvez garder le template et le traitement ensemble.
+ Ainsi, on ne se soucie plus d'où vient le contenu du template,
+ tout vient comme un seul et unique composant.
+ </para>
+ <example>
+ <title>template composant</title>
<programlisting>
{* Smarty *}
@@ -270,17 +274,17 @@
{/php}
Stock Name: {$ticker_name} Stock Price: {$ticker_price}</programlisting>
-</example>
- <para>
- A partir de Smarty 1.5.0, il y a même un moyen plus propre. Vous
- pouvez inclure du PHP dans votre template avec la balise {include_php ...}.
- De cette façon, vous pouvez garder séparée la logique applicative
- de la logique de présentation. Reportez-vous à la fonction <link
- linkend="language.function.include.php">include_php</link> pour plus
- d'informations.
- </para>
-<example>
-<title>template composant avec include_php</title>
+ </example>
+ <para>
+ A partir de Smarty 1.5.0, il y a même un moyen plus propre. Vous
+ pouvez inclure du PHP dans votre template avec la balise {include_php ...}.
+ De cette façon, vous pouvez garder séparée la logique applicative
+ de la logique de présentation. Reportez-vous à la fonction <link
+ linkend="language.function.include.php">include_php</link> pour plus
+ d'informations.
+ </para>
+ <example>
+ <title>template composant avec include_php</title>
<programlisting>
load_ticker.php
---------------
@@ -309,20 +313,20 @@
{include_php file="load_ticker.php"}
Stock Name: {$ticker_name} Stock Price: {$ticker_price}</programlisting>
-</example>
- </sect1>
- <sect1 id="tips.obfuscating.email">
- <title>Dissimuler les adresses email</title>
- <para>
- Vous-êtes vous déjà demandé pourquoi vos adresses emails sont sur autant
- de mailing listes de spam ? Une façon pour les spammers de récupérer les
- 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 cela ne gêne l'affichage sur le
- navigateur Web. Cela est fait grâce au plugin mailto.
- </para>
-<example>
-<title>exemple de dissimulation d'une adresse email</title>
+ </example>
+ </sect1>
+ <sect1 id="tips.obfuscating.email">
+ <title>Dissimuler les adresses email</title>
+ <para>
+ Vous-êtes vous déjà demandé pourquoi vos adresses emails sont sur autant
+ de mailing listes de spam ? Une façon pour les spammers de récupérer les
+ 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 cela ne gêne l'affichage sur le
+ navigateur Web. Cela est fait grâce au plugin mailto.
+ </para>
+ <example>
+ <title>exemple de dissimulation d'une adresse email</title>
<programlisting>
index.tpl
@@ -332,34 +336,34 @@
{mailto address=$EmailAddress encode="javascript" subject="Hello"}
</programlisting>
-</example>
+ </example>
<note>
- <title>Note technique</title>
- <para>
- Cette méthode n'est pas infaillible. Un spammer peut programmer son
- collecteur d'email pour passer outre cette astuce, mais c'est cependant
- peu probable.
- </para>
+ <title>Note technique</title>
+ <para>
+ Cette méthode n'est pas infaillible. Un spammer peut programmer son
+ collecteur d'email pour passer outre cette astuce, mais c'est cependant
+ peu probable.
+ </para>
</note>
- </sect1>
-</chapter>
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
+ </sect1>
+ </chapter>
+ <!-- Keep this comment at the end of the file
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"../../../../manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
+ -->
http://cvs.php.net/diff.php/smarty/docs/fr/appendixes/troubleshooting.xml?r1=1.1&r2=1.2&ty=u
Index: smarty/docs/fr/appendixes/troubleshooting.xml
diff -u smarty/docs/fr/appendixes/troubleshooting.xml:1.1 smarty/docs/fr/appendixes/troubleshooting.xml:1.2
--- smarty/docs/fr/appendixes/troubleshooting.xml:1.1 Sun Mar 28 10:18:13 2004
+++ smarty/docs/fr/appendixes/troubleshooting.xml Sun May 23 11:49:55 2004
@@ -1,53 +1,54 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
<chapter id="troubleshooting">
- <title>Diagnostic des erreurs</title>
- <para></para>
- <sect1 id="smarty.php.errors">
- <title>Erreurs Smarty/PHP</title>
- <para>
- Smarty peut identifier de nombreuses erreurs comme des attributs de
- balises manquants ou de noms de variables malformés. Dans ce cas-là,
- vous verrez apparaître une erreur semblable à :
- </para>
-<example>
-<title>erreurs Smarty</title>
+ <title>Diagnostic des erreurs</title>
+ <para></para>
+ <sect1 id="smarty.php.errors">
+ <title>Erreurs Smarty/PHP</title>
+ <para>
+ Smarty peut identifier de nombreuses erreurs comme des attributs de
+ balises manquants ou de noms de variables malformés. Dans ce cas-là,
+ vous verrez apparaître une erreur semblable à :
+ </para>
+ <example>
+ <title>erreurs Smarty</title>
<programlisting>
Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah'
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</programlisting>
-</example>
-
- <para>
- Smarty vous indique le nom du template, le numéro de la ligne et l'erreur.
- Après cela, vous pouvez connaître le numéro de ligne où il y a eu erreur dans
- la définition de la classe Smarty.
- </para>
-
- <para>
- Il y a certaines erreurs que Smarty ne peut pas détecter, comme les
- balises fermantes manquantes. Ce type d'erreurs est la plupart du temps
- repéré dans la phase de compilation PHP du template compilé.
- </para>
-
-<example>
-<title>erreur d'analyse PHP</title>
+ </example>
+
+ <para>
+ Smarty vous indique le nom du template, le numéro de la ligne et l'erreur.
+ Après cela, vous pouvez connaître le numéro de ligne où il y a eu erreur dans
+ la définition de la classe Smarty.
+ </para>
+
+ <para>
+ Il y a certaines erreurs que Smarty ne peut pas détecter, comme les
+ balises fermantes manquantes. Ce type d'erreurs est la plupart du temps
+ repéré dans la phase de compilation PHP du template compilé.
+ </para>
+
+ <example>
+ <title>erreur d'analyse PHP</title>
<programlisting>
Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75</programlisting>
-</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 {if}{/if} ou {section}{/section} 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.
- </para>
- </sect1>
+ </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 {if}{/if} ou {section}{/section} 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.
+ </para>
+ </sect1>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
@@ -68,4 +69,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
+-->