[DOCUMENTATION] French: add translation (provided by new translator vhoen)

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@19933 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/fr/tutorials/lucene-index-opening.xml

@@ -5,9 +5,9 @@
     <title>Ouverture et création d'index</title>
 
     <para>
-        Toutes les opérations sur l'index (ex: créer un nouvel index, ajouter un document à l'index,
-        supprimer un document, chercher dans l'index) nécessite un objet index. Il peut être
-        obtenu avec l'une des méthodes suivantes.
+        Toutes les opérations sur l'index (ex: créer un nouvel index, ajouter un document à
+        l'index, supprimer un document, chercher dans l'index) nécessite un objet index. Il peut
+        être obtenu avec l'une des méthodes suivantes.
     </para>
 
     <example id="learning.lucene.index-opening.creation">

documentation/manual/fr/tutorials/lucene-index-structure.xml

@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 19807 -->
+<!-- Reviewed: no -->
+<sect1 id="learning.lucene.index-structure">
+    <title>Structure d'index Lucene</title>
+
+    <para>
+        Afin d'utiliser l'intégralité des fonctionnalités de
+        <classname>Zend_Search_Lucene</classname> avec un maximum de performances, il est
+        nécessaire que vous compreniez la structure interne d'un index.
+    </para>
+
+    <para>
+        Un <emphasis>index</emphasis> est stocké dans un ensemble de fichier au sein d'un
+        seul répertoire.
+    </para>
+
+    <para>
+        Un <emphasis>index</emphasis> est un ensemble indépendant de
+        <emphasis>segments</emphasis> dans lesquels sont stockées des informations au sujet d'un
+        sous-ensemble de documents indexés. Chaque <emphasis>segment</emphasis> a son propre
+        <emphasis>dictionnaire de terme</emphasis>, son propre index de dictionnaire de terme, et
+        son propre stockage de document (valeur de champ stocké)
+        <footnote>
+            <para>Depuis Lucene 2.3, les fichiers de stockage de document peuvent être partagés
+            entre les segments; cependant, <classname>Zend_Search_Lucene</classname> n'utilise pas
+            cette possibilité</para>
+        </footnote>.
+        Toutes les informations de segments sont stockées dans un fichier
+        <filename>_xxxxx.cfs</filename>, où <emphasis>xxxxx</emphasis> est le nom d'un
+        segment.
+    </para>
+
+    <para>
+        Dès qu'un fichier de segment d'index est créé, il ne peut être mis à jour. De
+        nouveaux documents sont ajoutés à de nouveaux segments. Les documents supprimés sont
+        seulement marqués comme supprimés dans un fichier facultatif
+        <filename>&lt;segmentname&gt;.del</filename>.
+    </para>
+
+    <para>
+        La mise à jour de document est effectuée en tant qu'opérations distincts de
+        suppression et d'ajout, même si elle est effectuée en utilisant un appel à
+        l'<acronym>API</acronym> <methodname>update()</methodname>
+        <footnote>
+            <para>Cet appel est fourni uniquement par Java Lucene pour le moment, mais il est prévu
+            d'étendre l'<acronym>API</acronym> <classname>Zend_Search_Lucene</classname> avec une
+            fonctionnalité similaire</para>
+        </footnote>.
+        Ceci simplifie l'ajout de nouveaux documents, et permet de mettre à jour
+        simultanément à l'aide des opérations de recherche.
+    </para>
+
+    <para>
+        D'un autre coté, utiliser plusieurs segments (avoir un document par segment est un
+        cas exceptionnel) augmente le temps de recherche&#160;:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                La récupération d'un terme depuis le dictionnaire est effectué pour chaque
+                segment&#160;;
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Le dictionnaire de terme de l'index est préchargé pour chaque segment (ce
+                processus occupe la plupart du temps de recherche pour de simples requêtes et
+                nécessite aussi de la mémoire supplémentaire).
+            </para>
+        </listitem>
+    </itemizedlist>
+
+    <para>
+        Si les termes du dictionnaires de recherche atteignent un point de saturation, la
+        recherche à travers un segment est <emphasis>N</emphasis> fois plus rapide que la recherche
+        à travers <emphasis>N</emphasis> segments dans la plupart des cas.
+    </para>
+
+    <para>
+        <emphasis>L'optimisation d'index</emphasis> fusionne deux segments ou plus en un
+        segment unique. Un nouveau segment est ajouté à la liste des segments de l'index, et les
+        anciens segments sont exclus.
+    </para>
+
+    <para>
+        La mise à jour de la liste de segments s'effectue de manière atomique. Ceci donne la
+        capacité d'ajouter de nouveaux documents simultanément, d'effectuer des optimisations
+        d'index, et de chercher à travers l'index.
+    </para>
+
+    <para>
+        L'auto-optimisation d'index s'effectue après chaque génération de segment. Elle
+        fusionne l'ensemble des plus petits segments en des segments plus grands, et les segments
+        plus grands en des segments encore plus grands, si nous avons suffisamment de segments à
+        fusionner.
+    </para>
+
+    <para>L'auto optimisation d'index est contrôlé par trois options&#160;:</para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                <emphasis>MaxBufferedDocs</emphasis> (Le nombre minimal de documents requis
+                avant que les documents mis en mémoire tampon soit écrits dans un nouveau
+                segment)&#160;;
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis>MaxMergeDocs</emphasis> (Le plus grand nombre de documents
+                fusionnés par une opération d'optimisation)&#160;; et
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <emphasis>MergeFactor</emphasis> (qui détermine la fréquence à laquelle les
+                indices de segments sont fusionnés par les opérations d'auto-optimisation).
+            </para>
+        </listitem>
+    </itemizedlist>
+
+    <para>
+        Si nous ajoutons un documents par exécution de script,
+        <emphasis>MaxBufferedDocs</emphasis> n'est finalement pas utilisé (seul un segment avec un
+        seul document est créé à la fin de l'exécution du script, moment auquel démarre le
+        processus d'auto-optimisation).
+    </para>
+</sect1>

documentation/manual/fr/tutorials/lucene-indexing.xml

@@ -5,8 +5,8 @@
     <title>Indexation</title>
 
     <para>
-        L'indexation s'effectue en ajoutant un nouveau document à un index existant ou à un nouvel
-        index :
+        L'indexation s'effectue en ajoutant un nouveau document à un index existant ou à un
+        nouvel index&#160;:
     </para>
 
     <programlisting language="php"><![CDATA[
@@ -14,7 +14,8 @@ $index->addDocument($doc);
 ]]></programlisting>
 
     <para>
-        Il y a deux manières de créer un objet document. La première est de le faire manuellement.
+        Il y a deux manières de créer un objet document. La première est de le faire
+        manuellement.
     </para>
 
     <example id="learning.lucene.indexing.doc-creation">
@@ -30,12 +31,13 @@ $doc->addField(Zend_Search_Lucene_Field::binary('avatar', $avatarData));
     </example>
 
     <para>
-        La seconde méthode est de le charger depuis un fichier <acronym>HTML</acronym>
-        ou Microsoft Office 2007 :
+        La seconde méthode est de le charger depuis un fichier <acronym>HTML</acronym> ou
+        Microsoft Office 2007&#160;:
     </para>
 
     <example id="learning.lucene.indexing.doc-loading">
         <title>Chargement de document</title>
+
         <programlisting language="php"><![CDATA[
 $doc = Zend_Search_Lucene_Document_Html::loadHTML($htmlString);
 $doc = Zend_Search_Lucene_Document_Docx::loadDocxFile($path);
@@ -45,8 +47,8 @@ $doc = Zend_Search_Lucene_Document_Xlsx::loadXlsxFile($path);
     </example>
 
     <para>
-        Si un document est chargé depuis l'un des formats supportés, il peut quand même être étendu
-        manuellement avec des champs définis par l'utilisateur.
+        Si un document est chargé depuis l'un des formats supportés, il peut quand même être
+        étendu manuellement avec des champs définis par l'utilisateur.
     </para>
 
     <sect2 id="learning.lucene.indexing.policy">
@@ -58,28 +60,29 @@ $doc = Zend_Search_Lucene_Document_Xlsx::loadXlsxFile($path);
         </para>
 
         <para>
-            Vous pourriez avoir besoin d'une configuration d'indexation à la demande
-            (quelque chose comme le système <acronym>OLTP</acronym>).
-            Sur de test systèmes, vous ajoutez généralement un document par requête utilisateur.
-            De cette manière, l'option <emphasis>MaxBufferedDocs</emphasis> n'affectera pas le
-            système. D'un autre coté, <emphasis>MaxMergeDocs</emphasis> est vraiment utile, car il
-            vous permet de limiter le temps d'exécution maximum du script.
-            <emphasis>MergeFactor</emphasis> doit être définis par une valeur qui conserve un
-            équilibre entre le temps moyen d'indexation (il est aussi affecté par temps
-            d'optimisation moyen) et les performance de recherche (le niveau d'optimisation dépend
-            du nombre de segments).
+            Vous pourriez avoir besoin d'une configuration d'indexation à la demande (quelque
+            chose comme le système <acronym>OLTP</acronym>). Sur de test systèmes, vous ajoutez
+            généralement un document par requête utilisateur. De cette manière, l'option
+            <emphasis>MaxBufferedDocs</emphasis> n'affectera pas le système. D'un autre coté,
+            <emphasis>MaxMergeDocs</emphasis> est vraiment utile, car il vous permet de limiter le
+            temps d'exécution maximum du script. <emphasis>MergeFactor</emphasis> doit être définis
+            par une valeur qui conserve un équilibre entre le temps moyen d'indexation (il est
+            aussi affecté par temps d'optimisation moyen) et les performance de recherche (le
+            niveau d'optimisation dépend du nombre de segments).
         </para>
 
         <para>
-            Si vous allez surtout effectuer des mises à jour d'index par lot, votre configuration
-            devrait utiliser une option <emphasis>MaxBufferedDocs</emphasis> définis à la valeur
-            maximum supporté par la quantité de mémoire disponible.
+            Si vous allez surtout effectuer des mises à jour d'index par lot, votre
+            configuration devrait utiliser une option <emphasis>MaxBufferedDocs</emphasis> définis
+            à la valeur maximum supporté par la quantité de mémoire disponible.
             <emphasis>MaxMergeDocs</emphasis> et <emphasis>MergeFactor</emphasis> doivent être
             définis à des valeurs réduisant au maximum le recours à l'auto-optimisation
-            <footnote><para>Une limite additionnelle est le nombre maximum de gestionnaire de
-            fichiers supporter par le système d'exploitation pour les opérations concurrente
-            d'ouverture</para></footnote>. Les optimisations complètes d'index doivent être
-            appliquées après l'indexation.
+            <footnote>
+                <para>Une limite additionnelle est le nombre maximum de gestionnaire de fichiers
+                supporter par le système d'exploitation pour les opérations concurrente
+                d'ouverture</para>
+            </footnote>.
+            Les optimisations complètes d'index doivent être appliquées après l'indexation.
         </para>
 
         <example id="learning.lucene.indexing.optimization">
@@ -91,10 +94,11 @@ $index->optimize();
         </example>
 
         <para>
-            Dans certaines configuration, il est plus efficace d'effectuer une série de mise à jour
-            de l'index en organisant une file de requête de mise à jour et de traiter plusieurs
-            requête de mise à jour dans une seule exécution de script. Ceci réduit la charge
-            d'ouverture de l'index et permet d'utiliser le tampon de document de l'index.
+            Dans certaines configuration, il est plus efficace d'effectuer une série de mise
+            à jour de l'index en organisant une file de requête de mise à jour et de traiter
+            plusieurs requête de mise à jour dans une seule exécution de script. Ceci réduit la
+            charge d'ouverture de l'index et permet d'utiliser le tampon de document de
+            l'index.
         </para>
     </sect2>
 </sect1>

documentation/manual/fr/tutorials/lucene-pagination.xml

@@ -19,6 +19,7 @@
 
     <example id="learning.lucene.pagination.example">
         <title>Exemple de pagination de résultat de recherche</title>
+
         <programlisting language="php"><![CDATA[
 $cacheId = md5($query);
 if (!$resultSet = $cache->load($cacheId)) {