sync with EN

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,41 +79,39 @@
  <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
 
-   <?php
+// charge des variables depuis une base de donn<6E>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<6E>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 <20> $trusted_dir *}
-    {include_php file="/chemin/vers/load_nav.php"}
+{* chemin absolu, ou relatif <20> $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>