From 5d7687ca04448e5446c0d11b96275c0014e6ce97 Mon Sep 17 00:00:00 2001 From: yannick Date: Sat, 10 Dec 2005 22:09:38 +0000 Subject: [PATCH] sync with EN --- .../language-function-if.xml | 35 +- .../language-function-include.xml | 9 +- .../language-function-section.xml | 615 +++++++++++------- .../language-function-strip.xml | 26 +- .../language-assigned-variables.xml | 75 ++- .../language-config-variables.xml | 14 +- .../language-variables-smarty.xml | 66 +- docs/fr/getting-started.xml | 114 ++-- 8 files changed, 588 insertions(+), 366 deletions(-) diff --git a/docs/fr/designers/language-builtin-functions/language-function-if.xml b/docs/fr/designers/language-builtin-functions/language-function-if.xml index bee85944..e93029ba 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-if.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-if.xml @@ -1,6 +1,6 @@ - + {if},{elseif},{else} @@ -16,6 +16,11 @@ &&, and, is_array(), etc. + + Si $security est actif, + alors le tableau IF_FUNCS dans le tableau + $security_settings (?!). + La liste suivante présente les opérateurs reconnus, qui doivent être entourés d'espaces. Remarquez que les éléments listés entre [crochets] sont optionnels. Les équivalents @@ -162,13 +167,6 @@ ... {/if} -{* l'exemple suivant NE fonctionne PAS, les opérateurs -doivent être entourés d'espaces. *} -{if $name=="Fred" || $name=="Wilma"} - ... -{/if} - - {* les parenthèses sont autorisées *} {if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#} ... @@ -179,6 +177,16 @@ doivent ... {/if} +{* Vérifie si c'est un tableau. *} +{if is_array($foo) } +..... +{/if} + +{* Vérifie si la variable est nulle. *} +{if isset($foo) } + ..... +{/if} + {* teste si les valeurs sont paires(even) ou impaires(odd) *} {if $var is even} ... @@ -206,17 +214,6 @@ doivent ... {/if} -{* ------- if avec des fonctions PHP ------- *} -{* check for array. *} -{if is_array($foo) } -..... -{/if} - -{* vérification du tableau. *} -{if isset($foo) } -..... -{/if} - ]]> diff --git a/docs/fr/designers/language-builtin-functions/language-function-include.xml b/docs/fr/designers/language-builtin-functions/language-function-include.xml index bff904d8..11d1beaa 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-include.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-include.xml @@ -1,6 +1,6 @@ - + {include} @@ -17,6 +17,13 @@ qui définit une variable de template dans laquelle la sortie de {include} sera stockée plutôt qu'affichée. + + Toutes les valeurs des variables assignées sont restaurées lorsque + le template inclus est terminé. Ceci signifie que vous pouvez utiliser + toutes les variables d'un template inclus dans le template qui l'inclut. + Mais les modifications des variables dans le template inclus ne sont pas + visibles dans le template qui l'inclut après l'instruction {include}. + diff --git a/docs/fr/designers/language-builtin-functions/language-function-section.xml b/docs/fr/designers/language-builtin-functions/language-function-section.xml index 8f90042f..1813f487 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-section.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-section.xml @@ -1,8 +1,26 @@ - + + - section, sectionelse + {section},{sectionelse} + + Les balises section sont utilisées pour + parcourir un tableau de données + (tout comme {foreach}). + Toutes les balises {section} doivent être utilisées + de paire avec les balises {/section}. Les paramètres + requis sont name et loop. + Le nom de la {section} est, selon votre choix, composé de lettres, + chiffres et underscores. Les sections peuvent être imbriquées, + mais leurs noms doivent être uniques. La variable de parcours + (généralement un tableau de données) détermine le nombre de fois + que la section sera parcourue. Lorsque l'on affiche une variable + dans une section, le nom de la section doit précéder + la variable entre crochets []. {sectionelse} + est exécuté lorsqu'aucune valeur n'est trouvée dans la variable à + parcourir. + @@ -76,29 +94,30 @@ - - Les balises section sont utilisées pour - parcourir un tableau de données. Toutes les balises - {section} doivent être utilisées de paire avec - les balises {/section}. Les paramètres requis - sont name et loop. - Le nom de la {section} est, selon votre choix, composé de lettres, - chiffres et underscores. Les sections peuvent être imbriquées, - mais leurs noms doivent être uniques. La variable de parcours - (généralement un tableau de données) détermine le nombre de fois - que la section sera parcourue. Lorsque l'on affiche une variable - dans une section, le nom de la section doit précéder - la variable entre crochets. {sectionelse} - est exécuté lorsqu'aucune valeur n'est trouvée dans la variable à - parcourir. - + - section + {section} + + +assign('custid',$data); + +?> +]]> + +{* Cet exemple affiche toutes les valeurs du tableau $custid *} +{section name=customer loop=$custid} + id: {$custid[customer]}
+{/section} +
+{* Affiche toutes les valeurs du tableau $custid dans le sens inverse *} +{section name=foo loop=$custid step=-1} + {$custid[foo]}
{/section} ]]>
@@ -110,23 +129,69 @@ id: 1000
id: 1001
id: 1002
+
+id: 1002
+id: 1001
+id: 1000
+]]> + + + Voici d'autres exemples sans tableaux assignés. + + + +{section name=bar loop=21 max=6 step=-2} +{$smarty.section.bar.index} +{/section} +]]> + + + L'exemple ci-dessus affichera : + + + +20 18 16 14 12 10 ]]>
- section, variable de parcours + {section}, variable de parcours + +assign('custid',$id); + +$fullnames = array('John Smith','Jack Jones','Jane Munson'); +$smarty->assign('name',$fullnames); + +$addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st'); +$smarty->assign('address',$addr); + +?> +]]> + - nom: {$noms[client]}
- addresse: {$addresses[client]}
+ id : {$custid[customer]}
+ nom : {$name[customer]}
+ addresse : {$address[customer]}

