cvs: smarty /docs/fr/designers/language-builtin-functions language-function-include-php.xml language-function-include.xml language-function-insert.xml language-function-ldelim.xml language-function-literal.xml language-function-php.xml
"Yannick Torres" <[email protected]> Sun, 01 Oct 2006 11:18:39 -0000
| Newsgroups | gmane.comp.php.cvs.smarty |
|---|---|
| Message-ID | <cvsyannick1159701519@cvsserver> |
yannick Sun Oct 1 11:18:39 2006 UTC
Modified files:
/smarty/docs/fr/designers/language-builtin-functions
language-function-include-php.xml
language-function-include.xml
language-function-insert.xml
language-function-ldelim.xml
language-function-literal.xml
language-function-php.xml
Log:
sync with EN
--
Smarty CVS Mailing List (http://cvs.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
yannick-20061001111839.txt
(text/plain, 27.7 KB)
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml:1.10 smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml:1.11
--- smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml:1.10 Sat Feb 18 17:54:23 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml Sun Oct 1 11:18:39 2006
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.10 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
<sect1 id="language.function.include.php">
<title>{include_php}</title>
@@ -8,13 +8,13 @@
<note>
<title>Notes techniques</title>
<para>
- {include_php} est presque obsolète dans Smarty. Vous pouvez obtenir des résultats
- équivalents en utilisant les fonctions utilisateur.
- La seule raison qui peut vous pousser à utiliser {include_php} est que
- vous avez besoin de mettre une de vos fonction en quarantaine vis à vis du
- répertoire des <link linkend="variable.plugins.dir">plugins</link> ou de votre application.
- Reportez-vous à l'exemple des
- <link linkend="tips.componentized.templates"> templates composants</link>
+ <varname>{include_php}</varname> est presque obsolète dans Smarty.
+ Vous pouvez obtenir des résultats équivalents en utilisant les fonctions utilisateur.
+ La seule raison qui peut vous pousser à utiliser <varname>{include_php}</varname>
+ est que vous avez besoin de mettre une de vos fonction en quarantaine vis à vis du
+ répertoire <link linkend="variable.plugins.dir"><filename>plugins/</filename></link>
+ ou de votre application. Reportez-vous à l'exemple des
+ <link linkend="tips.componentized.templates">templates composants</link>
pour plus de détails.
</para>
</note>
@@ -47,7 +47,7 @@
<entry>once</entry>
<entry>boléen</entry>
<entry>Non</entry>
- <entry><emphasis>true</emphasis></entry>
+ <entry><emphasis>&true;</emphasis></entry>
<entry>Inclure plusieurs fois ou non le fichier PHP si
plusieurs demandes d'inclusions sont faîtes.</entry>
</row>
@@ -64,33 +64,35 @@
</informaltable>
<para>
- Les balises {include_php} sont utilisées pour inclure directement
- un script PHP dans vos templates. Si <link linkend="variable.security">$security</link> est activé,
- alors le script à exécuter doit être placé dans le chemin <link
- linkend="variable.trusted.dir">$trusted_dir</link>. La balise
- {include_php} attends l'attribut "file", qui contient le chemin du
- fichier PHP à inclure, relatif à <link linkend="variable.trusted.dir">$trusted_dir</link>, ou absolu.
+ Les balises <varname>{include_php}</varname> sont utilisées pour inclure directement
+ un script PHP dans vos templates. Si
+ <link linkend="variable.security"><parameter>$security</parameter></link> est activé,
+ alors le script à exécuter doit être placé dans le chemin
+ <link linkend="variable.trusted.dir"><parameter>$trusted_dir</parameter></link>. La balise
+ <varname>{include_php}</varname> attends l'attribut <parameter>file</parameter>,
+ qui contient le chemin du fichier PHP à inclure, relatif à
+ <link linkend="variable.trusted.dir"><parameter>$trusted_dir</parameter></link>, ou absolu.
</para>
<para>
Par défaut, les fichiers PHP ne sont inclus qu'une seule fois, même si
la demande d'inclusion survient plusieurs fois dans le template.
Vous pouvez demander à ce que ce fichier soit inclus à chaque demande
- grâce à l'attribut <emphasis>once</emphasis>. Mettre l'attribut once à
- false aura pour effet d'inclure le script PHP à chaque fois que demandé
+ grâce à l'attribut <parameter>once</parameter>. Mettre l'attribut once à
+ &false; aura pour effet d'inclure le script PHP à chaque fois que demandé
dans le template.
</para>
<para>
Vous pouvez donner une valeur à l'attribut optionnel
- <emphasis>assign</emphasis>, pour demander à la fonction
- <emphasis>{include_php}</emphasis> d'assigner la sortie du script PHP
+ <parameter>assign</parameter>, pour demander à la fonction
+ <varname>{include_php}</varname> d'assigner la sortie du script PHP
à la variable spécifiée plutôt que d'en afficher directement le résultat.
</para>
<para>
- L'objet Smarty est disponible en tant que $this dans le script PHP inclus.
+ L'objet Smarty est disponible en tant que <parameter>$this</parameter> dans le script PHP inclus.
</para>
<example>
<title>Fonction {include_php}</title>
- <para>load_nav.php</para>
+ <para>Le template <filename>load_nav.php</filename></para>
<programlisting role="php">
<![CDATA[
<?php
@@ -105,14 +107,14 @@
]]>
</programlisting>
<para>
- Où index.tpl est :
+ Où le template est :
</para>
<programlisting>
<![CDATA[
{* chemin absolu, ou relatif à $trusted_dir *}
{include_php file='/chemin/vers/load_nav.php'}
-{foreach item="curr_section" from=$sections}
+{foreach item='curr_section' from=$sections}
<a href="{$curr_section.url}">{$curr_section.name}</a><br />
{/foreach}
]]>
@@ -121,11 +123,11 @@
<para>
Voir aussi
- <link linkend="language.function.include">{include}</link>,
- <link linkend="language.function.php">{php}</link>,
- <link linkend="language.function.capture">{capture}</link>, les
+ <link linkend="language.function.include"><varname>{include}</varname></link>,
+ <link linkend="language.function.php"><varname>{php}</varname></link>,
+ <link linkend="language.function.capture"><varname>{capture}</varname></link>, les
<link linkend="template.resources">ressources de template</link> et les
- <link linkend="tips.componentized.templates">"composants templates"</link>.
+ <link linkend="tips.componentized.templates">composants de templates</link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml?r1=1.12&r2=1.13&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml:1.12 smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml:1.13
--- smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml:1.12 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml Sun Oct 1 11:18:39 2006
@@ -1,31 +1,56 @@
<?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.14 Maintainer: yannick Status: ready -->
<sect1 id="language.function.include">
<title>{include}</title>
<para>
- Les balises "{include}" sont utilisées pour inclure des templates à
+ Les balises <varname>{include}</varname> sont utilisées pour inclure des templates à
l'intérieur d'autres templates. Toutes les variables disponibles
dans le template réalisant l'inclusion sont disponibles dans le
- template inclus. La balise {include} doit disposer de l'attribut
- <emphasis>'file'</emphasis>, qui contient le chemin de la
- ressource template.
- </para>
- <para>
- Vous pouvez spécifier un attribut optionnel <emphasis>'assign'</emphasis>
- qui définit une variable de template dans laquelle la sortie de
- {include} sera stockée plutôt qu'affichée.
- </para>
- <para>
- 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}.
+ template inclus.
</para>
+ <itemizedlist>
+ <listitem><para>
+ La balise <varname>{include}</varname> doit contenir l'attribut
+ <parameter>file</parameter> qui contient le chemin vers la ressource de
+ template.
+ </para></listitem>
+
+ <listitem><para>
+ La définition de l'attribut optionnel <parameter>assign</parameter>
+ spécifie la variable de template assignée à la sortie de
+ <varname>{include}</varname> au lieu d'être affichée. Similaire à
+ <link linkend="language.function.assign"><varname>{assign}</varname></link>.
+ </para></listitem>
+
+ <listitem><para>
+ Les variables peuvent être passées à des templates inclus comme
+ <link linkend="language.syntax.attributes">attributs</link>.
+ Toutes les variables explicitement passées à un template inclus
+ ne sont disponibles que dans le contexte du fichier inclus.
+ Les attributs de variables écrasent les variables courantes de template,
+ dans le cas où les noms sont les mêmes.
+ </para></listitem>
+
+ <listitem><para>
+ Toutes les valeurs de variables assignées sont restaurées une fois le contexte
+ du template inclus refermés. Ceci signifie que vous pouvez utiliser toutes les
+ variables depuis un template inclus dans le template inclus. Mais les modifications
+ faites aux variables dans le template inclus ne sont pas visibles dans le template
+ incluant, parès l'instruction <varname>{include}</varname> statement.
+ </para></listitem>
+
+ <listitem><para>
+ Utilisez la synthaxe pour les
+ <link linkend="template.resources">ressources de template</link> aux fichiers
+ <varname>{include}</varname> en dehors du dossier
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>.
+ </para></listitem>
+ </itemizedlist>
+
<informaltable frame="all">
<tgroup cols="5">
<colspec colname="param" align="center" />
@@ -69,9 +94,9 @@
</tgroup>
</informaltable>
<example>
- <title>fonction {include}</title>
+ <title>Exemple avec {include}</title>
<programlisting>
- <![CDATA[
+<![CDATA[
<html>
<head>
<title>{$title}</title>
@@ -79,8 +104,9 @@
<body>
{include file='page_header.tpl'}
- {* body of template goes here *}
- {include file='$tpl_name.tpl'} <-- remplace $tpl_name avec la valeur
+ {* Le corps du template va ici, la variable $tpl_name est remplacé par
+ une valeur, e.g.'contact.pl' *}
+ {include file='$tpl_name.tpl'}
{include file='page_footer.tpl'}
</body>
@@ -88,32 +114,26 @@
]]>
</programlisting>
</example>
- <para>
- Vous pouvez également passer des variables au template inclus
- sous forme d'<link linkend="language.syntax.attributes">attributs</link>.
- Les variables passées au template par ce moyen ne sont accessibles que
- dans la portée de ce dernier. Les variables passées en tant qu'attribut
- remplacent les variables déjà définies, qui auraient le même nom.
- </para>
<example>
- <title>fonction {include}, passage de variables</title>
+ <title>Fonction {include}, passage de variables</title>
<programlisting>
<![CDATA[
-{include file='header.tpl' title='Menu principal' table_bgcolor='#c0c0c0'}
-
-{* Le corps du template vient ici *}
-
-{include file='footer.tpl' logo='http://mon.example.com/logo.gif'}
+{include file='links.tpl' title='Newest links' links=$link_array}
+{* body of template goes here *}
+{include file='footer.tpl' foo='bar'}
]]>
</programlisting>
- <para>où header.tpl est :</para>
+ <para>Le template ci-dessus inclut l'exemple <filename>links.tpl</filename></para>
<programlisting>
- <![CDATA[
-<table border='1' width='100%' bgcolor='{$table_bgcolor|default:"#0000FF"}'>
- <tr><td>
- <h1>{$title}</h1>
- </td></tr>
-</table>
+<![CDATA[
+<div id="box">
+ <h3>{$title}{/h3>
+ <ul>
+ {foreach from=$links item=l}
+ .. faites quelques choses ici ...
+ </foreach}
+ </ul>
+</div>
]]>
</programlisting>
</example>
@@ -121,31 +141,24 @@
<example>
<title>{include} et assignement à une variable</title>
- <para>Cet exemple assigne le contenu de nav.tpl à la variable $navbar,
- qui est alors affichée en haut et en bas de la page.
+ <para>Cet exemple assigne le contenu de <filename>nav.tpl</filename> à la variable
+ <varname>$navbar</varname>, qui est alors affichée en haut et en bas de la page.
</para>
<programlisting>
<![CDATA[
<body>
{include file='nav.tpl' assign=navbar}
- {include file='header.tpl' title='Main Menu' table_bgcolor='#c0c0c0'}
+ {include file='header.tpl' title='Smarty is cool'}
{$navbar}
-
- {* body of template goes here *}
-
- {include file='footer.tpl' logo='http://my.example.com/logo.gif'}
+ {* le corps du template va ici *}
{$navbar}
+ {include file='footer.tpl'}
</body>
]]>
</programlisting>
</example>
- <para>
- Utilisez la syntaxe <link
- linkend="template.resources">ressource template</link> pour inclure
- des fichiers situés en dehors du répertoire $template_dir.
- </para>
<example>
- <title>fonction {include}, exemple de ressource template</title>
+ <title>Divers {include}, exemple de ressource template</title>
<programlisting>
<![CDATA[
{* chemin absolu *}
@@ -164,16 +177,19 @@
{include file="$module.tpl"}
{* ne fonctionne pas avec des simples guillemets ie aucun substitution de variables *}
{include file='$module.tpl'}
+
+{* include a multi $variable template - eg amber/links.view.tpl *}
+{include file="$style_dir/$module.$view.tpl"}
]]>
</programlisting>
</example>
<para>
Voir aussi
- <link linkend="language.function.include.php">{include_php}</link>,
- <link linkend="language.function.insert">{insert}</link>,
- <link linkend="language.function.php">{php}</link>,
- <link linkend="template.resources">les ressources de template</link> et
- <link linkend="tips.componentized.templates">les templates composants</link>.
+ <link linkend="language.function.include.php"><varname>{include_php}</varname></link>,
+ <link linkend="language.function.insert"><varname>{insert}</varname></link>,
+ <link linkend="language.function.php"><varname>{php}</varname></link>,
+ les <link linkend="template.resources">ressources de template</link> et
+ les <link linkend="tips.componentized.templates">templates composants</link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml?r1=1.11&r2=1.12&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml:1.11 smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml:1.12
--- smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml:1.11 Sun Apr 9 21:59:55 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-insert.xml Sun Oct 1 11:18:39 2006
@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.9 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.10 Maintainer: gerald Status: ready -->
<sect1 id="language.function.insert">
<title>{insert}</title>
<para>
- Les balises {insert} fonctionnent à peu près comme les balises
- <link linkend="language.function.include">include</link>,
+ Les balises <varname>{insert}</varname> fonctionnent à peu près comme les balises
+ <link linkend="language.function.include"><varname>{include}</varname></link>,
à l'exception que leur sortie n'est PAS placée en cache lorsque
<link linkend="caching">le cache</link> du template est activé.
Les balises {insert} seront exécutées à chaque appel du template.
@@ -81,7 +81,7 @@
</programlisting>
</example>
<para>
- Dans cet exemple, nous utilisons le nom getBanner et lui passons les
+ Dans cet exemple, nous utilisons le nom <quote>getBanner</quote> et lui passons les
paramètres #emplacement_bandeau# et #id_site#. Smarty va rechercher une
fonction appelée insert_getBanner () dans votre application PHP, et lui
passer les valeurs #banner_location_id# et #site_id# comme premier
@@ -94,34 +94,47 @@
insert_getBanner(array("lid" => "12345","sid" => "67890")); et affichera
le résultat retourné à la place de la balise {insert}.
</para>
+ <itemizedlist>
+ <listitem>
<para>
- Si vous donnez une valeur à l'attribut "assign", la sortie de la balise
- {insert} sera assigné à une variable de template de ce nom au lieu d'être
- affichée directement. NOTE: assigner la sortie à une variable n'est pas
- très utile lorsque le <link linkend="variable.caching">cache</link> est activé.
- </para>
+ Si vous donnez une valeur à l'attribut <parameter>assign</parameter>, la sortie de la balise
+ <varname>{insert}</varname> sera assigné à une variable de template de ce nom au lieu d'être
+ affichée directement.
+ <note>
+ <para>
+ Assigner la sortie à une variable n'est pas
+ très utile lorsque le <link linkend="variable.caching">cache</link> est activé.
+ </para>
+ </note>
+ </para></listitem>
+
+ <listitem>
<para>
- Si vous donnez une valeur à l'attribut "script", ce script PHP sera
- inclus (une seule fois) avant l'exécution de la fonction {insert}.
- Le cas peut survenir lorsque la fonction {insert} n'existe pas encore,
- et que le script PHP chargé de sa définission doit être inclus. Le
- chemin doit être absolu ou relatif à
- <link linkend="variable.trusted.dir">$trusted_dir</link>.
- Lorsque <link
- linkend="variable.security">"security"</link> est actif, le script doit être situé
- dans <link linkend="variable.trusted.dir">$trusted_dir</link>.
+ Si vous donnez une valeur à l'attribut <parameter>script</parameter>, ce script PHP sera
+ inclus (une seule fois) avant l'exécution de la fonction <varname>{insert}</varname>.
+ Le cas peut survenir lorsque la fonction <varname>{insert}</varname> n'existe pas encore,
+ et que le script PHP chargé de sa définission doit être inclus.
</para>
+ <para>
+ Le chemin doit être absolu ou relatif à
+ <link linkend="variable.trusted.dir"><parameter>$trusted_dir</parameter></link>.
+ Lorsque
+ <link linkend="variable.security"><parameter>$security</parameter></link> est actif,
+ le script doit être situé dans
+ <link linkend="variable.trusted.dir"><parameter>$trusted_dir</parameter></link>.
+ </para></listitem>
+</itemizedlist>
<para>
L'objet Smarty est passé comme second argument. De cette façon, vous
pouvez utiliser ou modifier des informations sur l'objet Smarty,
- directement depuis votre fonction {insert}.
+ directement depuis votre fonction <varname>{insert}</varname>.
</para>
<note>
<title>Note technique</title>
<para>
Il est possible d'avoir des portions de template qui ne soient pas
gérables par le cache. Même si vous avez activé l'option
- <link linkend="caching">caching</link>, les balises {insert}
+ <link linkend="caching">caching</link>, les balises <varname>{insert}</varname>
ne feront pas partie du cache. Elles retourneront un contenu dynamique
à chaque invocation de la page. Cette méthode est très pratique pour
des éléments tels que les bandeaux publicitaires, les enquêtes,
@@ -130,7 +143,7 @@
</note>
<para>
Voir aussi
- <link linkend="language.function.include">{include}</link>
+ <link linkend="language.function.include"><varname>{include}</varname></link>
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml:1.10 smarty/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml:1.11
--- smarty/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml:1.10 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-ldelim.xml Sun Oct 1 11:18:39 2006
@@ -1,15 +1,19 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.12 Maintainer: gerald Status: ready -->
<sect1 id="language.function.ldelim">
<title>{ldelim},{rdelim}</title>
<para>
- {ldelim} et {rdelim} sont utilisés pour <link linkend="language.escaping">échapper</link>
- les délimiteurs en tant que tels, dans notre cas, "{" et "}". Vous pouvez toujours utiliser <link
- linkend="language.function.literal">{literal}{/literal}</link> pour échapper
- des blocks de texte, e.g. Javascript ou css.
- Voir aussi <link linkend="language.variables.smarty.ldelim">{$smarty.ldelim}</link>.
+ <varname>{ldelim}</varname> et <varname>{rdelim}</varname> sont utilisés pour
+ <link linkend="language.escaping">échapper</link>
+ les délimiteurs en tant que tels, dans notre cas,
+ <emphasis role="bold">{</emphasis> et <emphasis role="bold">}</emphasis>.
+ Vous pouvez toujours utiliser
+ <link linkend="language.function.literal"><varname>{literal}{/literal}</varname></link>
+ pour échapper des blocks de texte, e.g. Javascript ou css.
+ Voir aussi
+ <link linkend="language.variables.smarty.ldelim"><parameter>{$smarty.ldelim}</parameter></link>.
</para>
<example>
<title>{ldelim}, {rdelim}</title>
@@ -68,7 +72,7 @@
</example>
<para>
Voir aussi
- <link linkend="language.function.literal">{literal}</link> et
+ <link linkend="language.function.literal"><varname>{literal}</varname></link> et
la <link linkend="language.escaping">désactivation de l'analyse de Smarty</link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-literal.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-literal.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-literal.xml:1.10 smarty/docs/fr/designers/language-builtin-functions/language-function-literal.xml:1.11
--- smarty/docs/fr/designers/language-builtin-functions/language-function-literal.xml:1.10 Wed Mar 22 17:30:04 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-literal.xml Sun Oct 1 11:18:39 2006
@@ -1,19 +1,20 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.12 Maintainer: gerald Status: ready -->
<sect1 id="language.function.literal">
<title>{literal}</title>
<para>
- Les balises "{literal}" permettent à un bloc de données d'être pris tel
+ Les balises <varname>{literal}</varname> permettent à un bloc de données
+ d'être pris tel
quel, sans qu'il ne soit interprété par Smarty. Très pratique lors
de l'emplois d'éléments tels que javascript, acolades et autres
qui peuvent confondre le moteur de template. Tout le contenu situé
- entre les balises {literal}{/literal} ne sera pas interprété, et
+ entre les balises <varname>{literal}{/literal}</varname> ne sera pas interprété, et
affiché comme du contenu statique. Si vous voulez inclure des tags de template
- dans votre block {literal}, utilisez plutôt <link
- linkend="language.function.ldelim">{ldelim}{rdelim}</link> pour échapper
- les délimiteurs individuels.
+ dans votre block <varname>{literal}</varname>, utilisez plutôt
+ <link linkend="language.function.ldelim"><varname>{ldelim}{rdelim}</varname></link>
+ pour échapper les délimiteurs individuels.
</para>
<example>
<title>Balises {literal}</title>
@@ -77,7 +78,7 @@
</example>
<para>
Voir aussi
- <link linkend="language.function.ldelim">{ldelim}, {rdelim}</link> et
+ <link linkend="language.function.ldelim"><varname>{ldelim} {rdelim}</varname></link> et
la <link linkend="language.escaping">désactivation de l'analyse de Smarty</link>.
</para>
</sect1>
http://cvs.php.net/viewvc.cgi/smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml?r1=1.10&r2=1.11&diff_format=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml:1.10 smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml:1.11
--- smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml:1.10 Sun Apr 9 21:59:55 2006
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-php.xml Sun Oct 1 11:18:39 2006
@@ -1,40 +1,40 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.12 Maintainer: gerald Status: ready -->
<sect1 id="language.function.php">
<title>{php}</title>
<para>
- Les balises {php} permettent de rajouter du code PHP directement dans le
- template. Ils ne seront pas ignorés, quelle que soit la valeur de <link
- linkend="variable.php.handling">$php_handling</link>. Pour les
+ Les balises <varname>{php}</varname> permettent de rajouter du code PHP
+ directement dans le template. Ils ne seront pas ignorés, quelle que soit la valeur de <link
+ linkend="variable.php.handling"><parameter>$php_handling</parameter></link>. Pour les
utilisateurs avancés seulement, son utilisation n'est normalement pas
nécessaire et n'est pas recommandée.
</para>
+ <note>
+ <title>Notes techniques</title>
+ <para>
+ Pour accéder aux variables PHP dans les blocks <varname>{php}</varname>, vous devriez avoir besoin
+ d'utiliser le mot clé PHP <ulink url="&url.php-manual;global">global</ulink>.
+ </para>
+ </note>
<example>
- <title>Balises {php}</title>
+ <title>Exemple avec {php}</title>
<programlisting>
<![CDATA[
{php}
- // inclusion directe d'un script PHP
- // depuis le template.
+ // inclusion directe d'un script PHP depuis le template.
include('/chemin/vers/display_weather.php');
{/php}
]]>
</programlisting>
</example>
- <note>
- <title>Notes techniques</title>
- <para>
- Pour accéder aux variables PHP dans les blocks {php}, vous devriez avoir besoin
- d'utiliser le mot clé PHP <ulink url="&url.php-manual;global">global</ulink>.
- </para>
- </note>
<example>
<title>Balises {php} avec le mot clé global et assignement d'une variable</title>
<programlisting role="php">
<![CDATA[
+{* ce template inclut un bloc {php} qui assigne la variable $varX *}
{php}
global $foo, $bar;
if($foo == $bar){
@@ -42,27 +42,17 @@
}
$this->assign('varX','Strawberry');
{/php}
-<strong>{$varX}</strong> est ma glâce favorite
-]]>
- </programlisting>
- <para>
- Ce qui suit n'est vrament PAS recommandé, vu que c'est dans le contexte du template.
- </para>
- <programlisting>
-<![CDATA[
-{php}
-print_r($some_array);
-{/php}
+{* affichage de la variable *}
+<strong>{$varX}</strong> est ma glâce favorite :-)
]]>
</programlisting>
- </example>
<para>
Voir aussi
- <link linkend="variable.php.handling">$php_handling</link>,
- <link linkend="language.function.include.php">{include_php}</link>,
- <link linkend="language.function.include">{include}</link>,
- <link linkend="language.function.insert">{insert}</link> et
+ <link linkend="variable.php.handling"><parameter>$php_handling</parameter></link>,
+ <link linkend="language.function.include.php"><varname>{include_php}</varname></link>,
+ <link linkend="language.function.include"><varname>{include}</varname></link>,
+ <link linkend="language.function.insert"><varname>{insert}</varname></link> et
<link linkend="tips.componentized.templates">les templates composantes</link>.
</para>
</sect1>