sync with EN

2025-08-07 03:44:26 +02:00 · 2005-09-03 08:53:14 +00:00
parent f61142ac2b
commit 1fc4d122b4
6 changed files with 194 additions and 137 deletions
--- a/docs/fr/designers/language-builtin-functions/language-function-capture.xml
+++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
 <sect1 id="language.function.capture">
 <title>{capture}</title>
 <informaltable frame="all">
@@ -93,6 +93,8 @@
 </para>
 <para>
  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
--- a/docs/fr/designers/language-builtin-functions/language-function-config-load.xml
+++ b/docs/fr/designers/language-builtin-functions/language-function-config-load.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+<!-- 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<73> 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[
-{config_load file="colors.conf"}
+#ceci est un commentaire de fichier de configuration
+
+#variables globales
+pageTitle = "Menu principal"
+bodyBgColor = #000000
+tableBgColor = #000000
+rowBgColor = #00ff00
+
+#section de variables personnalis<69>es
+[Customer]
+pageTitle = "Info personnalis<69>e"
+]]>
+  </programlisting>
+  <para>et le template</para>
+  <programlisting>
+<![CDATA[
+{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<6E>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<61>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<61>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>
--- a/docs/fr/designers/language-builtin-functions/language-function-foreach.xml
+++ b/docs/fr/designers/language-builtin-functions/language-function-foreach.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
 <sect1 id="language.function.foreach">
 <title>{foreach},{foreachelse}</title>
 <informaltable frame="all">
@@ -95,7 +95,6 @@ $smarty->assign('custid', $arr);
  </para>
  <screen>
 <![CDATA[
-
 id: 1000<br />
 id: 1001<br />
 id: 1002<br />
@@ -110,13 +109,13 @@ id: 1002<br />
 // key contient la clef de chaque <20>l<EFBFBD>ment parcouru
 // L'assignement ressemble <20> 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'))
    );
 ?>
 ]]>
@@ -124,6 +123,7 @@ id: 1002<br />
  <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 @@ id: 1002<br />
  </para>
  <screen>
 <![CDATA[
-tel: 1<br />
+<hr />
+  phone: 1<br />
  fax: 2<br />
-portable: 3<br />
-tel: 555-4444<br />
+  cell: 3<br />
+<hr />
+  phone: 555-4444<br />
  fax: 555-3333<br />
-portable: 760-1234<br />
+  cell: 760-1234<br />
 ]]>
  </screen>
 </example>
@@ -173,6 +175,10 @@ $smarty->assign("contacts", $db->getAssoc($sql));
  de foreach.
 </para>

+ <para>Voir <link linkend="section.property.index">{section}</link>
+  pour des exemples avec les prori<72>t<EFBFBD>s ci-dessus.
+ </para>
+
 <sect2 id="foreach.property.iteration">
  <title>iteration</title>
  <para>
--- a/docs/fr/designers/language-builtin-functions/language-function-if.xml
+++ b/docs/fr/designers/language-builtin-functions/language-function-if.xml
@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
+<!-- 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<69> que l'instruction
-  PHP du m<>me nom, avec quelques fonctionnalit<69>s suppl<70>mentaires pour le
+  PHP <ulink url="&url.php-manual;if"><command>if</command></ulink>,
+  avec quelques fonctionnalit<69>s suppl<70>mentaires pour le
  moteur de template. Tous les <emphasis>{if}</emphasis> doivent <20>tre
  utilis<69>s de pair avec un <emphasis>{/if}</emphasis>.
  <emphasis>{else}</emphasis> et <emphasis>{elseif}</emphasis> sont <20>galement
@@ -138,7 +139,7 @@
  </tgroup>
 </informaltable>
 <example>
-  <title>Instruction if</title>
+  <title>Instruction {if}</title>
  <programlisting>
 <![CDATA[
 {if $name eq "Fred"}
--- a/docs/fr/designers/language-builtin-functions/language-function-include-php.xml
+++ b/docs/fr/designers/language-builtin-functions/language-function-include-php.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
 <sect1 id="language.function.include.php">
 <title>{include_php}</title>
 <informaltable frame="all">
@@ -49,38 +49,25 @@
 <note>
  <title>Technical Note</title>
  <para>
-   include_php est presque obsol<6F>te dans Smarty. Vous pouvez obtenir des r<>sultats 
+   {include_php} est presque obsol<6F>te dans Smarty. Vous pouvez obtenir des r<>sultats 
   <20>quivalents en utilisant les fonctions utilisateur.
-   La seule raison qui peut vous pousser <20> utiliser include_php est que 
+   La seule raison qui peut vous pousser <20> utiliser {include_php} est que 
   vous avez besoin de mettre une de vos fonction en quarantaine vis <20> vis du 
-   r<>pertoire des plugins ou de votre application. Reportez vous <20> 
-   l'exemple des <link
+   r<>pertoire des <link linkend="variable.plugins.dir">plugins</link> ou de votre application.
+   Reportez vous <20> 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<69>es pour inclure directement
+  Les balises {include_php} sont utilis<69>es pour inclure directement
  un script PHP dans vos templates. Si <link linkend="variable.security">"security" est activ<69></link>, 
-  alors le script
-  <20> ex<65>cuter doit <20>tre plac<61> dans le chemin <link
+  alors le script <20> ex<65>cuter doit <20>tre plac<61> 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 <20> inclure, relatif <20> <link linkend="variable.trusted.dir">$trusted_dir</link>, ou absolu.
 </para>
- <para>
-  include_php est un moyen agr<67>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<75>r<EFBFBD>e depuis une base de donn<6E>es. Vous pouvez
-  conserver la logique du code PHP r<>cup<75>rant le contenu de la base dans
-  un emplacement s<>par<61>, et l'inclure depuis votre template. Maintenant,
-  vous pouvez utiliser ce template n'importe ou, sans vous inqui<75>ter de
-  savoir si les informations n<>cessaires ont bien <20>t<EFBFBD>s assign<67>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.
@@ -92,19 +79,17 @@
 <para>
  Vous pouvez donner une valeur <20> l'attribut optionnel
  <emphasis>assign</emphasis>, pour demander <20> la fonction
-  <emphasis>include_php</emphasis> d'assigner la sortie du script PHP
+  <emphasis>{include_php}</emphasis> d'assigner la sortie du script PHP
  <20> la variable sp<73>cifi<66>e plut<75>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

 // charge des variables depuis une base de donn<6E>es mysql et les assigne au template.
--- 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 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- 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<73>cifier un attribut optionnel <emphasis>assign</emphasis>
+  Vous pouvez sp<73>cifier un attribut optionnel <emphasis>'assign'</emphasis>
  qui d<>finit une variable de template dans laquelle la sortie de
  {include} sera stock<63>e plut<75>t qu'affich<63>e.
 </para>
 <example>
-  <title>fonction include</title>
+  <title>fonction {include}</title>
  <programlisting>
-{include file="header.tpl"}
+   <![CDATA[
+<html>
+ <head>
+  <title>{$title}</title>
+ </head>
+ <body>
+  {include file="page_header.tpl"}

-{* Le corp du template va ici *}
+  {* body of template goes here *}
+  {include file="/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur

-{include file="footer.tpl"}</programlisting>
+  {include file="page_footer.tpl"}
+ </body>
+</html>
+]]>
+  </programlisting>
 </example>
 <para>
  Vous pouvez <20>galement passer des variables au template inclus
@@ -74,7 +85,7 @@
  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"}
@@ -82,6 +93,38 @@
 {* Le corps du template vient ici *}

 {include file="footer.tpl" logo="http://mon.example.com/logo.gif"}
+]]>
+  </programlisting>
+  <para>o<EFBFBD> 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 <20> une variable</title>
+  <para>Cet exemple assigne le contenu de nav.tpl <20> la variable $navbar,
+   qui est alors affich<63>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>
@@ -91,7 +134,7 @@
  des fichiers situ<74>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 *}