Added some french translations

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

documentation/manual/fr/module_specs/Zend_Config_Json.xml

@@ -0,0 +1,244 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect1 id="zend.config.adapters.json">
+    <title>Zend_Config_Json</title>
+
+    <sect2 id="zend.config.adapters.json.intro">
+        <title>Aperçu</title>
+
+        <para>
+            <ulink url="http://www.json.org/">JSON</ulink> est un acronyme pour "JavaScript Object
+            Notation"; compatible avec JavaScript, c'est un format d'échange de données inter-langage.
+            <classname>Zend_Config_Json</classname> est une extension de
+            <classname>Zend_Config</classname> permettant l'utilisation du format <acronym>JSON</acronym>.
+        </para>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.json.quick-start">
+        <title>QuickStart</title>
+
+        <para>
+             Voici une version JSON de la configuration d'une application standard.
+        </para>
+
+        <programlisting language="json"><![CDATA[
+{
+    "production":{
+        "phpSettings":{
+            "display_startup_errors": false,
+            "display_errors": false
+        },
+        "includePaths":{
+            "library": "APPLICATION_PATH/../library"
+        },
+        "bootstrap":{
+            "path": "APPLICATION_PATH/Bootstrap.php",
+            "class": "Bootstrap"
+        },
+        "appnamespace": "Application",,
+        "resources":{
+            "frontController":{
+                "controllerDirectory": "APPLICATION_PATH/controllers",
+                "moduleDirectory": "APPLICATION_PATH/modules",
+                "params":{
+                    "displayExceptions": false
+                }
+            },
+            "modules":[],
+            "db":{
+                "adapter": "pdo_sqlite",
+                "params":{
+                    "dbname": "APPLICATION_PATH/../data/db/application.db"
+                }
+            },
+            "layout":{
+                "layoutPath": "APPLICATION_PATH/layouts/scripts/"
+            }
+        }
+    },
+    "staging":{
+        "_extends": "production"
+    },
+    "testing":{
+        "_extends": "production",
+        "phpSettings":{
+            "display_startup_errors": true,
+            "display_errors": true
+        },
+    },
+    "development":{
+        "_extends": "production",
+        "phpSettings":{
+            "display_startup_errors": true,
+            "display_errors": true
+        },
+        "resources":{
+            "frontController":{
+                "params":{
+                    "displayExceptions": true
+                }
+            }
+        }
+    }
+}
+]]></programlisting>
+
+        <para>
+            Pour l'utiliser, instanciez simplement <classname>Zend_Config_Json</classname> en lui
+            indiquant le chemin vers ce fichier ainsi que la section à charger. Par défaut,
+            les constantes trouvées dans les valeurs seront substituées par leurs valeurs.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$config = new Zend_Config_Json(
+    APPLICATION_PATH . '/configs/application.json',
+    APPLICATION_ENV
+);
+]]></programlisting>
+
+        <para>
+            Une fois instancié, l'utilisation est classique, comme un objet de configuration.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$db = Zend_Db::factory($config->resources->db);
+]]></programlisting>
+
+        <warning>
+            <title>Utilisez les constantes avec précaution</title>
+
+            <para>
+                <acronym>JSON</acronym> possède une structure stricte concernant les types de données.
+                Ainsi, vous devez vous assurer que vos constantes sont utilisées correctement. Pour les
+                constantes de type chaine de caractères, encapsulez les de doubles quotes (""). Pour
+                les constantes d'autres types, vous pouvez omettre les quotes, mais soyez alors
+                certains qu'elles ne retournent pas des chaines, sinon vous rencontrerez des erreurs
+                d'analyse. Si vous doutez, encapsulez le contenu dans des chaines à doubles quotes.
+            </para>
+        </warning>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.json.options">
+        <title>Options de configuration</title>
+
+        <para>
+            Les options suivantes peuvent être passées comme clés au troisième paramètre
+            <varname>$options</varname> du constructeur.
+        </para>
+
+        <variablelist>
+            <title>Zend_Config_Json Options</title>
+
+            <varlistentry>
+                <term>allow_modifications/allowModifications</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, <classname>Zend_Config</classname> est en lecture seule.
+                        Passer cette option à <constant>true</constant> autorisera la modification
+                        de l'objet.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term>skip_extends/skipExtends</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, à chaque fois qu'une section étend une autre,
+                        <classname>Zend_Config</classname> regroupera cette section avec son parent.
+                        Utiliser le booléen <constant>true</constant> pour cette option désactivera ce
+                        comportement, la configuration de la section sera telle-quelle.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term>ignore_constants</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, <classname>Zend_Config_Json</classname> remplacera toutes les
+                        constantes trouvées dans le fichier par leurs valeurs respectives. Passez
+                        le booléen <constant>true</constant> à cette option pour désactiver cette
+                        fonctionnalité.
+                    </para>
+
+                    <para>
+                        Notez qu'ignorer les constantes peut mener à des erreurs d'analyse, en particulier
+                        si les constantes sont utilisées pour des entiers, des flottants ou des valeurs
+                        booléennes. La manière la plus sûre est d'encapsuler les constantes dans des
+                        quotes.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.json.methods">
+        <title>Méthodes disponibles</title>
+
+        <variablelist>
+            <varlistentry id="zend.config.adapters.json.methods.constructor">
+                <term>
+                    <methodsynopsis>
+                        <methodname>__construct</methodname>
+                        <methodparam>
+                            <funcparams>$json, $section = null, $options = false</funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Constructeur. <varname>$json</varname> doit pointer vers un fichier JSON valide.
+                        Si <varname>$section</varname> est précisé, seule la section indiquée sera analysée.
+                        <varname>$options</varname> est documenté dans <link
+                            linkend="zend.config.adapters.json.options">la section options</link>.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry id="zend.config.adapters.json.methods.set-ignore-constants">
+                <term>
+                    <methodsynopsis>
+                        <methodname>setIgnoreConstants</methodname>
+                        <methodparam>
+                            <funcparams>$flag</funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Cette méthode <emphasis>statique</emphasis> est utilisée pour changer le
+                        comportement global de l'analyse des constantes trouvées dans les fichiers
+                        JSON. Par défaut, les constantes sont remplacées par leurs valeurs. Passer
+                        le booléen <constant>true</constant> à cette méthode surchargera ce
+                        comportement. (Vous pouvez changer le comportement par instance en utilisant
+                        l'option <varname>ignore_constants</varname>.)
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry id="zend.config.adapters.json.methods.ignore-constants">
+                <term>
+                    <methodsynopsis>
+                        <methodname>ignoreConstants</methodname>
+                        <methodparam>
+                            <funcparams></funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Cette méthode <emphasis>statique</emphasis> retourne la valeur actuelle
+                        de <varname>ignore_constants</varname>.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </sect2>
+</sect1>

documentation/manual/fr/module_specs/Zend_Config_Yaml.xml

@@ -0,0 +1,277 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect1 id="zend.config.adapters.yaml">
+    <title>Zend_Config_Yaml</title>
+
+    <sect2 id="zend.config.adapters.yaml.intro">
+        <title>Aperçu</title>
+
+        <para>
+            <ulink url="http://www.yaml.org/">YAML</ulink> est un acronyme récursif signifiant "YAML
+            Ain't Markup Language", et peuyt se résumer en "standard de sérialization de données
+            human friendly pour tous les langages de programmation." Il est souvent utilisé pour
+            la configuration d'applications.
+        </para>
+
+        <para>
+            <classname>Zend_Config_Yaml</classname> est une petite extensions de
+            <classname>Zend_Config</classname>. Il inclut un analyseur capable de reconnaitre la syntaxe
+            YAML utilisées pour des besoins de configuration et permet de préciser d'autres analyseurs
+            à utiliser pour le support de syuyntaxes complexes (e.g., ext/syck, spyc, sfYaml, etc.).
+        </para>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.yaml.quick-start">
+        <title>QuickStart</title>
+
+        <para>
+            Voici une version YAML de la configuration d'une application standard.
+        </para>
+
+        <programlisting language="yaml"><![CDATA[
+production:
+  phpSettings:
+    display_startup_errors: false
+    display_errors: false
+  includePaths:
+    library: APPLICATION_PATH/../library
+  bootstrap:
+    path: APPLICATION_PATH/Bootstrap.php
+    class: "Bootstrap"
+  appnamespace: "Application"
+  resources:
+    frontController:
+      controllerDirectory: APPLICATION_PATH/controllers
+      moduleDirectory: APPLICATION_PATH/modules
+      params:
+        displayExceptions: false
+    modules:
+    db:
+      adapter: "pdo_sqlite"
+      params:
+        dbname: APPLICATION_PATH/../data/db/application.db
+    layout:
+      layoutPath: APPLICATION_PATH/layouts/scripts/
+
+staging: 
+  _extends: production
+
+testing: 
+  _extends: production
+  phpSettings:
+    display_startup_errors: true
+    display_errors: true
+
+development:
+  _extends: production
+  phpSettings:
+    display_startup_errors: true
+    display_errors: true
+  resources:
+    frontController:
+      params:
+        displayExceptions: true
+
+]]></programlisting>
+
+        <para>
+            Pour l'utiliser, instanciez simplement <classname>Zend_Config_Yaml</classname> en lui
+            indiquant le chemin vers ce fichier ainsi que la section à charger. Par défaut,
+            les constantes trouvées dans les valeurs seront substituées par leurs valeurs.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$config = new Zend_Config_Yaml(
+    APPLICATION_PATH . '/configs/application.yaml',
+    APPLICATION_ENV
+);
+]]></programlisting>
+
+        <para>
+            Une fois instancié, l'utilisation est classique, comme un objet de configuration.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$db = Zend_Db::factory($config->resources->db);
+]]></programlisting>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.yaml.options">
+        <title>Options de configuration</title>
+
+        <para>
+            Les options suivantes peuvent être passées comme clés au troisième paramètre
+            <varname>$options</varname> du constructeur.
+        </para>
+
+        <variablelist>
+            <title>Zend_Config_Yaml Options</title>
+
+            <varlistentry>
+                <term>allow_modifications</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, <classname>Zend_Config</classname> est en lecture seule.
+                        Passer cette option à <constant>true</constant> autorisera la modification
+                        de l'objet.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term>skip_extends</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, à chaque fois qu'une section étend une autre,
+                        <classname>Zend_Config</classname> regroupera cette section avec son parent.
+                        Utiliser le booléen <constant>true</constant> pour cette option désactivera ce
+                        comportement, la configuration de la section sera telle-quelle.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term>ignore_constants</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, <classname>Zend_Config_Yaml</classname> remplacera toutes les
+                        constantes trouvées dans le fichier par leurs valeurs respectives. Passez
+                        le booléen <constant>true</constant> à cette option pour désactiver cette
+                        fonctionnalité.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term>yaml_decoder</term>
+
+                <listitem>
+                    <para>
+                        Par défaut, <classname>Zend_Config_Yaml</classname> utilise une analyseur interne,
+                        <methodname>Zend_Config_Yaml::decode()</methodname>, pour analyser et traiter les
+                        fichiers YAML. Vous pouvez préciser une fonction de callback à utiliser comme
+                        analyseur externe via cette option.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.yaml.methods">
+        <title>Méthodes disponibles</title>
+
+        <variablelist>
+            <varlistentry id="zend.config.adapters.yaml.methods.constructor">
+                <term>
+                    <methodsynopsis>
+                        <methodname>__construct</methodname>
+                        <methodparam>
+                            <funcparams>$yaml, $section = null, $options = false</funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Constructeur. <varname>$yaml</varname> doit pointer vers un fichier YAML valide.
+                        Si <varname>$section</varname> est précisé, seule la section indiquée sera analysée.
+                        <varname>$options</varname> est documenté dans <link
+                            linkend="zend.config.adapters.yaml.options">la section options</link>.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry id="zend.config.adapters.yaml.methods.decode">
+                <term>
+                    <methodsynopsis>
+                        <methodname>decode</methodname>
+                        <methodparam>
+                            <funcparams>$yaml</funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Analyse et tranforme une chaine YAML en un tableau PHP.
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry id="zend.config.adapters.yaml.methods.set-ignore-constants">
+                <term>
+                    <methodsynopsis>
+                        <methodname>setIgnoreConstants</methodname>
+                        <methodparam>
+                            <funcparams>$flag</funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Cette méthode <emphasis>statique</emphasis> est utilisée pour changer le
+                        comportement global de l'analyse des constantes trouvées dans les fichiers
+                        YAML. Par défaut, les constantes sont remplacées par leurs valeurs. Passer
+                        le booléen <constant>true</constant> à cette méthode surchargera ce
+                        comportement. (Vous pouvez changer le comportement par instance en utilisant
+                        l'option <varname>ignore_constants</varname>.)
+                    </para>
+                </listitem>
+            </varlistentry>
+
+            <varlistentry id="zend.config.adapters.yaml.methods.ignore-constants">
+                <term>
+                    <methodsynopsis>
+                        <methodname>ignoreConstants</methodname>
+                        <methodparam>
+                            <funcparams></funcparams>
+                        </methodparam>
+                    </methodsynopsis>
+                </term>
+
+                <listitem>
+                    <para>
+                        Cette méthode <emphasis>statique</emphasis> retourne la valeur actuelle
+                        de <varname>ignore_constants</varname>.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </sect2>
+
+    <sect2 id="zend.config.adapters.yaml.examples">
+        <title>Exemples</title>
+
+        <example id="zend.config.adapters.yaml.examples.sf-yaml">
+            <title>Utiliser Zend_Config_Yaml avec sfYaml</title>
+
+            <para>
+                Comme précisé dans la <link linkend="zend.config.adapters.yaml.options">section des options
+                </link>, <classname>Zend_Config_Yaml</classname> vous permet de spécifier votre propre
+                analyseur YAML.
+            </para>
+
+            <para>
+                <ulink url="http://components.symfony-project.org/yaml/">sfYaml</ulink> est un <ulink
+                    url="http://components.symfony-project.org/">Symfony component</ulink> qui implémente
+                un analyseur YAML complet pour PHP, et inclus des fonctionnalités additionnelles comme l'analyse
+                d'expressions PHP incluses dans du YAML. Dans cet exemple, nous utilisons
+                <methodname>sfYaml::load()</methodname> comme méthode callback pour le décodage du YAML.
+                <emphasis>(Note: ceci suppose que la classe <classname>sfYaml</classname> est déja chargée
+                ou disponible pour auto-chargement.)</emphasis>
+            </para>
+
+            <programlisting language="php"><![CDATA[
+$config = new Zend_Config_Yaml(
+    APPLICATION_PATH . '/configs/application.yaml',
+    APPLICATION_ENV,
+    array('yaml_decoder' => array('sfYaml', 'load'))
+);
+]]></programlisting>
+        </example>
+    </sect2>
+</sect1>

documentation/manual/fr/module_specs/Zend_Filter-Alnum.xml

@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.alnum">
+    <title>Alnum</title>
+
+    <para>
+        <classname>Zend_Filter_Alnum</classname> est un filtre qui ne retourne que des caractères
+        alphabétiques et des chiffres. Tout autre caractère est supprimé.
+    </para>
+
+    <sect3 id="zend.filter.set.alnum.options">
+        <title>Options supportées par Zend_Filter_Alnum</title>
+
+        <para>
+            Les options suivantes sont supportées par <classname>Zend_Filter_Alnum</classname>:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowwhitespace</property></emphasis>: Si activée, les espaces
+                    seront autorisés, autrement ils sont supprimés. Par défaut, les espaces ne sont pas
+                    autorisés et supprimés.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.alnum.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voyez l'exemple suivant pour le comportement par défaut de ce filtre.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alnum();
+$return = $filter->filter('This is (my) content: 123');
+// retourne 'Thisismycontent123'
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus retourne 'Thisismycontent123'. Comme vous le voyez, tous les espaces et le double-point
+            sont filtrés.
+        </para>
+
+        <note>
+            <para>
+                <classname>Zend_Filter_Alnum</classname> fonctionne sur presque tous les langages. Les exceptions
+                sont le chinois, le japonnais et le coréen. Ces langues utiliseront l'alphabet anglais plutot que
+                le leur. Le langage est détecté par <classname>Zend_Locale</classname>.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.filter.set.alnum.whitespace">
+        <title>Autoriser les espaces</title>
+
+        <para>
+            <classname>Zend_Filter_Alnum</classname> peut aussi autoriser les espaces. Ca peut être utile, voyez
+            l'exemple suivant:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alnum(array('allowwhitespace' => true));
+$return = $filter->filter('This is (my) content: 123');
+// retourne 'This is my content 123'
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus retourne 'This is my content 123'. Comme vous le voyez, le double-point est filtré
+            ainsi que les parenthèses, mais pas les espaces.
+        </para>
+
+        <para>
+            Pour changer <property>allowWhiteSpace</property> après construction de l'objet, utilisez
+            <methodname>setAllowWhiteSpace()</methodname> et
+            <methodname>getAllowWhiteSpace()</methodname>.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/fr/module_specs/Zend_Filter-Alpha.xml

@@ -0,0 +1,84 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.alpha">
+    <title>Alpha</title>
+
+    <para>
+        <classname>Zend_Filter_Alpha</classname> est un filtre qui va retourner
+        <varname>$value</varname> en enlevant tout caractère non alphabétique. Ce filtre propose
+        une option pour autoriser le caractère espace.
+    </para>
+
+    <sect3 id="zend.filter.set.alpha.options">
+        <title>Options supportées par Zend_Filter_Alpha</title>
+
+        <para>
+            Les options suivantes sont supportées par <classname>Zend_Filter_Alpha</classname>:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowwhitespace</property></emphasis>: Si activée, les espaces
+                    seront autorisés. Par défaut, ils sont supprimés.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.alpha.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alpha();
+
+print $filter->filter('This is (my) content: 123');
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus affiche 'Thisismycontent'. Remarquez que les espaces et le double-point
+            ont été supprimés.
+        </para>
+
+        <note>
+            <para>
+                <classname>Zend_Filter_Alpha</classname> fonctionne sur presque tous les langages. Les exceptions
+                sont le chinois, le japonnais et le coréen. Ces langues utiliseront l'alphabet anglais plutot que
+                le leur. Le langage est détecté par <classname>Zend_Locale</classname>.
+            </para>
+        </note>
+    </sect3>
+
+     <sect3 id="zend.filter.set.alpha.whitespace">
+         <title>Autoriser les espaces</title>
+
+        <para>
+            <classname>Zend_Filter_Alpha</classname> peut aussi autoriser les espaces. Ca peut être utile, voyez
+            l'exemple suivant:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alpha(array('allowwhitespace' => true));
+
+print $filter->filter('This is (my) content: 123');
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus retourne 'This is my content'. Comme vous le voyez, le double-point ainsi que
+            les chiffres et les parenthèses sont filtrés mais pas les espaces.
+        </para>
+
+        <para>
+            Pour changer <property>allowWhiteSpace</property> après construction de l'objet, utilisez
+            <methodname>setAllowWhiteSpace()</methodname> et
+            <methodname>getAllowWhiteSpace()</methodname>.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/fr/module_specs/Zend_Filter-BaseName.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.basename">
+    <title>BaseName</title>
+
+    <para>
+        <classname>Zend_Filter_BaseName</classname> permet de retourner le nom d'un fichier
+        dans une chaine représentant un chemin vers ce fichier.
+    </para>
+
+    <sect3 id="zend.filter.set.basename.options">
+        <title>Options supportées par Zend_Filter_BaseName</title>
+
+        <para>
+            Il n'y a pas d'option supplémentaire gérée par <classname>Zend_Filter_BaseName</classname>.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.filter.set.basename.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_BaseName();
+
+print $filter->filter('/vol/tmp/filename');
+]]></programlisting>
+
+        <para>
+            Ceci va afficher 'filename'.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_BaseName();
+
+print $filter->filter('/vol/tmp/filename.txt');
+]]></programlisting>
+
+        <para>
+            Ceci affichera '<filename>filename.txt</filename>'.
+        </para>
+    </sect3>
+</sect2>

