sync with EN

docs/fr/designers/language-builtin-functions/language-function-capture.xml

@@ -1,26 +1,28 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.13 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.14 Maintainer: gerald Status: ready -->
 
 <sect1 id="language.function.capture">
  <title>{capture}</title>
 
  <para>
-  {capture} est utilis<69> pour r<>cup<75>rer la sortie d'<27>l<EFBFBD>ments dans une variable
+  <varname>{capture}</varname> est utilis<69> pour r<>cup<75>rer la sortie d'<27>l<EFBFBD>ments dans
-  au lieu de les afficher. Tout contenu situ<74> entre {capture
+  une variable au lieu de les afficher. Tout contenu situ<74> entre
-  name='foo'} et {/capture} est intercept<EFBFBD> dans une variable dont le nom est
+  <varname>{capture name='foo'}</varname> et <varname>{/capture}</varname>
-  sp<73>cifi<66> dans l'attribut name.
+  est intercept<70> dans une variable dont le nom est sp<EFBFBD>cifi<EFBFBD> dans l'attribut
+  <parameter>name</parameter>.
  </para>
  <para>
   Le contenu captur<75> peut <20>tre utilis<69> dans
   le template par l'interm<72>diaire de la variable sp<73>ciale
-  <link linkend="language.variables.smarty.capture">$smarty.capture.foo</link>
+  <link linkend="language.variables.smarty.capture"><parameter>$smarty.capture.foo</parameter></link>
-  o<> "foo" est la valeur de l'attribut name. Si vous ne donnez pas de valeur
+  o<> <quote>foo</quote> est la valeur de l'attribut <parameter>name</parameter>.
-  <EFBFBD> l'attribut name, alors "default" est utilis<69> en tant que nom, i.e.
+  Si vous ne donnez pas de valeur <20> l'attribut <parameter>name</parameter>, alors
-  $smarty.capture.default.
+  <quote>default</quote> est utilis<69> en tant que nom, i.e.
+  <parameter>$smarty.capture.default</parameter>.
  </para>
  <para>
-  {capture} peut <20>tre imbriqu<71>.
+  <varname>{capture}</varname> peut <20>tre imbriqu<71>.
  </para>
 
  <informaltable frame="all">
@@ -59,11 +61,11 @@
  </informaltable>
  <caution>
   <para>
-   Fa<46>tes attention lorsque vous interceptez la sortie de commandes <link
+   Fa<46>tes attention lorsque vous interceptez la sortie de commandes
-   linkend="language.function.insert">{insert}</link>.
+   <link linkend="language.function.insert"><varname>{insert}</varname></link>.
    Si vous avez configur<75> le <link linkend="caching">cache</link> pour que ce
    dernier soit actif, et que vous avez des commandes <link
-   linkend="language.function.insert">{insert}</link>
+   linkend="language.function.insert"><varname>{insert}</varname></link>
    suppos<6F>es s'ex<65>cuter dans un contenu en cache, ne tentez pas de capturer
    ce contenu.
   </para>
@@ -87,7 +89,7 @@
   <example>
    <title>{capture} dans une variable de template</title>
    <para>Cet exemple d<>montre <20>galement la fonction
