added ctags, updated screen => programm listing.

added the technical note founded on the en doc

docs/fr/getting-started.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial -->
+<!-- EN-Revision: 1.4 Maintainer: gerald Status: uptodate -->
 <part id="getting.started">
  <title>Pour commencer</title>
  
@@ -32,14 +32,17 @@
    applicative.
   </para>
   <para>
-   Et maintenant un mot rapide sur ce que Smarty NE fait PAS. Smarty n'a
+   Un des objectifs de Smarty est la s<>paration de la logique m<>tier de la 
-   pas pour pr<70>tention de supprimer compl<70>tement les traitements au sein des
+   logique de pr<70>sentation. Cela signifie que les templates peuvent contenir 
-   templates.
+   des traitements, du moment qu'il soit relatif <20> de la pr<70>sentation.
-   Il est tout <20> fait envisageable de recontrer un traitement dans un template,
+   Inclure d'autres templates, alterner les couleurs des lignes 
-   <EFBFBD> condition que ce dernier ne d<>sserve que des besoins de pr<70>sentation.
+   d'un tableau, mettre du texte en majuscule, parcourir un tableau de donn<6E>es
-   Un conseil : laissez la logique applicative en dehors des templates et
+   pour l'afficher, etc. sont toutes des actions relatives <20> du traitement
-   la logique de pr<70>sentation en dehors de l'application. A l'avenir, cela permet
+   de pr<70>sentation. Cela ne signifie pas que Smarty requiert une telle s<>paration
-   une meilleure gestion des <20>v<EFBFBD>nements.
+   de votre part. Smarty ne sais pas quoi est quoi, c'est donc <20> vous de placer
+   la logique de pr<70>sentation dans vos templates. Ainsi, si vous NE d<>sirez PAS
+   disposer de logique m<>tier dans vos templates, placez tous vos contenus
+   dans des variables au format texte uniquement.
   </para>
   <para>
    L'un des aspects unique de Smarty est la compilation des templates.
@@ -108,12 +111,16 @@
    <example>
     <title>fichiers de la biblioth<74>que SMARTY</title>
     <screen>