documentation/manual/fr/module_specs/Zend_Filter-Digits.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.digits">
+    <title>Digits</title>
+
+    <para>
+        Retourne la chaine <varname>$value</varname>, mais uniquement les chiffres
+        la composant.
+    </para>
+
+     <sect3 id="zend.filter.set.digits.options">
+        <title>Options supportées par Zend_Filter_Digits</title>
+
+        <para>
+            Il n'y a pas d'option supplémentaire pour <classname>Zend_Filter_Digits</classname>.
+        </para>
+    </sect3>
+
+     <sect3 id="zend.filter.set.digits.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Digits();
+
+print $filter->filter('October 2009');
+]]></programlisting>
+
+        <para>
+            Ceci affiche "2009".
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Digits();
+
+print $filter->filter('HTML 5 for Dummies');
+]]></programlisting>
+
+        <para>
+            Ceci affiche "5".
+        </para>
+    </sect3>
+</sect2>

documentation/manual/fr/module_specs/Zend_Filter-Dir.xml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.dir">
+    <title>Dir</title>
+
+    <para>
+        Ce filtre retournera le dossier dans une chaine représentant le chemin vers
+        un fichier.
+    </para>
+
+     <sect3 id="zend.filter.set.dir.options">
+        <title>Options supportées par Zend_Filter_Dir</title>
+
+        <para>
+            Il n'y a pas d'options supplémentaire pour <classname>Zend_Filter_Dir</classname>.
+        </para>
+    </sect3>
+
+     <sect3 id="zend.filter.set.dir.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Dir();
+
+print $filter->filter('/etc/passwd');
+]]></programlisting>
+
+        <para>
+            Ceci affiche "<filename>/etc</filename>".
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Dir();
+
+print $filter->filter('C:/Temp/x');
+]]></programlisting>
+
+        <para>
+            Ceci affiche "<filename>C:/Temp</filename>".
+        </para>
+    </sect3>
+</sect2>