{/section} ]]> @@ -136,33 +201,39 @@ id: 1002
-nom: John Smith
-addresse: 253 N 45th

-id: 1001
-nom: Jack Jones
-addresse: 417 Mulberry ln
+ id : 1000
+ nom : John Smith
+ addresse : 253 N 45th +

-id: 1002
-nom: Jane Munson
-addresse: 5605 apple st
+ id : 1001
+ nom : Jack Jones
+ addresse : 417 Mulberry ln +

+ id : 1002
+ nom : Jane Munson
+ addresse : 5605 apple st +

]]>
- nom de section + nom de {section} id: {$idCLient[monTableau]}
name: {$noms[monTableau]}
- address: {$addresses[monTableau]}
-

+ address: {$addresses[monTableau]} +

{/section} ]]>
@@ -170,21 +241,53 @@ addresse: 5605 apple st
sections imbriquées + +assign('custid',$id); + +$fullnames = array('John Smith','Jack Jones','Jane Munson'); +$smarty->assign('name',$fullnames); + +$addr = array('253 N 45th', '417 Mulberry ln', '5605 apple st'); +$smarty->assign('address',$addr); + +$types = array( + array( 'home phone', 'cell phone', 'e-mail'), + array( 'home phone', 'web'), + array( 'cell phone') +); +$smarty->assign('contact_type', $types); + +$info = array( + array('555-555-5555', '666-555-5555', 'john@myexample.com'), + array( '123-456-4', 'www.example.com'), + array( '0457878') +); +$smarty->assign('contact_info', $info); + +?> +]]> + id: {$idClient[client]}
nom: {$nom[client]}
addresse: {$addresse[client]}
{section name=contact loop=$type_contact[client]} {$type_contact[client][contact]}: {$info_contact[client][contact]}
{/section} -

{/section} ]]> @@ -193,41 +296,63 @@ addresse: 5605 apple st
id: 1000
nom: John Smith
addresse: 253 N 45th
telephone: 555-555-5555
telephone portable: 555-555-5555
e-mail: john@myexample.com
-

+


id: 1001
nom: Jack Jones
addresse: 417 Mulberry ln
telephone: 555-555-5555
telephone portable: 555-555-5555
e-mail: jack@myexample.com
-

+


id: 1002
nom: Jane Munson
addresse: 5605 apple st
telephone: 555-555-5555
telephone portable: 555-555-5555
e-mail: jane@myexample.com
-

+


]]>
Sections et tableaux associatifs + + 'John Smith', 'home' => '555-555-5555', + 'cell' => '666-555-5555', 'email' => 'john@myexample.com'), + array('name' => 'Jack Jones', 'home' => '777-555-5555', + 'cell' => '888-555-5555', 'email' => 'jack@myexample.com'), + array('name' => 'Jane Munson', 'home' => '000-555-5555', + 'cell' => '123456', 'email' => 'jane@myexample.com') +); +$smarty->assign('contacts',$data); + +?> +]]> + nom: {$contacts[client].name}
telephone: {$contacts[client].home}
portable: {$contacts[client].cell}
- e-mail: {$contacts[client].email}