-     Smarty.class.php
+<![CDATA[
-     Smarty_Compiler.class.php
+Smarty.class.php
-     Config_File.class.php
+Smarty_Compiler.class.php
-     debug.tpl
+Config_File.class.php
-    /plugins/*.php (tous !)</screen>
+debug.tpl
-   </example>
+/core/*.php (tous)
+/plugins/*.php (tous)
+]]>
+    </screen>   
+  </example>
    
    <para>
     Smarty utilise une constante PHP appel<65>e <link
@@ -135,40 +142,58 @@
    
    <example>
     <title>cr<EFBFBD>er une instance de Smarty</title>
-    <screen>
+    <programlisting role="php">
-     require('Smarty.class.php');
+<![CDATA[
-    $smarty = new Smarty;</screen>
+<?php
+require('Smarty.class.php');
+$smarty = new Smarty;
+?>
+]]>
+    </programlisting>
    </example>
    
    <para>
     Essayez de lancer le script ci-dessus. Si vous obtenez une erreur indiquant
     que le fichier <emphasis>Smarty.class.php</emphasis> n'est pas trouv<75>,
-    tentez l'une des choses suivantes :
+    tentez l'une des actions suivantes :
    </para>
    
    <example>
     <title>fournir un chemin absolu vers la biblioth<74>que Smarty</title>
-    <screen>
+    <programlisting role="php">
-     require('/usr/local/lib/php/Smarty/Smarty.class.php');
+<![CDATA[
-    $smarty = new Smarty;</screen>
+<?php
+require('/usr/local/lib/php/Smarty/Smarty.class.php');
+$smarty = new Smarty;
+?>
+]]>
+    </programlisting>
    </example>
    
    <example>
     <title>Ajouter le r<>pertoire de la biblioth<74>que au chemin de php_include</title>
-    <screen>
+    <programlisting role="php">
-     // Editez le fichier php.ini, ajoutez le r<>pertoire de la
+<![CDATA[
-     // biblioth<74>que Smarty au include_path et red<65>marrez le serveur Web.
+<?php
-     // Cela devrait ensuite fonctionner :
+// Editez votre fichier php.ini file, ajoutez le chemin de la 
-     require('Smarty.class.php');
+// biblioth<74>que Smarty et red<65>marrez les serveur web.
-    $smarty = new Smarty;</screen>
+// la ligne suivante doit alors fonctionner :
-   </example>
+require('Smarty.class.php');
+$smarty = new Smarty;
+?>
+]]>   </example>
    
    <example>
     <title>D<EFBFBD>finir explicitement la constante SMARTY_DIR</title>
-    <screen>
+    <programlisting role="php">
-     define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
+<![CDATA[
-     require(SMARTY_DIR.'Smarty.class.php');
+<?php
-    $smarty = new Smarty;</screen>
+define('SMARTY_DIR', '/usr/local/lib/php/Smarty/');
+require(SMARTY_DIR . 'Smarty.class.php');
+$smarty = new Smarty;
+?>
+]]>
+    </programlisting>
    </example>
    
    <para>
@@ -209,33 +234,43 @@
     l'arborescence Web,
     il s'agit du script auquel l'internaute a acc<63>s. Nous allons l'appeler
     "index.php" et le placer dans un sous-r<>pertoire
-    appel<65> "/livredor/". Il est pratique de configurer le serveur Web de
+    appel<65> "/livredor/". 
+   </para> 
+
+   <note>
+    <title>Technical Note</title>
+    <para>
+   Il est pratique de configurer le serveur Web de
     sorte que "index.php" soit identifi<66> comme fichier
     par d<>faut de ce r<>pertoire. Aicnsi, si l'on tape
     "http://www.mydomain.com/livredor/", le script index.php soit
     ex<65>cut<75> sans que "index.php" ne soit sp<73>cifi<66> dans l'URL. Avec Apache
     vous pouvez r<>gler cela en ajoutant "index.php" <20> la ligne o<> se
     trouve DirectoryIndex (s<>parez chaque entr<74>e par un espace).
-   </para>
+    </para>
+   </note>
    <para>
     Jetons un coup d'oeil <20> la structure de fichier obtenue :
    </para>
    
    <example>
     <title>exemple de structure de fichiers</title>
-    <screen>
+    <screen><![CDATA[
-     /usr/local/lib/php/Smarty/Smarty.class.php
+/usr/local/lib/php/Smarty/Smarty.class.php
-     /usr/local/lib/php/Smarty/Smarty_Compiler.class.php
+/usr/local/lib/php/Smarty/Smarty_Compiler.class.php
-     /usr/local/lib/php/Smarty/Config_File.class.php
+/usr/local/lib/php/Smarty/Config_File.class.php
-     /usr/local/lib/php/Smarty/debug.tpl
+/usr/local/lib/php/Smarty/debug.tpl
-     /usr/local/lib/php/Smarty/plugins/*.php
+/usr/local/lib/php/Smarty/core/*.php
-     
+/usr/local/lib/php/Smarty/plugins/*.php
-     /web/www.mydomain.com/smarty/livredor/templates/
+
-     /web/www.mydomain.com/smarty/livredor/templates_c/
+/web/www.mydomain.com/smarty/livredor/templates/
-     /web/www.mydomain.com/smarty/livredor/configs/
+/web/www.mydomain.com/smarty/livredor/templates_c/
-     /web/www.mydomain.com/smarty/livredor/cache/
+/web/www.mydomain.com/smarty/livredor/configs/
-     
+/web/www.mydomain.com/smarty/livredor/cache/
-    /web/www.mydomain.com/docs/livredor/index.php</screen>
+
+/web/www.mydomain.com/docs/livredor/index.php
+]]>
+</screen>
    </example>
    
    <para>
@@ -250,16 +285,19 @@
     et le groupe auquel il appartient.
    </para>
    
-   
    <example>
     <title>r<EFBFBD>gler les permissions d'acc<63>s</title>
     <screen>
-     
+    <programlisting role="shell">
-     chown nobody:nobody /web/www.mydomain.com/smarty/templates_c/
+<![CDATA[
-     chmod 770 /web/www.mydomain.com/smarty/templates_c/
+chown nobody:nobody /web/www.mydomain.com/smarty/livredor/templates_c/
-     
+chmod 770 /web/www.mydomain.com/smarty/livredor/templates_c/
-     chown nobody:nobody /web/www.mydomain.com/smarty/cache/
+
-    chmod 770 /web/www.mydomain.com/smarty/cache/</screen>
+chown nobody:nobody /web/www.mydomain.com/smarty/livredor/cache/
+chmod 770 /web/www.mydomain.com/smarty/livredor/cache/
+]]>
+    </programlisting>
+</screen>
    </example>
    
    <note>
@@ -281,10 +319,12 @@
    <example>
     <title>Edition de  /web/www.mydomain.com/smarty/templates/index.tpl</title>
     <screen>
-     
+<![CDATA[
-     {* Smarty *}
+
-     
+{* Smarty *}
-    Hello, {$name}!</screen>
+
+Hello, {$name}!
+]]></screen>
    </example>
    
    
@@ -312,7 +352,9 @@
    <example>
     <title><EFBFBD>dition de  /web/www.mydomain.com/docs/livredor/index.php</title>
     <screen>
-     // charge la biblioth<74>que Smarty
+<![CDATA[
+<?php     
+    // charge la biblioth<74>que Smarty
      require('Smarty.class.php');
      
      $smarty = new Smarty;
@@ -324,7 +366,11 @@
      
      $smarty->assign('name','Ned');
      
-    $smarty->display('index.tpl');</screen>
+    $smarty->display('index.tpl');
+?>
+?>
+]]>
+    </screen>
    </example>
    
    <note>
@@ -370,8 +416,9 @@
    
    <example>
     <title><EFBFBD>dition de /php/includes/livredor/setup.php</title>
-    <screen>
+<programlisting role="php">
-     
+<![CDATA[
+<?php
      // charge la librairie Smarty
      require('Smarty.class.php');
      
@@ -399,7 +446,10 @@
      $this->assign('app_name','Guest Book');
      }
      
-    }</screen>
+    }
+?>
+]]>
+    </programlisting>
    </example>
    
    <para>
@@ -408,16 +458,20 @@
    
    <example>
     <title><EFBFBD>dition de /web/www.mydomain.com/docs/livredor/index.php</title>
-    <screen>
+   <programlisting role="php">
-     
+<![CDATA[
+<?php     
      require('livredor/setup.php');
      
      $smarty = new Smarty_livredor;
      
      $smarty->assign('name','Ned');
      
-    $smarty->display('index.tpl');</screen>
+    $smarty->display('index.tpl');
-   </example>
+    
+?>
+]]>
+   </programlisting>   </example>
    
    <para>
     Vous savez maintenant qu'il est facile de cr<63>er une instance de Smarty,