[DOCUMENTATION] French:

 - add new translations

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

documentation/manual/fr/module_specs/Zend_Validate-Identical.xml

@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 18791 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.validate.set.identical">
+    <title>Identical</title>
+
+    <para>
+        <classname>Zend_Validate_Identical</classname> vous permet de valider si une valeur donnée
+        est identique à une valeur préalablement fournie.
+    </para>
+
+    <sect3 id="zend.validate.set.identical.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            Pour valider si deux valeurs sont identiques, vous devez d'abord fournir la valeur
+            d'origine. L'exemple montre la validation de deux chaînes&#160;:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Identical('origin');
+if ($valid->isValid($value) {
+    return true;
+}
+]]></programlisting>
+
+        <para>
+            La validation retournera <constant>TRUE</constant> seulement si les deux valeurs
+            sont rigoureusement identiques. Dans notre exemple, quand <varname>$value</varname>
+            vaudra "origin".
+        </para>
+
+        <para>
+            Vous pouvez aussi fournir la valeur souhaitée plus tard en utilisant la méthode
+            <methodname>setToken()</methodname> et <methodname>getToken()</methodname> pour
+            récupérer la valeur actuellement paramétrée.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.validate.set.identical.types">
+        <title>Objets identiques</title>
+
+        <para>
+            Bien sûr <classname>Zend_Validate_Identical</classname> ne se limite pas à la
+            validation de chaînes, mais aussi tout type de variable comme un booléen, un
+            entier, un flottant, un tableau et même les objets. Comme énoncé ci-dessus, les
+            valeurs fournies et à valider doivent être identiques.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Identical(123);
+if ($valid->isValid($input)) {
+    // l'entrée est valide
+} else {
+    // l'entrée est incorrecte
+}
+]]></programlisting>
+
+        <note>
+            <title>Comparaison de type</title>
+
+            <para>
+                Il est important de noter que le type de la variable sert aussi lors de la
+                validation. Ceci veut dire que la chaîne <emphasis>"3"</emphasis> n'est pas
+                identique à l'entier <emphasis>3</emphasis>.
+            </para>
+
+            <para>
+                Ceci est aussi valable pour les éléments de formulaires. Ce sont des objets ou
+                des tableaux. Donc vous ne pouvez pas simplement comparer un champs texte qui
+                contient un mot de passe avec une valeur textuelle provenant d'une autre source.
+                L'élément de formualire lui-même est fourni en tant que tableau qui peut aussi
+                contenir des informations additionnelles.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.validate.set.identical.configuration">
+        <title>Configuration</title>
+
+        <para>
+            omme tous les autres validateurs <classname>Zend_Validate_Identical</classname>
+            supporte aussi des paramètres de configuration en tant que paramètre d'entrée.
+            Ceci veut dire que vous pouvez configurer ce validateur avec une objet
+            <classname>Zend_Config</classname>.
+        </para>
+
+        <para>
+            Mais ceci entraîne un changement dont vous devez tenir compte. Quand vous utilisez
+            un tableau en tant qu'entrée du constructeur, vous devez envelopper la valeur
+            d'origine avec la clé <property>token</property>, dans ce cas elle contiendra une
+            valeur unique.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Identical(array('token' => 123));
+if ($valid->isValid($input)) {
+    // l'entrée est valide
+} else {
+    // l'entrée est incorrecte
+}
+]]></programlisting>
+
+        <para>
+            L'exemple ci-dessus valide l'entier 123 car vous avez fourni la valeur en l'associant
+            à la clé <property>token</property>.
+        </para>
+
+        <para>
+            Mais, si vous devez valider un tableau qui contient un seul élément et que cet élément
+            est nommé <property>token</property> alors vous devez l'envelopper comme dans l'example
+            ci-dessous&#160;:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Identical(array('token' => array('token' => 123)));
+if ($valid->isValid($input)) {
+    // l'entrée est valide
+} else {
+    // l'entrée est incorrecte
+}
+]]></programlisting>
+    </sect3>
+</sect2>

