sync with EN

2025-08-05 10:54:27 +02:00 · 2005-12-04 20:38:28 +00:00
parent b955a3e840
commit 88ba6506ba
9 changed files with 137 additions and 93 deletions
--- a/docs/fr/programmers/api-functions/api-append-by-ref.xml
+++ b/docs/fr/programmers/api-functions/api-append-by-ref.xml
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+
 <refentry id="api.append.by.ref">
 <refnamediv>
-  <refname>append_by_ref</refname>
-  <refpurpose></refpurpose>
+  <refname>append_by_ref()</refname>
+  <refpurpose>Ajoute des valeurs par r<>f<EFBFBD>rence</refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>append_by_ref</methodname>
   <methodparam><type>string</type><parameter>varname</parameter></methodparam>
@@ -16,7 +17,7 @@
  </methodsynopsis>
  <para>
   Utilis<69>e pour <link linkend="api.append">ajouter</link> des valeurs <20> un 
-   template par r<>f<EFBFBD>rence plut<75>t que par copie. 
+   template par r<>f<EFBFBD>rence plut<75>t que par copie.
   Si vous ajoutez une variable par r<>f<EFBFBD>rence puis changez sa
   valeur, le changement est aussi r<>percut<75> sur la valeur assign<67>e.
   Pour les <link linkend="advanced.features.objects">objets</link>,
@@ -40,7 +41,7 @@ $smarty->append_by_ref('Adresse',$address);
   </programlisting>
  </example>
  <para>
-   Voir aussi 
+   Voir aussi
   <link linkend="api.append">append()</link> et
   <link linkend="api.assign">assign()</link>.
 </para>
--- a/docs/fr/programmers/api-functions/api-append.xml
+++ b/docs/fr/programmers/api-functions/api-append.xml
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+
 <refentry id="api.append">
 <refnamediv>
-  <refname>append</refname>
-  <refpurpose></refpurpose>
+  <refname>append()</refname>
+  <refpurpose>Ajoute un <20>l<EFBFBD>ment <20> un tableau assign<67></refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>append</methodname>
   <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
@@ -19,12 +20,11 @@
   <methodparam choice="opt"><type>bool</type><parameter>merge</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Utilis<EFBFBD>e pour ajouter un <20>l<EFBFBD>ment <20> un tableau assign<67>. Si vous utilisez
-   cette fonction avec une cha<68>ne de caract<63>res, elle est convertie en
-   tableau auquel on ajoute ensuite l'<27>l<EFBFBD>ment. Vous pouvez explicitement 
-   passer des paires nom/valeur. Si vous passez le troisi<73>me param<61>tre
-   (optionel) <20> <literal>true</literal>, la valeur sera fusionn<6E>e avec le 
-   tableau plut<75>t que d'<27>tre ajout<75>e.
+   Si vous utilisez cette fonction avec une cha<68>ne de caract<63>res, elle est
+   convertie en tableau auquel on ajoute ensuite l'<27>l<EFBFBD>ment. Vous pouvez
+   explicitement passer des paires nom/valeur. Si vous passez le troisi<73>me
+   param<EFBFBD>tre (optionel) <20> <literal>true</literal>, la valeur sera fusionn<6E>e
+   avec le tableau plut<75>t que d'<27>tre ajout<75>e.
  </para>
  &note.parameter.merge;
  <example>
--- a/docs/fr/programmers/api-functions/api-assign-by-ref.xml
+++ b/docs/fr/programmers/api-functions/api-assign-by-ref.xml
@@ -1,22 +1,23 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
+
 <refentry id="api.assign.by.ref">
 <refnamediv>
-  <refname>assign_by_ref</refname>
-  <refpurpose></refpurpose>
+  <refname>assign_by_ref()</refname>
+  <refpurpose>Assigne des valeurs par r<>f<EFBFBD>rence</refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>assign_by_ref</methodname>
   <methodparam><type>string</type><parameter>varname</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
  </methodsynopsis>
  <para>
-  Utilis<69>e pour assigner des valeurs aux templates par r<>f<EFBFBD>rence plut<75>t
-  que par copie. R<>f<EFBFBD>rez-vous au manuel PHP pour une explication plus pr<70>cise
-  sur les r<>f<EFBFBD>rences des variables.
+   Utilis<EFBFBD>e pour <link linkend="api.assign">assigner</link> des valeurs aux
+   templates par r<>f<EFBFBD>rence plut<75>t que par copie. R<>f<EFBFBD>rez-vous au manuel PHP
+   pour une explication plus pr<70>cise sur les r<>f<EFBFBD>rences des variables.
 </para>
 <note>
  <title>Note technique</title>