documentation/manual/fr/module_specs/Zend_Filter-HtmlEntities.xml

@@ -0,0 +1,181 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.htmlentities">
+    <title>HtmlEntities</title>
+
+    <para>
+        Retourne la chaine <varname>$value</varname> en convertissant les caractères en leur entité
+        <acronym>HTML</acronym> équivalente si elle existe.
+    </para>
+
+    <sect3 id="zend.filter.set.htmlentities.options">
+        <title>Options gérées par Zend_Filter_HtmlEntities</title>
+
+        <para>
+            Les options suivantes sont supportées par <classname>Zend_Filter_HtmlEntities</classname>:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>quotestyle</property></emphasis>: Equivalent au paramètre
+                    <emphasis>quote_style</emphasis> de la fonction <acronym>PHP</acronym> htmlentities.
+                    Ceci permet de définir ce qui sera fait avec les 'simples' et "doubles" quotes.
+                    Les constantes suivantes sont acceptées:
+                    <constant>ENT_COMPAT</constant>, <constant>ENT_QUOTES</constant>
+                    <constant>ENT_NOQUOTES</constant>, par défaut il s'agira de
+                    <constant>ENT_COMPAT</constant>.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>charset</property></emphasis>: Equivalent au paramètre
+                    <emphasis>charset</emphasis> de la fonction <acronym>PHP</acronym> htmlentities.
+                    Ceci indique le jeu de caractères à utiliser pour le filtre. Contrairement à la fonction
+                    <acronym>PHP</acronym> native, la valeur par défaut est 'UTF-8'. Voyez
+                    "http://php.net/htmlentities" pour la liste des jeux de caractères supportés.
+                </para>
+
+                <note>
+                    <para>
+                     Cette option peut être passées via le paramètre <varname>$options</varname> comme un
+                     tableau ou objet <classname>Zend_Config</classname>. L'encodage ou le jeu de caractères
+                     seront reconnus.
+                    </para>
+                </note>
+            </listitem>
+
+             <listitem>
+                <para>
+                    <emphasis><property>doublequote</property></emphasis>: Equivalent au paramètre
+                    <emphasis>double_encode</emphasis> de la fonction <acronym>PHP</acronym> htmlentities.
+                    Si passé à false, les entités html existantes ne seront pas encodées. Par défaut sur
+                    true (conversion totale).
+                </para>
+
+                <note>
+                    <para>
+                        Cette option peut être passée via le paramètre <varname>$options</varname> ou la
+                        méthode <methodname>setDoubleEncode()</methodname>.
+                    </para>
+                </note>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.htmlentities.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voyez l'exemple qui suit pour le comportement de ce filtre.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities();
+
+print $filter->filter('<');
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.filter.set.htmlentities.quotestyle">
+        <title>Styles de quote</title>
+
+        <para>
+            <classname>Zend_Filter_HtmlEntities</classname> permet de changer les styles de quote
+            à filtrer. Ceci est utile si vous voulez laisser intactes les doubles, simples ou les deux
+            types de quotes. Voici un exemple:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_QUOTES));
+
+$input  = "A 'single' and " . '"double"';
+print $filter->filter($input);
+]]></programlisting>
+
+        <para>
+            Ceci affiche
+            <emphasis>A &#039;single&#039; and &quot;double&quot;</emphasis>. Notez que les 'simples'
+            et les "doubles" quotes ont été filtrées.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_COMPAT));
+
+$input  = "A 'single' and " . '"double"';
+print $filter->filter($input);
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus affichera <emphasis>A 'single' and &quot;double&quot;</emphasis>.
+            Notez que seules les "doubles" quotes ont été filtrées.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_NOQUOTES));
+
+$input  = "A 'single' and " . '"double"';
+print $filter->filter($input);
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus affichera <emphasis>A 'single' and "double"</emphasis>. Notez qu'ici aucune
+            des "doubles" ou 'simples' quotes n'ont été altérées.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.filter.set.htmlentities.">
+        <title>Méthodes d'aide</title>
+
+        <para>
+            Pour changer ou récupérer la valeur de <property>quotestyle</property> après instantiation,
+            les méthodes <methodname>setQuoteStyle()</methodname> et
+            <methodname>getQuoteStyle()</methodname> peuvent être utilisées.
+            <methodname>setQuoteStyle()</methodname> accepte un paramètre
+            <varname>$quoteStyle</varname>. Les constantes suivantes sont autorisées:
+            <constant>ENT_COMPAT</constant>, <constant>ENT_QUOTES</constant>,
+            <constant>ENT_NOQUOTES</constant>
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities();
+
+$filter->setQuoteStyle(ENT_QUOTES);
+print $filter->getQuoteStyle(ENT_QUOTES);
+]]></programlisting>
+
+        <para>
+            Pour changer ou récupérer la valeur de <property>charset</property> après instantiation,
+            les méthodes <methodname>setCharSet()</methodname> et <methodname>getCharSet()</methodname>
+            peuvent être utilisées. <methodname>setCharSet()</methodname> accepte un paramètre
+            <varname>$charSet</varname>. Voyez "http://php.net/htmlentities" pour une liste des valeurs
+            acceptées.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities();
+
+$filter->setQuoteStyle(ENT_QUOTES);
+print $filter->getQuoteStyle(ENT_QUOTES);
+]]></programlisting>
+
+        <para>
+            Pour changer ou récupérer la valeur de <property>doublequote</property> après instantiation,
+            les méthodes <methodname>setDoubleQuote()</methodname> et
+            <methodname>getDoubleQuote()</methodname> peuvent être utilisées.
+            <methodname>setDoubleQuote()</methodname> accepte un booléen
+            <varname>$doubleQuote</varname>.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_HtmlEntities();
+
+$filter->setQuoteStyle(ENT_QUOTES);
+print $filter->getQuoteStyle(ENT_QUOTES);
+]]></programlisting>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/fr/module_specs/Zend_Filter-Int.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.int">
+    <title>Int</title>
+
+    <para>
+        <classname>Zend_Filter_Int</classname> permet de transformer une valeur scalaire contenant un
+        chiffre en entier.
+    </para>
+
+    <sect3 id="zend.filter.set.int.options">
+        <title>Options supportées par Zend_Filter_Int</title>
+
+        <para>
+            Il n'y a pas d'option supplémentaire pour <classname>Zend_Filter_Int</classname>.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.filter.set.int.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Int();
+
+print $filter->filter('-4 is less than 0');
+]]></programlisting>
+
+        <para>
+            Ceci affichera '-4'.
+        </para>
+    </sect3>
+</sect2>