documentation/manual/fr/module_specs/Zend_Validate-Sitemap.xml

@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 18822 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.validate.sitemap">
+    <title>Validateurs de Sitemap</title>
+
+    <para>
+        Les validateurs suivant sont conformes au protocole <ulink
+            url="http://www.sitemaps.org/protocol.php"><acronym>XML</acronym> Sitemap</ulink>.
+    </para>
+
+    <sect3 id="zend.validate.sitemap.changefreq">
+        <title>Sitemap_Changefreq</title>
+
+        <para>
+            Valide si oui ou non une chaîne utilisable en tant qu'élément "changefreq" dans un
+            document <acronym>XML</acronym> Sitemap. Les valeurs valides sont&#160;: "always",
+            "hourly", "daily", "weekly", "monthly", "yearly", or "never".
+        </para>
+
+        <para>
+            Retourne <constant>TRUE</constant> si et seulement si la valeur est une chaîne
+            et qu'elle vaut une dès fréquences ci-dessus.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.validate.sitemap.lastmod">
+        <title>Sitemap_Lastmod</title>
+
+        <para>
+            Valide si oui ou non une chaîne utilisable en tant qu'élément "lastmod" dans un
+            document <acronym>XML</acronym> Sitemap. L'élément "lasmod" doit contenir une date
+            sous la forme <acronym>W3C</acronym>, optionnellement en omettant les informations
+            concernant l'heure.
+        </para>
+
+        <para>
+            Retourne <constant>TRUE</constant> si et seulement si la valeur est une chaîne
+            et qu'elle est valide suivant le protocole.
+        </para>
+
+        <example id="zend.validate.sitemap.lastmod.example">
+            <title>Validateur de "lastmod" Sitemap</title>
+            <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Sitemap_Lastmod();
+$validator->isValid('1999-11-11T22:23:52-02:00'); // true
+$validator->isValid('2008-05-12T00:42:52+02:00'); // true
+$validator->isValid('1999-11-11'); // true
+$validator->isValid('2008-05-12'); // true
+$validator->isValid('1999-11-11t22:23:52-02:00'); // false
+$validator->isValid('2008-05-12T00:42:60+02:00'); // false
+$validator->isValid('1999-13-11'); // false
+$validator->isValid('2008-05-32'); // false
+$validator->isValid('yesterday'); // false
+]]></programlisting>
+        </example>
+    </sect3>
+
+    <sect3 id="zend.validate.sitemap.loc">
+        <title>Sitemap_Loc</title>
+
+        <para>
+            Valide si oui ou non une chaîne utilisable en tant qu'élément "loc" dans un
+            document <acronym>XML</acronym> Sitemap. Ceci utilise en interne la méthode
+            <methodname>Zend_Form::check()</methodname>. Vous pouvez en lire davantage avec la
+            <link linkend="zend.uri.validation">validation d'URI</link>.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.validate.sitemap.priority">
+        <title>Sitemap_Priority</title>
+
+        <para>
+            Valide si oui ou non une valeur est utilisable en tant qu'élément "priority" dans un
+            document <acronym>XML</acronym> Sitemap. La valeur doit être un nombre compris entre
+            0.0 et 1.0. Ce validateur accepte à la fois des valeurs numériques ou textuelles.
+        </para>
+
+        <example id="zend.validate.sitemap.priority.example">
+            <title>Validateur de "priority" Sitemap</title>
+
+            <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Sitemap_Priority();
+$validator->isValid('0.1'); // true
+$validator->isValid('0.789'); // true
+$validator->isValid(0.8); // true
+$validator->isValid(1.0); // true
+$validator->isValid('1.1'); // false
+$validator->isValid('-0.4'); // false
+$validator->isValid(1.00001); // false
+$validator->isValid(0xFF); // false
+$validator->isValid('foo'); // false
+]]></programlisting>
+        </example>
+    </sect3>
+</sect2>