cvs: smarty /docs/fr/designers/language-builtin-functions language-function-capture.xml language-function-config-load.xml language-function-foreach.xml language-function-if.xml language-function-include-php.xml language-function-include.xml
"Yannick Torres" <[email protected]>
| Newsgroups | gmane.comp.php.cvs.smarty |
|---|---|
| Message-ID | <cvsyannick1125737597@cvsserver> |
yannick Sat Sep 3 04:53:17 2005 EDT
Modified files:
/smarty/docs/fr/designers/language-builtin-functions
language-function-capture.xml
language-function-config-load.xml
language-function-foreach.xml
language-function-if.xml
language-function-include-php.xml
language-function-include.xml
Log:
sync with EN
--
Smarty CVS Mailing List (http://cvs.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
yannick-20050903045317.txt
(text/plain, 20.8 KB)
http://cvs.php.net/diff.php/smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml?r1=1.7&r2=1.8&ty=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml:1.7 smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml:1.8
--- smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml:1.7 Thu May 26 14:10:31 2005
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-capture.xml Sat Sep 3 04:53:14 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
<sect1 id="language.function.capture">
<title>{capture}</title>
<informaltable frame="all">
@@ -76,7 +76,7 @@
<![CDATA[
{* nous ne voulons afficher une ligne que si cette dernière est activé. *}
{capture name=banner}
-{include file="get_banner.tpl"}
+ {include file="get_banner.tpl"}
{/capture}
{if $smarty.capture.banner ne ""}
<table>
@@ -92,7 +92,9 @@
</example>
</para>
<para>
- Voir aussi
+ Voir aussi
+ <link
+ linkend="language.variables.smarty.capture">$smarty.capture</link>,
<link linkend="language.function.eval">{eval}</link>,
<link linkend="language.function.fetch">{fetch}</link>,
<link linkend="api.fetch">fetch()</link> et
http://cvs.php.net/diff.php/smarty/docs/fr/designers/language-builtin-functions/language-function-config-load.xml?r1=1.8&r2=1.9&ty=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-config-load.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-config-load.xml:1.8 smarty/docs/fr/designers/language-builtin-functions/language-function-config-load.xml:1.9
--- smarty/docs/fr/designers/language-builtin-functions/language-function-config-load.xml:1.8 Thu May 26 14:10:31 2005
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-config-load.xml Sat Sep 3 04:53:14 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.9 Maintainer: gerald Status: ready -->
<sect1 id="language.function.config.load">
<title>{config_load}</title>
<informaltable frame="all">
@@ -68,17 +68,36 @@
<para>
{config_load} est utiliseé pour charger des variables <link
linkend="language.config.variables">#variables#</link>
- de configuration dans un template. Voir <link linkend="config.files">
- Fichiers de configuration</link> pour de plus amples informations.
+ depuis un <link linkend="config.files">fichier de configuration</link>
+ dans un template.
</para>
<example>
<title>fonction {config_load}</title>
+ <para>
+ example.conf
+ </para>
+ <programlisting>
+ <![CDATA[
+#ceci est un commentaire de fichier de configuration
+
+#variables globales
+pageTitle = "Menu principal"
+bodyBgColor = #000000
+tableBgColor = #000000
+rowBgColor = #00ff00
+
+#section de variables personnalisées
+[Customer]
+pageTitle = "Info personnalisée"
+]]>
+ </programlisting>
+ <para>et le template</para>
<programlisting>
<![CDATA[
-{config_load file="colors.conf"}
+{config_load file="example.conf"}
<html>
-<title>{#pageTitle#}</title>
+<title>{#pageTitle#|default:"No title"}</title>
<body bgcolor="{#bodyBgColor#}">
<table border="{#tableBorderSize#}" bgcolor="{#tableBgColor#}">
<tr bgcolor="{#rowBgColor#}">
@@ -95,20 +114,21 @@
<para>
Les <link linkend="config.files">fichiers de configuration</link> peuvent contenir des sections.
Vous pouvez charger des variables d'une section donnée avec le
- nouvel attribut <emphasis>section</emphasis>.
+ nouvel attribut <emphasis>'section'</emphasis>.
</para>
<note>
<para>
Les <emphasis>sections des fichiers de configuration</emphasis>
- et la fonction native <emphasis>section</emphasis> n'ont rien en
- commun, il s'avère simplement qu'elles portent le même nom.
+ et la fonction native
+ <link linkend="language.function.section"><emphasis>{section}</emphasis></link>
+ n'ont rien en commun, il s'avère simplement qu'elles portent le même nom.
</para>
</note>
<example>
- <title>fonction config_load et section</title>
+ <title>fonction {config_load} avec section</title>
<programlisting>
<![CDATA[
-{config_load file="colors.conf" section="client"}
+{config_load file="example.conf" section="Customer"}
<html>
<title>{#pageTitle#}</title>
http://cvs.php.net/diff.php/smarty/docs/fr/designers/language-builtin-functions/language-function-foreach.xml?r1=1.8&r2=1.9&ty=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-foreach.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-foreach.xml:1.8 smarty/docs/fr/designers/language-builtin-functions/language-function-foreach.xml:1.9
--- smarty/docs/fr/designers/language-builtin-functions/language-function-foreach.xml:1.8 Thu May 26 14:10:31 2005
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-foreach.xml Sat Sep 3 04:53:14 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
<sect1 id="language.function.foreach">
<title>{foreach},{foreachelse}</title>
<informaltable frame="all">
@@ -95,7 +95,6 @@
</para>
<screen>
<![CDATA[
-
id: 1000<br />
id: 1001<br />
id: 1002<br />
@@ -110,20 +109,21 @@
// key contient la clef de chaque élément parcouru
// L'assignement ressemble à ceci :
<?php
- $smarty->assign("contacts", array(
- array("phone" => "1",
- "fax" => "2",
- "cell" => "3"),
- array("phone" => "555-4444",
- "fax" => "555-3333",
- "cell" => "760-1234"))
- );
+$smarty->assign('contacts', array(
+ array('phone' => '1',
+ 'fax' => '2',
+ 'cell' => '3'),
+ array('phone' => '555-4444',
+ 'fax' => '555-3333',
+ 'cell' => '760-1234'))
+ );
?>
]]>
-</programlisting>
+ </programlisting>
<programlisting>
<![CDATA[
{foreach name=outer item=contact from=$contacts}
+ <hr />
{foreach key=key item=item from=$contact}
{$key}: {$item}<br />
{/foreach}
@@ -135,12 +135,14 @@
</para>
<screen>
<![CDATA[
-tel: 1<br />
-fax: 2<br />
-portable: 3<br />
-tel: 555-4444<br />
-fax: 555-3333<br />
-portable: 760-1234<br />
+<hr />
+ phone: 1<br />
+ fax: 2<br />
+ cell: 3<br />
+<hr />
+ phone: 555-4444<br />
+ fax: 555-3333<br />
+ cell: 760-1234<br />
]]>
</screen>
</example>
@@ -173,6 +175,10 @@
de foreach.
</para>
+ <para>Voir <link linkend="section.property.index">{section}</link>
+ pour des exemples avec les proriétés ci-dessus.
+ </para>
+
<sect2 id="foreach.property.iteration">
<title>iteration</title>
<para>
@@ -204,7 +210,7 @@
S'il vaut false, foreach ne sera pas affiché. Si foreachelse est présent,
il sera affiché alternativement.
</para>
-
+
</sect2>
<sect2 id="foreach.property.total">
<title>total</title>
@@ -213,7 +219,7 @@
bouclées par ce foreach. Il peut être utilisé dans ou après le foreach.
</para>
<para>
- Voir aussi
+ Voir aussi
<link linkend="language.function.section">{section}</link> et
<link linkend="language.variables.smarty.loops">$smarty.foreach</link>.
</para>
http://cvs.php.net/diff.php/smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml?r1=1.6&r2=1.7&ty=u
Index: smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml
diff -u smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml:1.6 smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml:1.7
--- smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml:1.6 Thu May 26 14:10:31 2005
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-if.xml Sat Sep 3 04:53:14 2005
@@ -1,11 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.5 Maintainer: gerald Status: ready -->
<sect1 id="language.function.if">
<title>{if},{elseif},{else}</title>
<para>
L'instruction <emphasis>{if}</emphasis> dans Smarty dispose de la même flexibilité que l'instruction
- PHP du même nom, avec quelques fonctionnalités supplémentaires pour le
+ PHP <ulink url="&url.php-manual;if"><command>if</command></ulink>,
+ avec quelques fonctionnalités supplémentaires pour le
moteur de template. Tous les <emphasis>{if}</emphasis> doivent être
utilisés de pair avec un <emphasis>{/if}</emphasis>.
<emphasis>{else}</emphasis> et <emphasis>{elseif}</emphasis> sont également
@@ -138,70 +139,70 @@
</tgroup>
</informaltable>
<example>
- <title>Instruction if</title>
+ <title>Instruction {if}</title>
<programlisting>
<![CDATA[
- {if $name eq "Fred"}
- Bienvenue, Monsieur.
- {elseif $name eq "Wilma"}
- Bienvenue m'dame.
- {else}
- Bienvenue, qui que vous soyez.
- {/if}
-
- {* Un exemple avec l'opérateur or *}
- {if $name eq "Fred" or $name eq "Wilma"}
- ...
- {/if}
-
- {* même chose que ci-dessus *}
- {if $name == "Fred" || $name == "Wilma"}
- ...
- {/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#}
- ...
- {/if}
-
- {* vous pouvez également faire appel aux fonctions PHP *}
- {if count($var) gt 0}
- ...
- {/if}
-
- {* teste si les valeurs sont paires(even) ou impaires(odd) *}
- {if $var is even}
- ...
- {/if}
- {if $var is odd}
- ...
- {/if}
- {if $var is not odd}
- ...
- {/if}
-
- {* teste si la variable est divisible par 4 *}
- {if $var is div by 4}
- ...
- {/if}
-
- {* teste si la variable est paire, par groupe de deux i.e.,
- 0=paire, 1=paire, 2=impaire, 3=impaire, 4=paire, 5=paire, etc. *}
- {if $var is even by 2}
- ...
- {/if}
-
- {* 0=paire, 1=paire, 2=paire, 3=impaire, 4=impaire, 5=impaire, etc. *}
- {if $var is even by 3}
- ...
- {/if}
+{if $name eq "Fred"}
+ Bienvenue, Monsieur.
+{elseif $name eq "Wilma"}
+ Bienvenue m'dame.
+{else}
+ Bienvenue, qui que vous soyez.
+{/if}
+
+{* Un exemple avec l'opérateur or *}
+{if $name eq "Fred" or $name eq "Wilma"}
+ ...
+{/if}
+
+{* même chose que ci-dessus *}
+{if $name == "Fred" || $name == "Wilma"}
+ ...
+{/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#}
+ ...
+{/if}
+
+{* vous pouvez également faire appel aux fonctions PHP *}
+{if count($var) gt 0}
+ ...
+{/if}
+
+{* teste si les valeurs sont paires(even) ou impaires(odd) *}
+{if $var is even}
+ ...
+{/if}
+{if $var is odd}
+ ...
+{/if}
+{if $var is not odd}
+ ...
+{/if}
+
+{* teste si la variable est divisible par 4 *}
+{if $var is div by 4}
+ ...
+{/if}
+
+{* teste si la variable est paire, par groupe de deux i.e.,
+0=paire, 1=paire, 2=impaire, 3=impaire, 4=paire, 5=paire, etc. *}
+{if $var is even by 2}
+ ...
+{/if}
+
+{* 0=paire, 1=paire, 2=paire, 3=impaire, 4=impaire, 5=impaire, etc. *}
+{if $var is even by 3}
+ ...
+{/if}
]]>
</programlisting>
</example>
http://cvs.php.net/diff.php/smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml?r1=1.7&r2=1.8&ty=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.7 smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml:1.8
--- smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml:1.7 Thu May 26 14:10:31 2005
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-include-php.xml Sat Sep 3 04:53:14 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
<sect1 id="language.function.include.php">
<title>{include_php}</title>
<informaltable frame="all">
@@ -49,39 +49,26 @@
<note>
<title>Technical Note</title>
<para>
- include_php est presque obsolète dans Smarty. Vous pouvez obtenir des résultats
+ {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
+ 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 plugins ou de votre application. Reportez vous à
- l'exemple des <link
+ 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>
pour plus de détails.
</para>
</note>
<para>
- Les balises include_php sont utilisées pour inclure directement
+ Les balises {include_php} sont utilisées pour inclure directement
un script PHP dans vos templates. Si <link linkend="variable.security">"security" est activé</link>,
- alors le script
- à exécuter doit être placé dans le chemin <link
+ 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
+ {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.
</para>
<para>
- include_php est un moyen agréable pour gérer des <link
- linkend="tips.componentized.templates">"composants templates"</link>,
- tout en conservant le code PHP en dehors du template lui même.
- Supposons que vous ayez un template reprenant la navigation de votre
- site, elle même récupérée depuis une base de données. Vous pouvez
- conserver la logique du code PHP récupérant le contenu de la base dans
- un emplacement séparé, et l'inclure depuis votre template. Maintenant,
- vous pouvez utiliser ce template n'importe ou, sans vous inquiéter de
- savoir si les informations nécessaires ont bien étés assignées
- par l'application, avant la demande d'affichage.
- </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
@@ -92,41 +79,39 @@
<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
+ <emphasis>{include_php}</emphasis> 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.
</para>
<example>
- <title>Fonction include_php</title>
- <programlisting>
+ <title>Fonction {include_php}</title>
+ <para>load_nav.php</para>
+ <programlisting role="php">
<![CDATA[
- load_nav.php
- -------------
+<?php
- <?php
+// charge des variables depuis une base de données mysql et les assigne au template.
+require_once("MySQL.class.php");
+$sql = new MySQL;
+$sql->query("select * from site_nav_sections order by name",SQL_ALL);
+$this->assign('sections',$sql->record);
- // charge des variables depuis une base de données mysql et les assigne au template.
- require_once("MySQL.class.php");
- $sql = new MySQL;
- $sql->query("select * from site_nav_sections order by name",SQL_ALL);
- $this->assign('sections',$sql->record);
-
- ?>
- ]]>
+?>
+]]>
</programlisting>
<para>
Où index.tpl est :
</para>
<programlisting>
<![CDATA[
- {* chemin absolu, ou relatif à $trusted_dir *}
- {include_php file="/chemin/vers/load_nav.php"}
+{* chemin absolu, ou relatif à $trusted_dir *}
+{include_php file="/chemin/vers/load_nav.php"}
- {foreach item="curr_section" from=$sections}
- <a href="{$curr_section.url}">{$curr_section.name}</a><br />
- {/foreach}
+{foreach item="curr_section" from=$sections}
+ <a href="{$curr_section.url}">{$curr_section.name}</a><br />
+{/foreach}
]]>
</programlisting>
</example>
http://cvs.php.net/diff.php/smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml?r1=1.6&r2=1.7&ty=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.6 smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml:1.7
--- smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml:1.6 Thu May 26 14:10:31 2005
+++ smarty/docs/fr/designers/language-builtin-functions/language-function-include.xml Sat Sep 3 04:53:14 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
<sect1 id="language.function.include">
<title>{include}</title>
<informaltable frame="all">
@@ -53,18 +53,29 @@
"file", qui contient le chemin de la ressource template.
</para>
<para>
- Vous pouvez spécifier un attribut optionnel <emphasis>assign</emphasis>
+ 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>
<example>
- <title>fonction include</title>
-<programlisting>
-{include file="header.tpl"}
-
-{* Le corp du template va ici *}
-
-{include file="footer.tpl"}</programlisting>
+ <title>fonction {include}</title>
+ <programlisting>
+ <![CDATA[
+<html>
+ <head>
+ <title>{$title}</title>
+ </head>
+ <body>
+ {include file="page_header.tpl"}
+
+ {* body of template goes here *}
+ {include file="/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur
+
+ {include file="page_footer.tpl"}
+ </body>
+</html>
+]]>
+ </programlisting>
</example>
<para>
Vous pouvez également passer des variables au template inclus
@@ -74,8 +85,8 @@
qui auraient le même nom.
</para>
<example>
- <title>fonction include, passage de variables</title>
-<programlisting>
+ <title>fonction {include}, passage de variables</title>
+ <programlisting>
<![CDATA[
{include file="header.tpl" title="Menu principal" table_bgcolor="#c0c0c0"}
@@ -84,6 +95,38 @@
{include file="footer.tpl" logo="http://mon.example.com/logo.gif"}
]]>
</programlisting>
+ <para>où header.tpl est :</para>
+ <programlisting>
+ <![CDATA[
+<table border='1' width='100%' bgcolor='{$table_bgcolor|default:"#0000FF"}'>
+ <tr><td>
+ <h1>{$title}</h1>
+ </td></tr>
+</table>
+]]>
+ </programlisting>
+ </example>
+
+
+ <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>
+ <programlisting>
+<![CDATA[
+<body>
+ {include file="nav.tpl" assign="navbar"}
+ {include file="header.tpl" title="Main Menu" table_bgcolor="#c0c0c0"}
+ {$navbar}
+
+ {* body of template goes here *}
+
+ {include file="footer.tpl" logo="http://my.example.com/logo.gif"}
+ {$navbar}
+</body>
+]]>
+ </programlisting>
</example>
<para>
Utilisez la syntaxe <link
@@ -91,7 +134,7 @@
des fichiers situés en dehors du répertoire $template_dir.
</para>
<example>
- <title>fonction include, exemple de ressource template</title>
+ <title>fonction {include}, exemple de ressource template</title>
<programlisting>
<![CDATA[
{* chemin absolu *}
@@ -112,7 +155,7 @@
Voir aussi
<link linkend="language.function.include.php">{include_php}</link>,
<link linkend="language.function.php">{php}</link>,
- <link linkend="template.resources">les ressources de template</link> et
+ <link linkend="template.resources">les ressources de template</link> et
<link linkend="tips.componentized.templates">les templates composants</link>.
</para>
</sect1>