documentation/manual/fr/module_specs/Zend_Filter-StringTrim.xml

@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.stringtrim">
+    <title>StringTrim</title>
+
+    <para>
+        Ce filtre modifie la chaine pour que certains caractères soient supprimés du début et de la
+        fin de la chaine.
+    </para>
+
+     <sect3 id="zend.filter.set.stringtrim.options">
+        <title>Options supportées par Zend_Filter_StringTrim</title>
+
+        <para>
+            Les options suivantes sont gérées par <classname>Zend_Filter_StringTrim</classname>:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>charlist</property></emphasis>: Liste de caractères à
+                    supprimer du début et de la fin de la chaine. Si non précisé, le comportement par
+                    défaut sera de supprimer les espaces du début et de la fin de la chaine.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.stringtrim.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StringTrim();
+
+print $filter->filter(' This is (my) content: ');
+]]></programlisting>
+
+        <para>
+            Ceci affichera 'This is (my) content:'. Notez que les espaces ont été supprimés.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.filter.set.stringtrim.types">
+        <title>Comportement par défaut de Zend_Filter_StringTrim</title>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StringTrim(':');
+// ou new Zend_Filter_StringTrim(array('charlist' => ':'));
+
+print $filter->filter(' This is (my) content:');
+]]></programlisting>
+
+        <para>
+            Ceci affichera 'This is (my) content'. Notez que les espaces et le double-point ont
+            été supprimés. Vous pouvez aussi passer une instance de
+            <classname>Zend_Config</classname> ou un tableau avec la clé 'charlist'. Les méthodes
+            <methodname>setCharList()</methodname> et <methodname>getCharList()</methodname> sont
+            aussi disponibles.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/fr/module_specs/Zend_Filter-StripNewLines.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.stripnewlines">
+    <title>StripNewLines</title>
+
+    <para>
+        Ce filtre supprime tous les caractères de nouvelle ligne dans une chaine.
+    </para>
+
+     <sect3 id="zend.filter.set.strinpnewlines.options">
+        <title>Options supportées par Zend_Filter_StripNewLines</title>
+
+        <para>
+            Il n'y a pas d'option supplémentaire gérée par <classname>Zend_Filter_StripNewLines</classname>.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.filter.set.stripnewlines.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voici un exemple de base:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StripNewLines();
+
+print $filter->filter("This is (my)\n\rcontent: ');
+]]></programlisting>
+
+        <para>
+            Cet exemple affiche 'This is (my) content:'. Notez que tous les caractères de nouvelle ligne
+            ont été supprimés.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/fr/module_specs/Zend_Filter-StripTags.xml