@@ -30,7 +31,7 @@
  </para>
 </note>
 <example>
-  <title>Exemple avec assign_by_ref</title>
+  <title>Exemple avec assign_by_ref()</title>
  <programlisting role="php">
 <![CDATA[
 <?php
@@ -50,6 +51,7 @@ $smarty->assign_by_ref("Adresse",$address);
   </para>
 </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -69,4 +71,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->
+-->
--- a/docs/fr/programmers/api-functions/api-assign.xml
+++ b/docs/fr/programmers/api-functions/api-assign.xml
@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
+
 <refentry id="api.assign">
 <refnamediv>
-  <refname>assign</refname>
-  <refpurpose></refpurpose>
+  <refname>assign()</refname>
+  <refpurpose>Assigne des valeurs au template</refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>assign</methodname>
   <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
@@ -18,12 +19,11 @@
   <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Utilis<EFBFBD>e pour assigner des valeurs aux templates. Vous pouvez
-   explicitement passer des paires nom/valeur, ou des tableaux
-   associatifs contenant des paires nom/valeur.
+   Vous pouvez explicitement passer des paires nom/valeur, ou
+   des tableaux associatifs contenant des paires nom/valeur.
  </para>
  <example>
-   <title>Exemple avec assign</title>
+   <title>Exemple avec assign()</title>
   <programlisting role="php">
 <![CDATA[
 <?php
@@ -33,20 +33,44 @@ $smarty->assign("Adresse",$address);

 // passe un tableau associatif
 $smarty->assign(array('Ville' => 'Lincoln','Pays' => 'Nebraska'));
+
+// Passe une ligne d'une base de donn<6E>es (eg adodb)
+$sql = 'select id, name, email from contacts where contact ='.$id;
+$smarty->assign('contact', $db->getRow($sql));
 ?>
+]]>
+   </programlisting>
+   <para>
+    Acc<63>der <20> cela dans un template avec
+   </para>
+   <programlisting>
+<![CDATA[
+{* notez que les variables sont sensibles <20> la casse, comme en PHP *}
+{$Name}
+{$Address}
+{$city}
+{$state}
+
+{$contact.id}, {$contact.name},{$contact.email}
 ]]>
   </programlisting>
  </example>
  <para>
-   Voir aussi 
+   Pour des assignements plus complexes de tableaux, lisez
+   <link linkend="language.function.foreach">{foreach}</link> et
+   <link linkend="language.function.section">{section}</link>.
+  </para>
+  <para>
+   Voir aussi
   <link linkend="api.assign.by.ref">assign_by_ref()</link>,
+   <link linkend="api.get.template.vars">get_template_vars()</link>,
   <link linkend="api.clear.assign">clear_assign()</link>,
-   <link linkend="api.append">append()</link>,
-   <link linkend="language.function.assign">{assign}</link> et
-   <link linkend="api.get.template.vars">get_template_vars()</link>.
- </para>
+   <link linkend="api.append">append()</link> et
+   <link linkend="language.function.assign">{assign}</link>.
+  </para>
 </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -66,4 +90,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->
+-->
--- a/docs/fr/programmers/api-functions/api-clear-all-assign.xml
+++ b/docs/fr/programmers/api-functions/api-clear-all-assign.xml
@@ -1,27 +1,36 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.clear.all.assign">
 <refnamediv>
-  <refname>clear_all_assign</refname>
-  <refpurpose></refpurpose>
+  <refname>clear_all_assign()</refname>
+  <refpurpose>Efface les valeurs de toutes les variables assign<67>es</refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>clear_all_assign</methodname>
   <void />
  </methodsynopsis>
-  <para>
-   Utilis<69>e pour effacer les valeurs de toutes les variables assign<67>es.
-  </para>
  <example>
-   <title>Exemple avec clear_all_assign</title>
+   <title>Exemple avec clear_all_assign()</title>
   <programlisting role="php">
 <![CDATA[
 <?php
+// passe des paires nom/valeur
+$smarty->assign('Name', 'Fred');
+$smarty->assign('Address', $address);
+
+// affichera
+print_r( $smarty->get_template_vars() );
+
 // efface toutes les variables assign<67>es
 $smarty->clear_all_assign();
+
+// n'affichera rien
+print_r( $smarty->get_template_vars() );
+
 ?>
 ]]>
   </programlisting>
@@ -35,6 +44,7 @@ $smarty->clear_all_assign();
  </para>
 </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -54,4 +64,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->
+-->
--- a/docs/fr/programmers/api-functions/api-clear-all-cache.xml
+++ b/docs/fr/programmers/api-functions/api-clear-all-cache.xml
@@ -1,21 +1,21 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.clear.all.cache">
 <refnamediv>
-  <refname>clear_all_cache</refname>
-  <refpurpose></refpurpose>
+  <refname>clear_all_cache()</refname>
+  <refpurpose>Efface les fichiers de cache des templates</refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>clear_all_cache</methodname>
   <methodparam choice="opt"><type>int</type><parameter>expire_time</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Utilis<EFBFBD>e pour effacer les fichiers de cache des templates. Vous pouvez passer un
-   param<EFBFBD>tre optionnel afin d'indiquer l'<27>ge minimun que doivent avoir
-   les fichiers de cache pour qu'ils soient effac<61>s.
+   Vous pouvez passer un param<61>tre optionnel afin d'indiquer l'<27>ge minimun
+   que doivent avoir les fichiers de cache pour qu'ils soient effac<EFBFBD>s.
  </para>
  <example>
   <title>Exemple avec clear_all_cache</title>
@@ -30,11 +30,13 @@ $smarty->clear_all_cache();
  </example>
  <para>
   Voir aussi
-   <link linkend="api.clear.cache">clear_cache()</link> et
+   <link linkend="api.clear.cache">clear_cache()</link>,
+  <link linkend="api.is.cached">is_cached()</link> et
   le <link linkend="caching">cache</link>.
  </para>
 </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -54,4 +56,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->
+-->
--- a/docs/fr/programmers/api-functions/api-clear-assign.xml
+++ b/docs/fr/programmers/api-functions/api-clear-assign.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.clear.assign">
 <refnamediv>
-  <refname>clear_assign</refname>
-  <refpurpose></refpurpose>
+  <refname>clear_assign()</refname>
+  <refpurpose>Efface la valeur d'une variable assign<67>e</refpurpose>
 </refnamediv>
 <refsect1>
  <title />
@@ -13,19 +14,18 @@
   <methodparam><type>mixed</type><parameter>var</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Efface la valeur d'une variable assign<67>e. Il peut s'agir
-   d'une simple valeur ou d'un tableau de valeur.
+   Il peut s'agir d'une simple valeur ou d'un tableau de valeur.
  </para>
  <example>
-   <title>Exemple avec clear_assign</title>
+   <title>Exemple avec clear_assign()</title>
   <programlisting role="php">
 <![CDATA[
 <?php
 // efface une variable
-$smarty->clear_assign("Name");
+$smarty->clear_assign('Name');

 // efface plusieurs variables
-$smarty->clear_assign(array("Name","Address","Zip"));
+$smarty->clear_assign(array('Name','Address','Zip'));
 ?>
 ]]>
   </programlisting>
@@ -34,6 +34,7 @@ $smarty->clear_assign(array("Name","Address","Zip"));
   Voir aussi
   <link linkend="api.clear.all.assign">clear_all_assign()</link>,
   <link linkend="api.clear.config">clear_config()</link>,
+   <link linkend="api.get.template.vars">get_template_vars()</link>,
   <link linkend="api.assign">assign()</link> et
   <link linkend="api.append">append()</link>.
  </para>
--- a/docs/fr/programmers/api-functions/api-clear-cache.xml
+++ b/docs/fr/programmers/api-functions/api-clear-cache.xml
@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
+
 <refentry id="api.clear.cache">
 <refnamediv>
-  <refname>clear_cache</refname>
-  <refpurpose></refpurpose>
+  <refname>clear_cache()</refname>
+  <refpurpose>Efface le cache d'un template sp<73>cifique</refpurpose>
 </refnamediv>
 <refsect1>
  <title />
@@ -12,39 +13,39 @@
   <type>void</type><methodname>clear_cache</methodname>
   <methodparam><type>string</type><parameter>template</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>cache_id</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter>
+   </methodparam>
   <methodparam choice="opt"><type>int</type><parameter>expire_time</parameter></methodparam>
  </methodsynopsis>
  <para>
-   Utilis<EFBFBD>e pour nettoyer le(s) fichier(s) de cache d'un 
-   <parameter>template</parameter> en particulier.
-   Si vous avez plusieurs fichiers de cache pour ce template, vous
-   pouvez en sp<73>cifier un en particulier en passant son identifiant 
-   <parameter>cache_id</parameter> en deuxi<78>me param<61>tre. 
-   Vous pouvez aussi passer un identifiant de compilation 
-   <parameter>compile_id</parameter> en  troisi<73>me param<61>tre. 
-   Vous pouvez grouper des templates ensemble afin qu'ils puissent 
-   <EFBFBD>tre supprim<69>s en groupe. R<>f<EFBFBD>rez-vous <20> la section sur le
-   <link linkend="caching">cache</link> pour plus d'informations. 
-   Vous pouvez passer un quatri<72>me param<61>tre pour indiquer un <20>ge 
+   Si vous avez <link linkend="caching.multiple.caches">plusieurs fichiers de cache</link>
+   pour ce template, vous pouvez en sp<73>cifier un en particulier en passant son identifiant
+   <parameter>cache_id</parameter> en deuxi<78>me param<61>tre.
+   Vous pouvez aussi passer un identifiant de compilation
+   <link linkend="variable.compile.id"><parameter>$compile_id</parameter></link>
+   en  troisi<73>me param<61>tre. Vous pouvez <link linkend="caching.groups">grouper</link>
+   des templates ensemble afin qu'ils puissent <20>tre supprim<69>s en groupe. R<>f<EFBFBD>rez-vous <20> la
+   section sur le <link linkend="caching">cache</link> pour plus d'informations.
+   Vous pouvez passer un quatri<72>me param<61>tre pour indiquer un <20>ge
   minimum en secondes que le fichier en cache doit avoir avant d'<27>tre effac<61>.
  </para>
  <example>
-   <title>Exemple avec clear_cache</title>
+   <title>Exemple avec clear_cache()</title>
   <programlisting role="php">
 <![CDATA[
 <?php
 // efface le fichier de cache de ce template
-$smarty->clear_cache("index.tpl");
+$smarty->clear_cache('index.tpl');

 // efface un fichier de cache gr<67>ce <20> son identifiant de cache
-$smarty->clear_cache("index.tpl","CACHEID");
+$smarty->clear_cache('index.tpl','CACHEID');
 ?>
 ]]>
   </programlisting>
  </example>
  <para>
   Voir aussi le
+   <link linkend="api.clear.all.cache">clear_all_cache()</link> et
   <link linkend="caching">cache</link>.
  </para>
 </refsect1>
--- a/docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml
+++ b/docs/fr/programmers/api-functions/api-clear-compiled-tpl.xml
@@ -1,31 +1,33 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
+
 <refentry id="api.clear.compiled.tpl">
 <refnamediv>
-  <refname>clear_compiled_tpl</refname>
-  <refpurpose></refpurpose>
+  <refname>clear_compiled_tpl()</refname>
+  <refpurpose>Efface la version compil<69>e d'un template sp<73>cifi<66></refpurpose>
 </refnamediv>
 <refsect1>
-  <title />
+  <title>Description</title>
  <methodsynopsis>
   <type>void</type><methodname>clear_compiled_tpl</methodname>
   <methodparam choice="opt"><type>string</type><parameter>tpl_file</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>compile_id</parameter>
+   </methodparam>
   <methodparam choice="opt"><type>int</type><parameter>exp_time</parameter></methodparam>
  </methodsynopsis>
  <para>
   Utilis<69>e pour effacer la version compil<69>e du template sp<73>cifi<66> ou
   de tous les templates si aucun n'est sp<73>cifi<66>. 
-   Si vous passez uniquement un compile_id, le template compil<69>
-   correspondant <20> ce compile_id sera effac<61>. Si vous passez un
-   exp_time, les templates compil<69>s plus vieux que exp_time secondes
+   Si vous passez uniquement un <link linkend="variable.compile.id">$compile_id</link>,
+   le template compil<69> correspondant <20> ce <link linkend="variable.compile.id">$compile_id</link>
+   sera effac<61>. Si vous passez un exp_time, les templates compil<69>s plus vieux que exp_time secondes
   seront effac<61>s, par d<>faut, tous les templates compil<69>s seront
   effac<61>s au v<> de leurs <20>ges. Cette fonction est destin<69>e <20> un usage 
   avanc<6E> et n'est habituellement pas utilis<69>e.
  </para>
  <example>
-   <title>Exemple avec clear_compiled_tpl</title>
+   <title>Exemple avec clear_compiled_tpl()</title>
   <programlisting role="php">
 <![CDATA[
 <?php
@@ -40,6 +42,7 @@ $smarty->clear_compiled_tpl();
  </example>
 </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -59,4 +62,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
-->
+-->