+ e-mail: {$contacts[client].email} +

{/section} ]]>
@@ -236,24 +361,62 @@ e-mail: jane@myexample.com
nom: John Smith
telephone: 555-555-5555
portable: 555-555-5555
-e-mail: john@myexample.com

+e-mail: john@myexample.com +

+

nom: Jack Jones
telephone: 555-555-5555
portable: 555-555-5555
-e-mail: jack@myexample.com

+e-mail: jack@myexample.com +

+

nom: Jane Munson
telephone: 555-555-5555
portable: 555-555-5555
e-mail: jane@myexample.com

+

]]>
+ Exemple avec une base de données (eg. en utilisant Pear ou Adodb) + +assign('contacts',$db->getAll($sql) ); + +?> +]]> + + + + +  Name>HomeCellEmail + {section name=co loop=$contacts} + + view + {$contacts[co].name} + {$contacts[co].home} + {$contacts[co].cell} + {$contacts[co].email} + + {/section} + +]]> + + - sectionelse + {sectionelse} {$smarty.section.sectionname.varname} - NOTE: Depuis Smarty 1.5.0, la syntaxe pour les propiétés des sections + Depuis Smarty 1.5.0, la syntaxe pour les propriétés des sections a été changée de {%sectionname.varname%} à {$smarty.section.nomSection.nomVariable}. L'ancienne syntaxe est toujours supportée, mais vous ne verrez que des exemples avec la nouvelle syntaxe dans le manuel. + index Index est utilisé pour afficher l'index de parcours courant, commence par - 0 (ou l'attribut start), et s'incrémente de 1 (ou de la valeur - de l'attribut step). + 0 (ou l'attribut start s'il est fourni), et s'incrémente de 1 (ou de la valeur + de l'attribut step s'il est fourni). Note technique Si les attributs step et start ne sont pas modifiés, alors index - fonctionne de la même façon que iteration, à l'exception qu'il commence par 0 plutôt que par 1. - propriété de section index - + propriété de {section} index + + {$smarty.section.client.index} id: {$idClient[client]}
{/section} ]]>
@@ -307,47 +473,22 @@ e-mail: jane@myexample.com

- 1 id: 1001
- 2 id: 1002
+0 id: 1000
+1 id: 1001
+2 id: 1002
]]>
+ index_prev index_prev est utilisé pour afficher l'index de parcours précédent de la boucle. Au premier passage, il vaut -1. - - propriété de section index_prev - - - {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} - {if $idClient[client.index_prev] ne $idClient[client.index]} - L'id du client à été modifié
- {/if} - {/section} -]]> -
- - L'exemple ci-dessus affichera : - - - - L'id du client à été modifié
- 1 id: 1001
- L'id du client à été modifié
- 2 id: 1002
- L'id du client à été modifié
-]]> -
-
+ index_next @@ -355,17 +496,37 @@ e-mail: jane@myexample.com

index. Dans la dernière boucle, celà reste la valeur incrémentée, qui respecte l'attribut step si donné. + - propriété de section index_next - + propriété de {section} index_next et index_prev + - {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} - {if $idClient[client.index_next] ne $idClient[client.index]} - L'id du client va changer
- {/if} - {/section} +assign('custid',$data); + +?> +]]> +
+ + + + indexid + index_prevprev_id + index_nextnext_id + + {section name=cus loop=$custid} + + {$smarty.section.cus.index}{$custid[cus]} + {$smarty.section.cus.index_prev}{$custid[cus.index_prev]} + {$smarty.section.cus.index_next}{$custid[cus.index_next]} + + {/section} + ]]> @@ -373,16 +534,17 @@ e-mail: jane@myexample.com

- L'id du client va changer
- 1 id: 1001
- L'id du client va changer
- 2 id: 1002
- L'id du client va changer
+index id index_prev prev_id index_next next_id +0 1001 -1 1 1002 +1 1002 0 1001 2 1003 +2 1003 1 1002 3 1004 +3 1004 2 1003 4 1005 +4 1005 3 1004 5 ]]>
+ iteration @@ -397,17 +559,25 @@ e-mail: jane@myexample.com

