sync with EN

docs/fr/designers/language-basic-syntax.xml

@@ -1,21 +1,22 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
+
 <chapter id="language.basic.syntax">
  <title>Bases syntaxiques</title>
  <para>
   Toutes les balises Smarty sont entour<75>es de d<>limiteurs. Par d<>faut,
-  ces d<>limiteurs sont <literal>{</literal> et
+  ils sont <literal>{</literal> et
   <literal>}</literal>, mais ils peuvent <20>tre <link linkend="variable.left.delimiter">modifi<EFBFBD>s</link>.
  </para>
  <para>
-  Pour ces exemples, nous supposons que vous utiliserez leur valeur par d<>faut.
+  Pour les exemples de ce manuel, nous supposons que vous utiliserez leur valeur par d<>faut.
   Dans Smarty, le contenu qui est situ<74> en dehors des d<>limiteurs
   est affich<63> comme contenu statique, inchang<6E>. Lorsque Smarty rencontre
   des balises de template, il tente de les comprendre et en affiche la sortie
   appropri<72>e, en lieu et place.
  </para>
- 
+
  &designers.language-basic-syntax.language-syntax-comments;
  &designers.language-basic-syntax.language-syntax-variables;
  &designers.language-basic-syntax.language-syntax-functions;
@@ -23,7 +24,7 @@
  &designers.language-basic-syntax.language-syntax-quotes;
  &designers.language-basic-syntax.language-math;
  &designers.language-basic-syntax.language-escaping;
- 
+
 </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
@@ -44,4 +45,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->

docs/fr/designers/language-basic-syntax/language-syntax-attributes.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.syntax.attributes">
  <title>Param<EFBFBD>tres</title>
@@ -14,7 +14,7 @@
   utilis<69>es en tant que param<61>tres, et ne doivent pas <20>tre entour<75>es de guillemets.
  </para>
  <para>
-  Certains param<61>tres requi<75>rent des valeurs bool<6F>ennes (true / false).
+  Certains param<61>tres requi<75>rent des valeurs bool<6F>ennes (&true; ou &false;).
   Elles peuvent <20>tre sp<73>cifi<66>es par l'une des valeures suivantes, sans guillemet:
   <literal>true</literal>, <literal>on</literal>, et <literal>yes</literal>,
   ou <literal>false</literal>, <literal>off</literal>, et <literal>no</literal>.

docs/fr/designers/language-basic-syntax/language-syntax-comments.xml

@@ -1,16 +1,25 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready -->
 
 <sect1 id="language.syntax.comments">
  <title>Commentaires</title>
  <para>
   Les commentaires dans Smarty sont entour<75>s d'asterisques,
   et entour<75>s par le <link linkend="variable.left.delimiter">d<EFBFBD>limiteurs</link>
-  de cette fa<66>on : <literal>{* voici un commentaire *}</literal>
+  de cette fa<66>on :
+  </para>
+    <informalexample>
+   <programlisting>
+<![CDATA[
+{* ceci est un comentaire *}
+]]>
+   </programlisting>
+  </informalexample>
+  <para>
   Les commentaires Smarty ne sont PAS affich<63>s dans la sortie finale du
-  template, diff<66>remment des <literal>&lt;!-- commentaires HTML --&gt;</literal>
-  et sont utilis<69>s pour des notes internes, dans le template que personne ne verra ;)
+  template, diff<66>remment des <literal>&lt;!-- commentaires HTML --&gt;</literal>.
+  Ils sont utilis<69>s pour des notes internes, dans le template que personne ne verra ;)
  </para>
  <example>
   <title>Commentaires dans un template</title>
@@ -52,6 +61,17 @@ Un bloc de commentaires multilignes contenant les cr
 </select>
 *}
 