@@ -0,0 +1,139 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<sect2 id="zend.filter.set.striptags">
+    <title>StripTags</title>
+
+    <para>
+        Ce filtre peut supprimer des tags <acronym>XML</acronym> et <acronym>HTML</acronym> depuis
+        une chaine.
+    </para>
+
+    <warning>
+        <title>Zend_Filter_StripTags est potentiellement non sécurisé</title>
+
+        <para>
+            Soyez avertis que <classname>Zend_Filter_StripTags</classname> ne devrait être utilisé que
+            pour supprimer tous les tags.
+        </para>
+
+        <para>
+            Utiliser <classname>Zend_Filter_StripTags</classname> pour créer un site
+            <emphasis>securisé</emphasis> en supprimant certains tags non voulus mènera à un code
+            dangereux.
+        </para>
+
+        <para>
+            <classname>Zend_Filter_StripTags</classname> ne doit pas être utilisé pour éviter les attaques
+            <acronym>XSS</acronym>. Ce filtre n'est pas un remplaçant de Tidy ou HtmlPurifier.
+        </para>
+    </warning>
+
+    <sect3 id="zend.filter.set.striptags.options">
+        <title>Options supportées par Zend_Filter_StripTags</title>
+
+        <para>
+            Les options suivantes sont supportées par <classname>Zend_Filter_StripTags</classname>:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowAttribs</property></emphasis>: Cette option précise les attributs
+                    à accepter. Tous les autres attributs seront supprimés.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>allowTags</property></emphasis>: Cette option liste les tags à accepter.
+                    Tous les autres tags seront supprimés.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.striptags.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Voyez l'exemple qui suit pour l'utilisation de base du filtre:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StripTags();
+
+print $filter->filter('<B>My content</B>');
+]]></programlisting>
+
+        <para>
+            La chaine 'My content' sera affichée.
+        </para>
+
+        <para>
+            Si un tag est cassé ou non fermé, alors tout le contenu qui le suit sera
+            supprimé. Voyez l'exemple qui suit:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StripTags();
+
+print $filter->filter('This contains <a href="http://example.com">no ending tag');
+]]></programlisting>
+
+        <para>
+            Ceci affichera 'This contains'.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.filter.set.striptags.allowtags">
+        <title>Autoriser des tags</title>
+
+        <para>
+            <classname>Zend_Filter_StripTags</classname> permet d'autoriser certains tags. Ceci peut
+            être utilisé pour par exemple autoriser les liens dans un texte.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StripTags(array('allowTags' => 'a'));
+
+$input  = "A text with <br/> a <a href='link.com'>link</a>";
+print $filter->filter($input);
+// retourne: A text with a <a href='link.com'>link</a>
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus supprime tous les tags sauf ceux des liens.
+        </para>
+
+        <warning>
+            <para>
+                N'utilisez pas cette fonctionnalité pour obtenir un code <emphasis>probablement sécurisé</emphasis>. Ce
+                composant ne remplace pas l'utilisation d'un filtre html configuré convenablement.
+            </para>
+        </warning>
+    </sect3>
+
+    <sect3 id="zend.filter.set.striptags.allowattribs">
+        <title>Autoriser des attributs</title>
+
+        <para>
+            Il est possible d'autoriser des attributs.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_StripTags(array('allowAttribs' => 'src'));
+
+$input  = "A text with <br/> a <img src='picture.com' width='100'>picture</img>";
+print $filter->filter($input);
+// retourne: A text with a <img src='picture.com'>picture</img>
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus supprime tous les tags sauf img. Aussi, pour le tag img, tous les attributs sont
+            supprimés sauf src.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->