ils fonctionnent de la même façon. - propriété iteration de section + propriété iteration de {section} + +assign('custid',$id); + +?> +]]> + - {$smarty.section.client.index} id: {$idClient[client]}
- {* Pour votre information, $idClient[client.index] and $idClient[client] sont identiques *} - {if $idCLient[client.index_next] ne $idClient[client.index]} - L'id du client va changer
- {/if} - {/section} +{section name=cu loop=$custid start=5 step=2} + iteration={$smarty.section.cu.iteration} + index={$smarty.section.cu.index} + id={$custid[cu]}
+{/section} ]]>
@@ -415,93 +585,84 @@ e-mail: jane@myexample.com

- L'id du client va changer
- Iteration courante: 2 - 7 id: 1001
- L'id du client va changer
- Iteration courante: 3 - 9 id: 1002
- L'id du client va changer
+iteration=1 index=5 id=3005
+iteration=2 index=7 id=3007
+iteration=3 index=9 id=3009
+iteration=4 index=11 id=3011
+iteration=5 index=13 id=3013
+iteration=6 index=15 id=3015
]]>
+ + Cet exemple utilise la propriété iteration pour afficher + un block d'en-tête de tableau toutes les cinq lignes + (utilisez {if} + avec l'opérateur mod). + + + + {section name=co loop=$contacts} + {if $smarty.section.co.iteration % 5 == 1} +  Name>HomeCellEmail + {/if} + +
view + {$contacts[co].name} + {$contacts[co].home} + {$contacts[co].cell} + {$contacts[co].email} + + {/section} + +]]> + + first first est à true lorsque la section est parcouru pour la première fois. - - propriété first de la section - - - {/if} - - {$smarty.section.client.index} id: - {$idClient[client]} - - {if $smarty.section.client.last} - - {/if} - {/section} -]]> - - - L'exemple ci-dessus affichera : - - - - 0 id: 1000 - 1 id: 1001 - 2 id: 1002 - -]]> - - + last last est à true lorsque la section est parcourue pour la dernière fois. - Propriété last de section + Propriété last et first de {section} + + Cet exemple boucle le tableau $customers ; + affiche un block d'en-tête lors de la première itération et, + à la dernière, affiche un block de pied de page + (utilisation de la propriété total) + - {/if} +{section name=customer loop=$customers} +{if $smarty.section.customer.first} + + + {/if} - + + + + - {if $smarty.section.client.last} -
idcustomer
{$smarty.section.client.index} id: - {$idClient[client]}
{$customers[customer].id}}{$customers[customer].name}
- {/if} - {/section} + {if $smarty.section.customer.last} + {$smarty.section.customer.total} customers + +{/if} +{/section} ]]> -
- - L'exemple ci-dessus affichera : - - - - 0 id: 1000 - 1 id: 1001 - 2 id: 1002 - -]]> - +
+ rownum @@ -510,27 +671,8 @@ e-mail: jane@myexample.com

linkend="section.property.iteration">iteration, ils fonctionnent de façon identique. - - propriété rownum de section - - - {/section} -]]> - - - L'exemple ci-dessus affichera : - - - - 2 id: 1001
- 3 id: 1002
-]]> -
-
+ loop @@ -538,14 +680,14 @@ e-mail: jane@myexample.com

section a utilisé. Peut être utilisé dans ou en dehors de la section. - Propriété de section index - + Propriété de {section} index + - {/section} +{/section} - Il y eu {$smarty.section.client.loop} clients d'affichés. +Il y eu {$smarty.section.client.loop} clients d'affichés. ]]> @@ -553,38 +695,41 @@ e-mail: jane@myexample.com

- 1 id: 1001
- 2 id: 1002
+0 id: 1000
+1 id: 1001
+2 id: 1002
- il y eu 3 clients d'affichés. +Il y eu 3 clients d'affichés. ]]>
+ show show est utilisé comme paramètre de section. show est une valeur booléenne, true ou false. Si show est à "false", la section ne sera pas affichée. Si un - sectionelse est présent, elle sera affiché. + {sectionelse} est présent, elle sera affichée. - section, attribut show + {section}, attribut show - {/section} +{/section} - {if $smarty.section.client.show} - la section à été affichée. - {else} - la section n'a pas été affichée. - {/if} +{if $smarty.section.client.show} + la section a été affichée. +{else} + la section n'a pas été affichée. +{/if} ]]> @@ -592,30 +737,31 @@ e-mail: jane@myexample.com