-    <link linkend="language.function.popup">{popup}</link>
+    <link linkend="language.function.popup"><varname>{popup}</varname></link>
    </para>
    <programlisting>
 <![CDATA[
@@ -103,12 +105,11 @@ Votre IP est {$smarty.server.REMOTE_ADDR}.
  </para>
  <para>
   Voir aussi
-  <link
+  <link linkend="language.variables.smarty.capture"><parameter>$smarty.capture</parameter></link>,
-   linkend="language.variables.smarty.capture">$smarty.capture</link>,
+  <link linkend="language.function.eval"><varname>{eval}</varname></link>,
-  <link linkend="language.function.eval">{eval}</link>,
+  <link linkend="language.function.fetch"><varname>{fetch}</varname></link>,
-  <link linkend="language.function.fetch">{fetch}</link>,
+  <link linkend="api.fetch"><varname>fetch()</varname></link> et
-  <link linkend="api.fetch">fetch()</link> et
+  <link linkend="language.function.assign"><varname>{assign}</varname></link>.
-  <link linkend="language.function.assign">{assign}</link>.
  </para>
 </sect1>
 

docs/fr/designers/language-builtin-functions/language-function-config-load.xml

@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.12 Maintainer: gerald Status: ready -->
 
 <sect1 id="language.function.config.load">
  <title>{config_load}</title>
 
  <para>
-  {config_load} est utilise<73> pour charger des variables
+  <varname>{config_load}</varname> est utilise<73> pour charger des variables
-  <link linkend="language.config.variables">#variables#</link>
+  <link linkend="language.config.variables"><parameter>#variables#</parameter></link>
   depuis un <link linkend="config.files">fichier de configuration</link>
   dans un template.
  </para>
@@ -75,9 +75,9 @@
   </tgroup>
  </informaltable>
  <example>
-  <title>fonction {config_load}</title>
+  <title>Fonction {config_load}</title>
   <para>
-   example.conf
+   Le fichier <filename>example.conf</filename>
   </para>
   <programlisting>
 <![CDATA[
@@ -117,13 +117,13 @@ pageTitle = "Info personnalis
  <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 <parameter>section</parameter>.
  </para>
  <note>
   <para>
-   Les <emphasis>sections des fichiers de configuration</emphasis>
+   Les <emphasis>sections</emphasis> des fichiers de configuration
-   et la fonction native 
+   et la fonction native
-   <link linkend="language.function.section"><emphasis>{section}</emphasis></link>
+   <link linkend="language.function.section"><varname>{section}</varname></link>
    n'ont rien en commun, il s'av<61>re simplement qu'elles portent le m<>me nom.
   </para>
  </note>
@@ -150,17 +150,17 @@ pageTitle = "Info personnalis
  </example>
 
  <para>
-  Voir aussi <link linkend="variable.config.overwrite">$config_overwrite</link>
+  Voir aussi <link linkend="variable.config.overwrite"><parameter>$config_overwrite</parameter></link>
   pour les tableaux de variables de configuration.
 </para>
 
  <para>
   Voir aussi
-  <link linkend="config.files">les fichiers de configuration</link>,
+  les <link linkend="config.files">fichiers de configuration</link>,
-  <link linkend="language.config.variables">les variables de configuration</link>,
+  les <link linkend="language.config.variables">variables de configuration</link>,
-  <link linkend="variable.config.dir">$config_dir</link>,
+  <link linkend="variable.config.dir"><parameter>$config_dir</parameter></link>,
-  <link linkend="api.get.config.vars">get_config_vars()</link> et
+  <link linkend="api.get.config.vars"><varname>get_config_vars()</varname></link> et
-  <link linkend="api.config.load">config_load()</link>.
+  <link linkend="api.config.load"><varname>config_load()</varname></link>.
  </para>
 </sect1>
 

docs/fr/designers/language-builtin-functions/language-function-foreach.xml

@@ -1,31 +1,22 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
 
 <sect1 id="language.function.foreach">
  <title>{foreach},{foreachelse}</title>
-
  <para>
-  Les boucles <emphasis>{foreach}</emphasis> sont une alternative aux boucles
+  <varname>{foreach}</varname> est utilis<69> pour parcourir un
-  <link linkend="language.function.section"><emphasis>section</emphasis></link>.
+  <emphasis role="bold">simple tableau associatif</emphasis>,
-  Les boucles <emphasis>{foreach}</emphasis>
+  contrairement <20> <link linkend="language.function.section"><varname>{section}</varname></link>
-  sont utilis<69>es pour parcourir des <emphasis role="bold">tableaux associatifs simples</emphasis>.
+  qui effectue une boucle sur les <emphasis role="bold">tableaux de donn<6E>es</emphasis>.
-  La syntaxe des boucles <emphasis>{foreach}</emphasis> est bien plus simple
+  La synthaxe pour
-  que celle des boucles <emphasis>{section}</emphasis>, mais en contrepartie,
+  <varname>{foreach}</varname> est plus simple que
-  <emphasis role="bold">elles ne peuvent <20>tre utilis<69>es que pour des tableaux associatifs 
+  <link linkend="language.function.section"><varname>{section}</varname></link>,
-   simples</emphasis>. La balise <emphasis>{foreach}</emphasis> doit toujours <20>tre accompagn<67>e
+  mais <emphasis role="bold">ne peut <20>tre utilis<69> que pour des tableau simple</emphasis>.
-  de la balise <emphasis>{/foreach}</emphasis>. Les param<61>tres requis sont
+  Chaque <varname>{foreach}</varname> doit aller de paire avec une balise fermante 
-  <emphasis>from</emphasis> et <emphasis>item</emphasis>. Le nom des boucles
+  <varname>{/foreach}</varname>.
-  {foreach} doit <20>tre compos<6F>s exclusivement de lettres,
-  chiffres et underscores, selon vos pr<70>f<EFBFBD>rences. Les boucles
-  <emphasis>{foreach}</emphasis> peuvent <20>tre imbriqu<71>es.
-  La variable <emphasis>from</emphasis> (g<>n<EFBFBD>ralement le tableau <20>
-  parcourir) d<>termine le nombre de fois que <emphasis>{foreach}</emphasis>
-  sera ex<65>cut<75>. <emphasis>{foreachelse}</emphasis> est ex<65>cut<75> si aucune
-  valeur n'est pr<70>sente dans la variable donn<6E>e <20> l'attribut
-  <emphasis>from</emphasis>.
  </para>
-
+ 
  <informaltable frame="all">
   <tgroup cols="5">
    <colspec colname="param" align="center" />
@@ -70,27 +61,89 @@
      <entry>Non</entry>
      <entry><emphasis>n/a</emphasis></entry>
      <entry>Le nom de la boucle foreach, qui nous permettra
-     d'acc<63>der <20> ses propri<72>t<EFBFBD>s.</entry>
+      d'acc<63>der <20> ses propri<72>t<EFBFBD>s.</entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
+ 
+ 
+ <itemizedlist>
+  <listitem><para>
+    Required attributes are <parameter>from</parameter> and <parameter>item</parameter>.
+   </para></listitem>
+  
+  <listitem><para>
+    The <parameter>name</parameter> of the <varname>{foreach}</varname> loop can be anything
+    you like, made up of letters, numbers and underscores, like
+    <ulink url="&url.php-manual;language.variables">PHP variables</ulink>.
+   </para></listitem>
+  
+  <listitem><para>
+    <varname>{foreach}</varname> loops can be nested, and the nested
+    <varname>{foreach}</varname> names must be unique from each other.
+   </para></listitem>
+  
+  <listitem><para>
+    The <parameter>from</parameter> attribute, usually an array of values,
+    determines the number of times <varname>{foreach}</varname> will loop.
+   </para></listitem>
+  
+  <listitem><para>
+    <varname>{foreachelse}</varname> is executed when there are no
+    values in the <parameter>from</parameter> variable.
+   </para></listitem>
+  
+  <listitem><para>
+    <varname>{foreach}</varname> loops also have their own variables that handle properties.
+    These are accessed with:
+    <link linkend="language.variables.smarty.loops">
+     <parameter>{$smarty.foreach.name.property}</parameter></link> with
+    <quote>name</quote> being the
+    <parameter>name</parameter> attribute.
+   </para>
+   <note>
+    <title>Note</title>
+    <para>The <parameter>name</parameter> attribute is only required when
+     you want to access a <varname>{foreach</varname>} property, unlike
+     <link linkend="language.function.section"><varname>{section}</varname></link>.
+     Accessing a <varname>{foreach}</varname> property with <parameter>name</parameter>
+     undefined does not throw an error, but leads to unpredictable results instead.
+    </para>
+   </note>
+  </listitem>
+  
+  <listitem><para>
+    <varname>{foreach}</varname> properties are
+    <link linkend="foreach.property.index"><parameter>index</parameter></link>,
+    <link linkend="foreach.property.iteration"><parameter>iteration</parameter></link>,
+    <link linkend="foreach.property.first"><parameter>first</parameter></link>,
+    <link linkend="foreach.property.last"><parameter>last</parameter></link>,
+    <link linkend="foreach.property.show"><parameter>show</parameter></link>,
+    <link linkend="foreach.property.total"><parameter>total</parameter></link>.
+   </para></listitem>
+ </itemizedlist>
+
  <example>
-  <title>foreach</title>
+  <title>L'attribut <parameter>item</parameter></title>
   <programlisting role="php">
 <![CDATA[
 <?php
-$arr = array( 1001,1002,1003);
+$arr = array(1000, 1001, 1002);
-$smarty->assign('custid', $arr);
+$smarty->assign('myArray', $arr);
 ?>
 ]]>
   </programlisting>
+  <para>
+   Template pour afficher <parameter>$myArray</parameter> dans une liste non-ordonn<6E>e.
+  </para>
   <programlisting>
 <![CDATA[
-{* Cet exemple affiche toutes les valeurs du tableau $custid *}
+<ul>
-{foreach from=$custid item=curr_id}
+ {foreach from=$myArray item=foo}
-  id: {$curr_id}<br />
+ <li>{$foo}</li>
-{/foreach}
+ {/foreach}
+</ul>
 ]]>
   </programlisting>
   <para>
@@ -98,38 +151,116 @@ $smarty->assign('custid', $arr);
   </para>
   <screen>
 <![CDATA[
-id: 1000<br />
+<ul>
-id: 1001<br />
+ <li>1000</li>
-id: 1002<br />
+ <li>1001</li>
+ <li>1002</li>
+</ul>
 ]]>
   </screen>
  </example>
 
  <example>
-  <title>foreach key</title>
+  <title>Utilisation des attributs <parameter>item</parameter> et <parameter>key</parameter></title>
   <programlisting role="php">
 <![CDATA[
-// key contient la clef de chaque <20>l<EFBFBD>ment parcouru
-// L'assignement ressemble <20> ceci :
 <?php
-$smarty->assign('contacts', array(
+$arr = array(9 => 'Tennis', 3 => 'Natation', 8 => 'Programmation');
-    array('phone' => '1',
+$smarty->assign('myArray', $arr);
-      'fax' => '2',
-      'cell' => '3'),
-    array('phone' => '555-4444',
-      'fax' => '555-3333',
-      'cell' => '760-1234'))
-    );
 ?>
 ]]>
   </programlisting>
+  <para>
+   Le template affiche le tableau <parameter>$myArray</parameter> comme paire cl<63>/valeur,
+   comme la fonction PHP
+   <ulink url="&url.php-manual;foreach"><varname>foreach</varname></ulink>.
+  </para>
+  <programlisting>
+<![CDATA[
+<ul>
+ {foreach from=$myArray key=k item=v}
+ <li>{$k}: {$v}</li>
+ {/foreach}
+</ul>
+]]>
+  </programlisting>
+  <para>
+   L'exemple ci-dessus affichera :
+  </para>
+  <screen>
+<![CDATA[
+<ul>
+ <li>9: Tennis</li>
+ <li>3: Natation</li>
+ <li>8: Programmation</li>
+</ul>
+]]>
+  </screen>
+ </example>
+
+ <example>
+  <title>{foreach} avec un attribut associatif <parameter>item</parameter></title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+$items_list = array(23 => array('no' => 2456, 'label' => 'Salad'),
+    96 => array('no' => 4889, 'label' => 'Cream')
+);
+$smarty->assign('items', $items_list);
+?>
+]]>
+  </programlisting>
+  <para>
+   Le template affiche <parameter>$items</parameter> avec
+   <parameter>$myId</parameter> dans l'URL.
+  </para>
+  <programlisting>
+<![CDATA[
+<ul>
+ {foreach from=$items key=myId item=i}
+ <li><a href="item.php?id={$myId}">{$i.no}: {$i.label}</li>
+  {/foreach}
+ </ul>
+ ]]>
+  </programlisting>
+  <para>
+   L'exemple ci-dessus affichera :
+  </para>
+  <screen>
+<![CDATA[
+<ul>
+<li><a href="item.php?id=23">2456: Salad</li>
+<li><a href="item.php?id=96">4889: Cream</li>
+</ul>
+]]>
+  </screen>
+ </example>
+
+ <example>
+  <title>{foreach} avec <parameter>item</parameter> et <parameter>key</parameter></title>
+  <para>Assigne un tableau <20> Smarty, la cl<63> contient la cl<63> pour chaque valeur de la boucle.</para>
+  <programlisting role="php">
+<![CDATA[
+<?php
+$smarty->assign('contacts', array(
+array('phone' => '1',
+         'fax' => '2',
+         'cell' => '3'),
+         array('phone' => '555-4444',
+         'fax' => '555-3333',
+         'cell' => '760-1234')
+));
+?>
+]]>
+  </programlisting>
+  <para>Le template affiche <parameter>$contact</parameter>.</para>
   <programlisting>
 <![CDATA[
 {foreach name=outer item=contact from=$contacts}
-  <hr />
+    <hr />
-  {foreach key=key item=item from=$contact}
+    {foreach key=key item=item from=$contact}
-    {$key}: {$item}<br />
+        {$key}: {$item}<br />
-  {/foreach}
+    {/foreach}
 {/foreach}
 ]]>
   </programlisting>
@@ -139,92 +270,167 @@ $smarty->assign('contacts', array(
   <screen>
 <![CDATA[
 <hr />
-  phone: 1<br />
+phone: 1<br />
-  fax: 2<br />
+fax: 2<br />
-  cell: 3<br />
+cell: 3<br />
 <hr />
-  phone: 555-4444<br />
+phone: 555-4444<br />
-  fax: 555-3333<br />
+fax: 555-3333<br />
-  cell: 760-1234<br />
+cell: 760-1234<br />
 ]]>
   </screen>
  </example>
 
  <example>
-  <title>{foreach} - Exemple avec une base de donn<6E>es (eg PEAR ou ADODB)</title>
+  <title>Exemple d'une base de donn<6E>es avec {foreachelse}</title>
+  <para>Exemple d'un script de recherche dans une base de donn<6E>es (e.g. PEAR ou ADODB),
+   le r<>sultat de la requ<71>te est assign<67> <20> Smarty.</para>
   <programlisting role="php">
 <![CDATA[
 <?php
-$sql = 'select contact_id, name, nick from contacts order by contact';
+$search_condition = "where name like '$foo%' ";
-$smarty->assign("contacts", $db->getAssoc($sql));
+$sql = 'select contact_id, name, nick from contacts '.$search_condition.' order by name';
+$smarty->assign('results', $db->getAssoc($sql) );
 ?>
 ]]>
   </programlisting>
+  <para>Le template qui affiche <quote>None found</quote>
+   si aucun r<>sultat avec <varname>{foreachelse}</varname>.</para>
   <programlisting>
 <![CDATA[
-{foreach key=cid item=con from=$contacts}
+{foreach key=cid item=con from=$results}
- <a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
+<a href="contact.php?contact_id={$cid}">{$con.name} - {$con.nick}</a><br />
+{foreachelse}
+Aucun <20>l<EFBFBD>ment n'a <20>t<EFBFBD> trouv<75> dans la recherche
+{/foreach}
+]]>
+   </programlisting>
+  </example>
+
+  <sect2 id="foreach.property.index">
+   <title>.index</title>
+   <para>
+    <parameter>index</parameter> contient l'index courant du tableau, en comman<61>ant par z<>ro.
+   </para>
+   <example>
+    <title>Exemple avec <parameter>index</parameter></title>
+    <programlisting role="php">
+ <![CDATA[
+ {* L'en-t<>te du block est affich<63> toutes les 5 lignes *}
+<table>
+ {foreach from=$items key=myId item=i name=foo}
+ {if $smarty.foreach.foo.index % 5 == 0}
+ <tr><th>Title</th></tr>
+ {/if}
+ <tr><td>{$i.label}</td></tr>
+ {/foreach}
+</table>
+]]>
+  </programlisting>
+ </example>
+</sect2>
+
+<sect2 id="foreach.property.iteration">
+ <title>.iteration</title>
+ <para>
+  <parameter>iteration</parameter> contient l'it<69>ration courante de la boucle et commence
+  toujours <20> 1, contrairement <20>
+  <link linkend="foreach.property.index"><parameter>index</parameter></link>.
+  Il est incr<63>ment<6E> d'un, <20> chaque it<69>ration.
+ </para>
+ <example>
+  <title>Exemple avec <parameter>iteration</parameter> et <parameter>index</parameter></title>
+  <programlisting role="php">
+<![CDATA[
+{* this will output 0|1, 1|2, 2|3, ... etc *}
+{foreach from=$myArray item=i name=foo}
+{$smarty.foreach.foo.index}|{$smarty.foreach.foo.iteration},
 {/foreach}
 ]]>
   </programlisting>
-
  </example>
-
+</sect2>
+<sect2 id="foreach.property.first">
+  <title>.first</title>
+  <para>
+   <parameter>first</parameter> vaut &true; si l'it<69>ration courante de
+   <varname>{foreach}</varname> est l'initial.
+  </para>
+  <example>
+   <title>Exemple avec <parameter>first</parameter></title>
+   <programlisting role="php">
+<![CDATA[
+ {* affiche LATEST sur le premier <20>l<EFBFBD>ment, sinon, l'id *}
+ <table>
+  {foreach from=$items key=myId item=i name=foo}
+  <tr>
+  <td>{if $smarty.foreach.foo.first}LATEST{else}{$myId}{/if}</td>
+  <td>{$i.label}</td>
+ </tr>
+ {/foreach}
+</table>
+]]>
+  </programlisting>
+ </example>
+</sect2>
+<sect2 id="foreach.property.last">
+ <title>.last</title>
  <para>
-  Les boucles {foreach} ont <20>galement leurs propres variables qui g<>rent les propri<72>t<EFBFBD>s
+  <parameter>last</parameter> est d<>fini <20> &true; si l'it<69>ration courante de
-  de {foreach}. Elles sont indiqu<71>es par :
+  <varname>{foreach}</varname> est la derni<6E>re.
-  <link linkend="language.variables.smarty.loops">{$smarty.foreach.foreachname.varname}</link>
-  o<> foreachname est le nom sp<73>cifi<66> par l'attribut <emphasis>name</emphasis>
-  de foreach.
  </para>
-
+ <example>
- <para>Voir <link linkend="section.property.index">{section}</link>
+  <title>Exemple avec <parameter>last</parameter></title>
-  pour des exemples avec les prori<72>t<EFBFBD>s ci-dessus.
+  <programlisting role="php">
+<![CDATA[
+{* Ajout une barre horizontale <20> la fin de la liste *}
+{foreach from=$items key=part_id item=prod name=products}
+<a href="#{$part_id}">{$prod}</a>{if $smarty.foreach.products.last}<hr>{else},{/if}
+{foreachelse}
+... contenu ...
+{/foreach}
+]]>
+  </programlisting>
+ </example>
+</sect2>
+<sect2 id="foreach.property.show">
+ <title>.show</title>
+ <para>
+  <parameter>show</parameter> est utilis<69> en tant que param<61>tre <20> <varname>{foreach}</varname>.
+  <parameter>show</parameter> est une valeur bool<6F>enne. S'il vaut
+  &false;, <varname>{foreach}</varname> ne sera pas affich<63>.
+  S'il y a un <varname>{foreachelse}</varname>, il sera affich<63> alternativement.
  </para>
+</sect2>
 
- <sect2 id="foreach.property.iteration">
+<sect2 id="foreach.property.total">
-  <title>iteration</title>
+ <title>.total</title>
-  <para>
+ <para>
-   <emphasis>iteration</emphasis> est utilis<69> pour afficher l'it<69>ration de la boucle courante.
+  <parameter>total</parameter> contient le nombre d'it<69>rations que cette boucle
-   <emphasis>iteration</emphasis> commence toujours par 1 et est incr<63>ment<6E>
+  <varname>{foreach}</varname> effectuera.
-   <20> chaque it<69>ration.
+  Il peut <20>tre utilis<69> dans ou apr<70>s un <varname>{foreach}</varname>.
-  </para>
+ </para>
- </sect2>
+ <example>
+  <title>Exemple avec <parameter>total</parameter></title>
+  <programlisting role="php">
+<![CDATA[
+{* affiche les lignes retourn<72>es <20> la fin *}
+{foreach from=$items key=part_id item=prod name=foo}
+{$prod.name><hr/>
+{if $smarty.foreach.foo.last}
+<div id="total">{$smarty.foreach.foo.total} items</div>
+{/if}
+{foreachelse}
+... quelque chose d'autre ...
+{/foreach}
+]]>
+ </programlisting>
+</example>
 
- <sect2 id="foreach.property.first">
-  <title>first</title>
-  <para>
-   <emphasis>first</emphasis> est d<>fini <20> true si l'it<69>ration courante de foreach est la premi<6D>re.
-  </para>
- </sect2>
-
- <sect2 id="foreach.property.last">
-  <title>last</title>
-  <para>
-   <emphasis>last</emphasis> est d<>fini <20> true si l'it<69>ration courante de foreach est la derni<6E>re.
-  </para>
- </sect2>
-
- <sect2 id="foreach.property.show">
-  <title>show</title>
-  <para>
-   <emphasis>show</emphasis> est utilis<69> en tant que param<61>tre de foreach.
-   <emphasis>show</emphasis> est un bool<6F>en (true ou false). 
-   S'il vaut false, foreach ne sera pas affich<63>. Si foreachelse est pr<70>sent,
-   il sera affich<63> alternativement.
-  </para>
-
- </sect2>
- <sect2 id="foreach.property.total">
-  <title>total</title>
-  <para>
-   <emphasis>total</emphasis> est utilis<69> pour afficher le nombre d'it<69>rations
-   boucl<63>es par ce foreach. Il peut <20>tre utilis<69> dans ou apr<70>s le foreach.
-  </para>
   <para>
    Voir aussi
-   <link linkend="language.function.section">{section}</link> et
+   <link linkend="language.function.section"><varname>{section}</varname></link>
-   <link linkend="language.variables.smarty.loops">$smarty.foreach</link>.
+   et <link linkend="language.variables.smarty.loops"><parameter>$smarty.foreach</parameter></link>.
   </para>
  </sect2>
 </sect1>

docs/fr/designers/language-builtin-functions/language-function-if.xml

@@ -1,25 +1,25 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.10 Maintainer: yannick 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
+  L'instruction <varname>{if}</varname> dans Smarty dispose de la m<>me flexibilit<69> que l'instruction
-  PHP <ulink url="&url.php-manual;if"><command>if</command></ulink>,
+  PHP <ulink url="&url.php-manual;if">if</ulink>,
   avec quelques fonctionnalit<69>s suppl<70>mentaires pour le
-  moteur de template. Tous les <emphasis>{if}</emphasis> doivent <20>tre
+  moteur de template. Tous les <varname>{if}</varname> doivent <20>tre
-  utilis<69>s de pair avec un <emphasis>{/if}</emphasis>.
+  utilis<69>s de pair avec un <varname>{/if}</varname>.
-  <emphasis>{else}</emphasis> et <emphasis>{elseif}</emphasis> sont <20>galement
+  <varname>{else}</varname> et <varname>{elseif}</varname> sont <20>galement
   des balises autoris<69>es. Toutes les conditions et fonctions PHP sont reconnues,
   comme <emphasis>||</emphasis>, <emphasis>or</emphasis>,
   <emphasis>&amp;&amp;</emphasis>, <emphasis>and</emphasis>,
   <emphasis>is_array()</emphasis>, etc.
  </para>
  <para>
-  Si <link linkend="variable.security">$security</link> est actif,
+  Si <link linkend="variable.security"><parameter>$security</parameter></link> est actif,
   alors le tableau <emphasis>IF_FUNCS</emphasis> dans le tableau
-  <link linkend="variable.security.settings">$security_settings</link> (?!).
+  <link linkend="variable.security.settings"><parameter>$security_settings</parameter></link> (?!).
  </para>
  <para>
   La liste suivante pr<70>sente les op<6F>rateurs reconnus, qui doivent <20>tre entour<75>s d'espaces.