+<!-- L'affichage de l'en-t<>te est d<>sactiv<69> -->
+{* $affiliate|upper *}
+
+{* Vous ne pouvez pas imbriquer des commentaires *}
+{*
+<select name="company">
+  {* <option value="0">-- none -- </option> *}
+  {html_options options=$vals selected=$selected_id}
+</select>
+*}
+
 {* Balise cvs pour un template, ci-dessous, le 36 DOIT <20>TRE une devise am<61>ricaine sinon,
 il sera converti en cvs.. *}
 {* &#36;Id: Exp &#36; *}

docs/fr/designers/language-basic-syntax/language-syntax-quotes.xml

@@ -1,27 +1,39 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.9 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.10 Maintainer: gerald Status: ready -->
 
 <sect1 id="language.syntax.quotes">
  <title>Variables ins<6E>r<EFBFBD>es dans des cha<68>nes de caract<63>res</title>
+
+ <itemizedlist>
+  <listitem>
  <para>
   Smarty est capable d'interpr<70>ter les
   <link   linkend="language.syntax.variables">variables</link>  <link
   linkend="api.assign">assign<EFBFBD>es</link> <20> l'int<6E>rieur de
   cha<68>nes entre guillemets, du moment que leur nom est exclusivement compos<6F>
   de chiffres, lettres, underscores et crochets
-  (Voir le <ulink url="&url.php-manual;language.variables">nommage</ulink>). Si le nom de la variable
+  Voir le <ulink url="&url.php-manual;language.variables">nommage</ulink> pour plus de d<>tails.
+  </para></listitem>
+
+  <listitem><para>
+  Si le nom de la variable
   contient tout autre caract<63>re (point, r<>f<EFBFBD>rence <20> un objet, etc.)
   la variable doit <20>tre entour<75>e <link linkend="language.syntax.quotes">d'apostrophes
-  inverses</link> (`). Vous ne pouvez jamais ins<6E>rer de
- <link linkend="language.modifiers">modificateurs</link>, ils doivent toujours <20>tre appliquer <20>
+  inverses</link> (`).
+  </para></listitem>
+
+  <listitem><para>
+  Vous ne pouvez jamais ins<6E>rer de
+  <link linkend="language.modifiers">modificateurs</link>, ils doivent toujours <20>tre appliquer <20>
   l'ext<78>rieur des guillemets.
- </para>
+ </para></listitem>
+ </itemizedlist>
+
  <example>
-  <title>Syntaxe d'insertion de variables dans des cha<68>nes</title>
+  <title>Exemples de synthaxes</title>
   <programlisting>
 <![CDATA[
-EXEMPLE DE SYNTAXE :
 {func var="test $foo test"}       <-- comprends $foo
 {func var="test $foo_bar test"}   <-- comprends $foo_bar
 {func var="test $foo[0] test"}    <-- comprends $foo[0]
@@ -29,13 +41,32 @@ EXEMPLE DE SYNTAXE :
 {func var="test $foo.bar test"}   <-- comprends $foo (not $foo.bar)
 {func var="test `$foo.bar` test"} <-- comprends $foo.bar
 {func var="test `$foo.bar` test"|escape} <-- modifieurs <20> l'ext<78>rieur des guillemets !
+]]>
+  </programlisting>
+</example>
 
-EXEMPLE PRATIQUE:
-{include file="subdir/$tpl_name.tpl"} <-- remplace $tpl_name avec la valeur
-{cycle values="one,two,`$smarty.config.myval`"} <-- doit comporter les apostrophes inverses
+ <example>
+  <title>Exemples pratiques</title>
+  <programlisting>
+<![CDATA[
+{* remplacera $tpl_name par la valeur *}
+{include file="subdir/$tpl_name.tpl"}
+
+{* ne remplacera pas $tpl_name *}
+{include file='subdir/$tpl_name.tpl'} <--
+
+{* doit contenir des apostophes inverses car il contient un . *}
+{cycle values="one,two,`$smarty.config.myval`"}
+
+{* identique <20> $module['contact'].'.tpl' dans un script PHP
+{include file="`$module.contact`.tpl"}
+
+{* identique <20> $module[$view].'.tpl' dans un script PHP
+{include file="$module.$view.tpl"}
 ]]>
   </programlisting>
  </example>
+
  <para>
   Voir aussi
   <link linkend="language.modifier.escape"><varname>escape</varname></link>.

docs/fr/designers/language-builtin-functions.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 -->
 
 <chapter id="language.builtin.functions">
  <title>Fonctions natives</title>
@@ -16,7 +16,7 @@
   Quelques-unes de ces fonctions ont un attribut
   <parameter>assign</parameter> qui r<>cup<75>re le r<>sultat de la
   fonction et la place dans une variable nomm<6D>e dans le template plut<75>t que
-  de l'afficher.tout comme la fonction
+  de l'afficher ; tout comme la fonction
   <link linkend="language.function.assign"><varname>{assign}</varname></link>.
  </para>
 

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.14 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.15 Maintainer: gerald Status: ready -->
 
 <sect1 id="language.function.capture">
  <title>{capture}</title>
@@ -59,7 +59,8 @@
    </tbody>
   </tgroup>
  </informaltable>
- <caution>
+ <note>
+ <title>Attention</title>
   <para>
    Fa<46>tes attention lorsque vous interceptez la sortie de commandes
    <link linkend="language.function.insert"><varname>{insert}</varname></link>.
@@ -69,7 +70,7 @@
    suppos<6F>es s'ex<65>cuter dans un contenu en cache, ne tentez pas de capturer
    ce contenu.
   </para>
- </caution>
+</note>
  <para>
   <example>
    <title>{capture} avec le nom de l'attribut</title>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.12 Maintainer: gerald Status: ready -->
+<!-- EN-Revision: 1.13 Maintainer: gerald Status: ready -->
 
 <sect1 id="language.function.php">
  <title>{php}</title>
@@ -15,11 +15,11 @@
   <title>Notes techniques</title>
   <para>
    Pour acc<63>der aux variables PHP dans les blocks <varname>{php}</varname>, vous devriez avoir besoin
-   d'utiliser le mot cl<63> PHP <ulink url="&url.php-manual;global">global</ulink>.
+   d'utiliser le mot cl<63> PHP <ulink url="&url.php-manual;global"><literal>global</literal></ulink>.
   </para>
  </note>
  <example>
-  <title>Exemple avec {php}</title>
+  <title>Exemple avec la balise {php}</title>
   <programlisting>
 <![CDATA[
 {php}

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.19 Maintainer: yannick Status: ready -->
 
 <sect1 id="language.function.section">
  <title>{section},{sectionelse}</title>

docs/fr/designers/language-custom-functions/language-function-popup-init.xml

@@ -1,6 +1,6 @@
 <?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.popup.init">
  <title>{popup_init}</title>
@@ -51,6 +51,19 @@
 ]]>
   </programlisting>
  </example>
+
+<note>
+<title>Validation XHTML</title>
+<para><literal>{popup_init}</literal> ne valide pas en validation stricte et vous devriez
+ obtenir l'erreur :
+<literal>document type does not allow element "div" here;</literal>
+(i.e. une balise <literal>&lt;div&gt;</literal> dans la balise <literal>&lt;head&gt;</literal>).
+
+Ceci signifie que vous devez inclure les balises <literal>&lt;script&gt;</literal> et
+<literal>&lt;div&gt;</literal> manuellement.
+</para>
+</note>
+
 </sect1>
 
 <!-- Keep this comment at the end of the file

docs/fr/designers/language-modifiers/language-modifier-escape.xml

@@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.16 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready -->
 
 <sect1 id="language.modifier.escape">
  <title>escape</title>
  <para>
-  Utile pour encoder / <20>chapper une variable pour quelles soient compatibles
-  pour les <literal>url</literal> <literal>html</literal>, pour les hexad<61>cimaux,
-  pour les entit<EFBFBD>s hexad<61>cimales, pour <literal>javascript</literal>
-  et pour les e-mails.
+  <varname>escape</varname> est utilis<69> pour encoder / <20>chapper
+  une variable pour quelles soient compatibles
+  avec les <literal>url</literal> <literal>html</literal>, avec les hexad<61>cimaux,
+  avec les entit<69>s hexad<61>cimales, avec <literal>javascript</literal>
+  et avec les e-mails.
   Par d<>faut, ce param<61>tre est <literal>html</literal>.
  </para>
  <informaltable frame="all">
@@ -73,37 +74,36 @@ $smarty->assign('EmailAddress','smarty@example.com');
 ]]>
   </programlisting>
   <para>
-   O<EFBFBD> le template est :
+   Voici des exemples de template avec <literal>escape</literal> suivis par l'affichage produit.
   </para>
   <programlisting>
 <![CDATA[
-{$titreArticle}
-{$titreArticle|escape}
-{$titreArticle|escape:'html'}    {* escapes  &amp; &quot; &#039; &lt; &gt; *}
-{$titreArticle|escape:'htmlall'} {* escapes ALL html entities *}
-{$titreArticle|escape:'url'}
-{$titreArticle|escape:'quotes'}
+{$articleTitle}
+'Stiff Opposition Expected to Casketless Funeral Plan'
+
+{$articleTitle|escape}
+&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039;
+
+{$articleTitle|escape:'html'}    {* <20>chappe les caract<63>res  & " ' < > *}
+&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039;
+
+{$articleTitle|escape:'htmlall'} {* <20>chappe toutes les entit<69>s html *}
+&#039;Stiff Opposition Expected to Casketless Funeral Plan&#039;
+
+<a href="?title={$articleTitle|escape:'url'}">cliquez-ici</a>
+<a href="?title=%27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27">cliquez-ici</a>
+
+{$articleTitle|escape:'quotes'}
+\'Stiff Opposition Expected to Casketless Funeral Plan\'
+
 <a href="mailto:{$EmailAddress|escape:"hex"}">{$EmailAddress|escape:"hexentity"}</a>
-{$EmailAddress|escape:'mail'}    {* ceci convertit l'e-mail en texte *}
+{$EmailAddress|escape:'mail'}    {* ceci convertit un email en texte *}
+<a href="mailto:%62%6f%..snip..%65%74">&#x62;&#x6f;&#x62..snip..&#x65;&#x74;</a>
+
 {'mail@example.com'|escape:'mail'}
+smarty [AT] example [DOT] com
 ]]>
   </programlisting>
-  <para>
-   Affichera :
-  </para>
-  <screen>
-<![CDATA[
-'Stiff Opposition Expected to Casketless Funeral Plan'
-&amp;#039;Stiff Opposition Expected to Casketless Funeral Plan&amp;#039;
-&amp;#039;Stiff Opposition Expected to Casketless Funeral Plan&amp;#039;
-&amp;#039;Stiff Opposition Expected to Casketless Funeral Plan&amp;#039;
-%27Stiff+Opposition+Expected+to+Casketless+Funeral+Plan%27
-\'Stiff Opposition Expected to Casketless Funeral Plan\'
-<a href="mailto:%62%6f%..snip..%65%74">&#x62;&#x6f;&#x62..snip..&#x65;&#x74;</a>
-smarty [AT] example [DOT] com
-mail [AT] example [DOT] com
-]]>
-  </screen>
    </example>
 
    <example>
@@ -123,7 +123,7 @@ mail [AT] example [DOT] com
    Et ceci est utile pour les e-mails, mais lisez plut<75>t la documentation de
    <link linkend="language.function.mailto"><varname>{mailto}</varname></link></para>
 <screen>
- <![CDATA[
+<![CDATA[
 {* email address mangled *}
 <a href="mailto:{$EmailAddress|escape:'hex'}">{$EmailAddress|escape:'mail'}</a>
 ]]>

docs/fr/programmers/api-functions/api-display.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
 
 <refentry id="api.display">
  <refnamediv>
@@ -39,15 +39,15 @@ $smarty->caching = true;
 if(!$smarty->is_cached('index.tpl')) {
 
     // quelques donn<6E>es
-    $address = "245 N 50th";
+    $address = '245 N 50th';
     $db_data = array(
-                       "Ville" => "Lincoln",
-                       "Pays" => "Nebraska",
-                       "Code postal" = > "68502"
+                       'Ville' => 'Lincoln',
+                       'Pays' => 'Nebraska',
+                       'Code postal' = > '68502'
      );
 
-    $smarty->assign("Nom","Fred");
-    $smarty->assign("Adresse",$address);
+    $smarty->assign('Nom','Fred');
+    $smarty->assign('Adresse',$address);
     $smarty->assign($db_data);
 
 }

docs/fr/programmers/plugins/plugins-inserts.xml

@@ -1,6 +1,6 @@
 <?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 -->
 
 <sect1 id="plugins.inserts">
  <title>Insertions</title>
@@ -47,8 +47,7 @@ function smarty_insert_time($params, &$smarty)
         return;
     }
 
-    $datetime = strftime($params['format']);
-    return $datetime;
+    return strftime($params['format']);
 }
 ?>
 ]]>