- 2 id: 1001
- 3 id: 1002
+1 id: 1000
+2 id: 1001
+3 id: 1002
- la section à été affichée. +la section a été affichée. ]]>
+ total - total est utilisé pour afficher le nombre d'itération que la section + total est utilisé pour afficher le nombre d'itération que la section va exécuter. Peut être utilisé dans ou en dehors de la section. - section, propriété total + {section}, propriété <literal>total</literal> - {/section} +{section name=client loop=$idClient step=2} + {$smarty.section.client.index} id: {$idClient[client]}
+{/section} - Il y eu {$smarty.section.client.total} clients affichés. +Il y eu {$smarty.section.client.total} clients affichés. ]]>
@@ -623,21 +769,22 @@ e-mail: jane@myexample.com

- 2 id: 1001
- 4 id: 1002
+0 id: 1000
+2 id: 1001
+4 id: 1002
- Il y eu 3 clients affichés. +Il y eu 3 clients affichés. ]]>
- Voir aussi + Voir aussi {foreach} et $smarty.section. + +--> \ No newline at end of file diff --git a/docs/fr/designers/language-builtin-functions/language-function-strip.xml b/docs/fr/designers/language-builtin-functions/language-function-strip.xml index 65742c93..0381c2a3 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-strip.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-strip.xml @@ -1,8 +1,9 @@ - + + - strip + {strip} Il est fréquent que les designers web rencontrent des problèmes dus aux espaces et retours chariots, qui affectent le rendu HTML @@ -13,7 +14,7 @@ Tout contenu situé entre les balises {strip}{/strip} se verra allégé des espaces superflus et des retours chariots en début ou en fin - de ligne, avant qu'il ne soit affichés. De la sorte, vous pouvez + de ligne, avant qu'il ne soit affiché. De la sorte, vous pouvez conserver vos templates lisibles, sans vous soucier des effets indésirables que peuvent apporter les espaces superflus. @@ -21,8 +22,8 @@ Note technique {strip}{/strip} n'affecte en aucun cas le contenu des variables de - template. Voir le modificateur - strip pour un rendu identique pour les variables. + template. Voir aussi le modificateur + strip pour un rendu identique pour les variables. @@ -31,12 +32,12 @@ +
- + Un test - +
@@ -48,7 +49,7 @@
Un test +
Un test
]]> @@ -59,7 +60,12 @@ au suivant/précédent et risque de ne pas être affiché selon l'effet désiré. + + Voir aussi + le modificateur strip. + + +--> \ No newline at end of file diff --git a/docs/fr/designers/language-variables/language-assigned-variables.xml b/docs/fr/designers/language-variables/language-assigned-variables.xml index 37a6988b..c6888c3e 100644 --- a/docs/fr/designers/language-variables/language-assigned-variables.xml +++ b/docs/fr/designers/language-variables/language-assigned-variables.xml @@ -1,10 +1,11 @@ - + + Variables assignées depuis PHP - Pour utiliser une variables assignées depuis PHP, il + Pour utiliser une variables assignées depuis PHP, il faut la préfixer par le symbole dollar $. Les variables asignées depuis un template grâce à la fonction {assign} sont @@ -12,21 +13,44 @@ Variables assignées - + Script PHP + -La dernière connexion remonte au {$dateConnexionPrecedente}. +assign('firstname', 'Doug'); +$smarty->assign('lastname', 'Evans'); +$smarty->assign('meetingPlace', 'New York'); + +$smarty->display('index.tpl'); + +?> ]]> - - - Celà va afficher: - + + + où index.tpl est : + + + +{* ceci ne fonctionnera pas car $vars est sensible à la casse *} +Cette semaine, le meeting est à {$meetingplace}. +{* ceci fonctionnera *} +Cette semaine, le meeting est à {$meetingPlace}. +]]> + + + Celà va afficher: + -La dernière connexion remonte au 11 janvier 2001. +
+Cette semaine, le meeting est à . +Cette semaine, le meeting est à New York. ]]>
@@ -44,12 +68,13 @@ La derni assign('Contacts', array('fax' => '555-222-9876', - 'email' => 'zaphod@slartibartfast.com', + 'email' => 'zaphod@slartibartfast.example.com', 'phone' => array('home' => '555-444-3333', - 'cell' => '555-111-1234'))); + 'cell' => '555-111-1234') + ) + ); $smarty->display('index.tpl'); ?> ]]> @@ -72,7 +97,7 @@ $smarty->display('index.tpl'); -zaphod@slartibartfast.com
+zaphod@slartibartfast.example.com
555-444-3333
555-111-1234
]]> @@ -91,12 +116,12 @@ zaphod@slartibartfast.com
assign('Contacts', - array('555-222-9876', - 'zaphod@slartibartfast.com', - array('555-444-3333', - '555-111-1234'))); +$smarty->assign('Contacts', array( + '555-222-9876', + 'zaphod@slartibartfast.example.com', + array('555-444-3333', + '555-111-1234') + )); $smarty->display('index.tpl'); ?> ]]> @@ -119,7 +144,7 @@ $smarty->display('index.tpl'); -zaphod@slartibartfast.com
+zaphod@slartibartfast.example.com
555-444-3333
555-111-1234
]]> @@ -142,12 +167,12 @@ email: {$person->email}
]]>
- Ce qui donne en sortie : + Ce qui donne en sortie : -email: zaphod@slartibartfast.com
+email: zaphod@slartibartfast.example.com
]]>
diff --git a/docs/fr/designers/language-variables/language-config-variables.xml b/docs/fr/designers/language-variables/language-config-variables.xml index e049c6a0..426f9144 100644 --- a/docs/fr/designers/language-variables/language-config-variables.xml +++ b/docs/fr/designers/language-variables/language-config-variables.xml @@ -1,6 +1,7 @@ - + + Variables chargées depuis des fichiers de configuration @@ -93,6 +94,17 @@ rowBgColor = "#cccccc" variables et les variables réservées $smarty. + + Les variables des fichiers de configuration ne peuvent pas être utilisées + tant qu'elles n'ont pas été chargées depuis un fichier de configuration. Cette procédure + est expliqué plus loin dans cette documentation sous la section + {config_load}. + + + Voir aussi + les variables et + les variables réservées $smarty. + - + + Variable réservée {$smarty} - La variable réservée {$smarty} peut être utilisée pour accéder à plusieurs + La variable PHP réservée {$smarty} peut être utilisée pour accéder à plusieurs variables spéciales du template. En voici la liste complète. Variables de requête - Les variables de requête comme GET, POST, COOKIES, SERVER, ENVIRONNEMENT - et SESSION peuvent être utilisées comme dans l'exemple suivant: + Les variables de requête + comme $_GET, $_POST, $_COOKIE, $_SERVER, $_ENV and $_SESSION + (voir $request_vars_order + et $request_use_auto_globals) + peuvent être utilisées comme dans l'exemple suivant: Afficher des variables de requête + + + Pour des raisons historiques, {$SCRIPT_NAME} peut être accédé + directement, cependant, {$smarty.server.SCRIPT_NAME} est + la solution proposée pour accéder à cette valeur. + + {$smarty.now} - Le timestamp courant peut être récupéré grâce à {$smarty.now}. + Le timestamp + courant peut être récupéré grâce à {$smarty.now}. Le nombre obtenu correspond au nombre de secondes écoulées depuis Epoch (1 Janvier 1970) et peut être passé directement au modificateur de variable date date_format à des fins d'affichage. - utilisation de {$smarty.now} + Utilisation de {$smarty.now} + {$smarty.const} Vous pouvez directement accéder aux constantes PHP. - Voir aussi les constantes smarty. + Voir aussi les constantes smarty. Utiliser {$smarty.const} @@ -82,7 +94,7 @@ {$smarty.capture} - La capture réalisée via + La capture réalisée via {capture}..{/capture} peut être récupérée par l'intermédiaire de la variable {$smarty}. Voir la section sur {capture} pour un @@ -93,11 +105,10 @@ {$smarty.config} - La variable {$smarty} peut être utilisée pour désigner une variable - d'un fichier de configuration. {$smarty.config.foo} est un synonyme de - {#foo#}. Voir la section {config_load} + La variable {$smarty} peut être utilisée pour désigner une + variable d'un fichier de configuration. + {$smarty.config.foo} est un synonyme de {#foo#}. Voir la section + {config_load} pour un exemple à ce sujet. @@ -118,17 +129,24 @@ Cette variable contient le nom du template en cours de traitement. + + + {$smarty.version} + + Cette variable contient la version de Smarty utilisée pour compiler un template. + + + {$smarty.ldelim}, {$smarty.rdelim} Cette variable est utilisée pour afficher le délémiteur gauche et le délimiteur droit. Lisez aussi - la partie {ldelim},{rdelim}. + la partie {ldelim},{rdelim}. - Voir aussi les - variables et les - variables de configuration. + Voir aussi + les variables et + les variables de configuration. diff --git a/docs/fr/getting-started.xml b/docs/fr/getting-started.xml index 03e90e23..dffcbe57 100644 --- a/docs/fr/getting-started.xml +++ b/docs/fr/getting-started.xml @@ -1,6 +1,7 @@ - + + Pour commencer @@ -155,7 +156,7 @@ Installation de base - Copiez les fichiers bibliothèques de Smarty du répertoire + 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 modifier. Ils sont partagés par toutes les applications et ne seront @@ -177,18 +178,18 @@ debug.tpl - Smarty utilise une constante PHP appelée constante PHP appelée SMARTY_DIR qui - représente le chemin complet de la bibliothèque Smarty. En fait, + représente le chemin complet de la bibliothèque Smarty. En fait, si votre application trouve le fichier Smarty.class.php, vous n'aurez pas - besoin de définir la variable SMARTY_DIR, + besoin de définir la variable SMARTY_DIR, Smarty s'en chargera pour vous. En revanche, si Smarty.class.php 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 - doit avoir être terminé par un slash. + doit avoir être terminé par un slash. @@ -200,8 +201,9 @@ debug.tpl ]]> @@ -214,40 +216,50 @@ $smarty = new Smarty; - fournir un chemin absolu vers la bibliothèque Smarty + Définition manuelle de la constante SMARTY_DIR ]]> - Ajouter le répertoire de la bibliothèque dans l'include_path de PHP + Définir le chemin absolu au fichier de la bibliothèque ]]> - Définir explicitement la constante SMARTY_DIR + Ajout du dossier contenant la bibliothèque à l'include_path de PHP ]]> @@ -258,7 +270,7 @@ $smarty = new Smarty; il est temps de définir les répertoires de Smarty, pour votre application. - Smarty a besoin de quatre répertoires qui sont (par défaut) + Smarty a besoin de quatre répertoires qui sont, par défaut, 'templates/', 'templates_c/', 'configs/' et @@ -332,19 +344,19 @@ $smarty = new Smarty; Exemple de structure de fichiers @@ -389,7 +401,7 @@ chmod 770 /web/www.example.com/smarty/livredor/cache/ Nous devons créer le fichier 'index.tpl' que Smarty va charger. - Il va se trouver dans $template_dir. + Il va se trouver dans le dossier $template_dir. @@ -399,7 +411,7 @@ chmod 770 /web/www.example.com/smarty/livredor/cache/ {* Smarty *} -Hello, {$name}! +Bonjour, {$name}, Bienvenue dans Smarty ! ]]>
@@ -419,34 +431,32 @@ Hello, {$name}! Maintenant passons à l'édition du fichier 'index.php'. Nous allons - créer une instance de Smarty, assigner une valeur à une variable - de template et afficher le résultat avec 'index.tpl'. Dans notre - exemple d'environnement, "/usr/local/lib/php/Smarty" est dans notre - include_path. Assurez-vous de faire la même chose ou d'utiliser - des chemins absolus. + créer une instance de Smarty, assigner + une valeur à une variable de template et + afficher le résultat avec 'index.tpl'. Édition de /web/www.example.com/docs/livredor/index.php - + template_dir = '/web/www.example.com/smarty/livredor/templates/'; - $smarty->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/'; - $smarty->config_dir = '/web/www.example.com/smarty/livredor/configs/'; - $smarty->cache_dir = '/web/www.example.com/smarty/livredor/cache/'; +$smarty->template_dir = '/web/www.example.com/smarty/livredor/templates/'; +$smarty->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/'; +$smarty->config_dir = '/web/www.example.com/smarty/livredor/configs/'; +$smarty->cache_dir = '/web/www.example.com/smarty/livredor/cache/'; - $smarty->assign('name','Ned'); +$smarty->assign('name','Ned'); - $smarty->display('index.tpl'); +$smarty->display('index.tpl'); ?> ]]> - + @@ -465,7 +475,7 @@ Hello, {$name}! Et maintenant appelez le fichier index.php avec navigateur - Web. Vous devriez voir "Hello, Ned!". + Web. Vous devriez voir "Bonjour, Ned, Bienvenue dans Smarty !". Vous venez de terminer l'installation de base de Smarty !