Просмотр исходного кода

[DOCUMENTATION] French: sync manual

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20085 44c647ce-9c0f-0410-b52a-842ac1e357ba
mikaelkael 16 лет назад
Родитель
Сommit
71171fd9ff

+ 27 - 1
documentation/manual/fr/module_specs/Zend_Mail-CharacterSets.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 19422 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mail.character-sets">
     <title>Jeux de caractères</title>
@@ -21,4 +21,30 @@
             texte.
         </para>
     </note>
+
+    <example id="zend.mail.character-sets.cjk">
+        <title>Usage in CJK languages</title>
+
+        <para>
+            The following example is how to use <classname>Zend_Mail</classname> in Japanese. This is one of
+            <acronym>CJK</acronym> (aka <acronym>CJKV</acronym> ) languages. If you use Chinese, you may use
+            <acronym>HZ-GB-2312</acronym> instead of <acronym>ISO-2022-JP</acronym>.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+//We suppose that character encoding of strings is UTF-8 on PHP script.
+function myConvert($string) {
+    return mb_convert_encoding($string, 'ISO-2022-JP', 'UTF-8');
+}
+
+$mail = new Zend_Mail('ISO-2022-JP');
+//In this case, You can use ENCODING_7BIT because the ISO-2022-JP does not use MSB.
+$mail->setBodyText(myConvert('This is the text of the mail.'), null, Zend_Mime::ENCODING_7BIT);
+$mail->setHeaderEncoding(Zend_Mime::ENCODING_BASE64);
+$mail->setFrom('somebody@example.com', myConvert('Some Sender'));
+$mail->addTo('somebody_else@example.com', myConvert('Some Recipient'));
+$mail->setSubject(myConvert('TestSubject'));
+$mail->send();
+]]></programlisting>
+    </example>
 </sect1>

+ 10 - 7
documentation/manual/fr/module_specs/Zend_Mail-Encoding.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17407 -->
+<!-- EN-Revision: 19518 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mail.encoding">
     <title>Encodage</title>
@@ -8,10 +8,12 @@
         Par défaut, le corps des messages textes et HTML est encodé via le mécanisme
         "quoted-printable". Les en-têtes du message sont aussi encodés avec le mécanisme
         "quoted-printable" si vous ne spécifiez pas base64 avec
-        <methodname>setHeaderEncoding()</methodname>.Tous les fichiers joints sont encodés via base64 si aucun
-        autre encodage n'est spécifié lors de l'appel à <methodname>addAttachment()</methodname> ou assigné plus
-        tard à la partie <acronym>MIME</acronym> de l'objet. Les encodages 7Bit et 8Bit ne se font pour l'instant que
-        sur les données binaires.
+        <methodname>setHeaderEncoding()</methodname>. Si vous utilisez une langue qui n'est pas
+        sur des lettres de type romaines, la base64 sera plus convenable. Tous les fichiers joints
+        sont encodés via base64 si aucun autre encodage n'est spécifié lors de l'appel à
+        <methodname>addAttachment()</methodname> ou assigné plus tard à la partie
+        <acronym>MIME</acronym> de l'objet. Les encodages 7Bit et 8Bit ne se font pour l'instant
+        que sur les données binaires.
     </para>
 
      <para>
@@ -27,9 +29,10 @@
 
     <programlisting language="php"><![CDATA[
 // Par défaut Zend_Mime::ENCODING_QUOTEDPRINTABLE
-$mail = new Zend_Mail('UTF-8');
+$mail = new Zend_Mail('KOI8-R');
 
-// Bascule en encodage Base64
+// Bascule en encodage Base64 parce que le Russe exprimé en KOI8-R est
+// considérablement différent des langues basées sur des lettres romaines
 $mail->setHeaderEncoding(Zend_Mime::ENCODING_BASE64);
 ]]></programlisting>
 

+ 19 - 1
documentation/manual/fr/module_specs/Zend_Mail-Introduction.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 19418 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mail.introduction">
     <title>Introduction</title>
@@ -122,5 +122,23 @@ $mail->send();
                 fonctionne en mode safe.
             </para>
         </note>
+
+        <warning>
+            <title>Transport Sendmail et Windows</title>
+
+            <para>
+                Comme le spécifie le manuel PHP, la fonction <methodname>mail()</methodname> a des
+                comportements différents sous Windows ou sur les systèmes de type *nix. Utiliser
+                le transport Sendmail sous Windows ne fonctionnera pas conjointement avec
+                <methodname>addBcc()</methodname>. La fonction <methodname>mail()</methodname>
+                enverra vers le destinataire BCC de manière à ce que tous les destinataires
+                puissent voir qu'il est destinataire&#160;!
+            </para>
+
+            <para>
+                Ainsi si vous voulez utiliser BCC sur un serveur Windows, utilisez le transport
+                SMTP pour l'envoi&#160;!
+            </para>
+        </warning>
     </sect2>
 </sect1>

+ 24 - 5
documentation/manual/fr/module_specs/Zend_Mail-MultipleEmails.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19426 -->
+<!-- EN-Revision: 20039 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mail.multiple-emails">
     <title>Envoyer plusieurs émail par connexion SMTP</title>
@@ -11,6 +11,17 @@
         que le dialogue SMTP correct est respecté.
     </para>
 
+    <para>
+        Optionally, you can also define a default From email address and name,
+        as well as a default reply-to header. This can be done through the static
+        methods <methodname>setDefaultFrom()</methodname> and
+        <methodname>setDefaultReplyTo()</methodname>. These defaults will be used when you
+        don't specify a From/Reply-to Address or -Name until the defaults are reset (cleared).
+        Resetting the defaults can be done through the use of the
+        <methodname>clearDefaultFrom()</methodname> and
+        <methodname>clearDefaultReplyTo</methodname>.
+    </para>
+
     <example id="zend.mail.multiple-emails.example-1">
         <title>Envoyer plusieurs émail par connexion SMTP</title>
 
@@ -19,17 +30,25 @@
 $config = array('name' => 'sender.example.com');
 $transport = new Zend_Mail_Transport_Smtp('mail.example.com', $config);
 
+// Ajouter les nom et adresses "From" & "Reply-To" pour tous les émails
+// à envoyer
+Zend_Mail::setDefaultFrom('sender@example.com', 'John Doe');
+Zend_Mail::setDefaultReplyTo('replyto@example.com','Jane Doe');
+
 // Boucle à travers les messages
 for ($i = 0; $i < 5; $i++) {
     $mail = new Zend_Mail();
-    $mail->addTo('studio@peptolab.com', 'Test');
-    $mail->setFrom('studio@peptolab.com', 'Test');
+    $mail->addTo('studio@example.com', 'Test');
     $mail->setSubject(
         'Démonstration - Envoyer plusieurs emails par connexion SMTP'
     );
     $mail->setBodyText('...Votre message ici...');
     $mail->send($transport);
 }
+
+// Effacer les valeurs par défaut
+Zend_Mail::clearDefaultFrom();
+Zend_Mail::clearDefaultReplyTo();
 ]]></programlisting>
     </example>
 
@@ -56,8 +75,8 @@ $transport->setConnection($protocol);
 // Boucle à travers les messages
 for ($i = 0; $i < 5; $i++) {
     $mail = new Zend_Mail();
-    $mail->addTo('studio@peptolab.com', 'Test');
-    $mail->setFrom('studio@peptolab.com', 'Test');
+    $mail->addTo('studio@example.com', 'Test');
+    $mail->setFrom('studio@example.com', 'Test');
     $mail->setSubject(
         'Démonstration - Envoyer plusieurs emails par connexion SMTP'
     );

+ 44 - 4
documentation/manual/fr/module_specs/Zend_Mime.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 19440 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mime.mime">
     <title>Zend_Mime</title>
@@ -31,6 +31,13 @@
                 </listitem>
 
                 <listitem>
+                     <para>
+                        <methodname>Zend_Mime::encode()</methodname>: encode
+                        une chaîne en utilisant l'encodage spécifié.
+                    </para>
+                </listitem>
+            
+                <listitem>
                     <para>
                         <methodname>Zend_Mime::encodeBase64()encodeBase64()</methodname>: encode
                         une chaîne en utilisant base64.
@@ -39,11 +46,25 @@
 
                 <listitem>
                     <para>
-                        <methodname>Zend_Mime::encodeQuotedPrintable()</methodname>: Encode une
+                        <methodname>Zend_Mime::encodeQuotedPrintable()</methodname>: encode une
                         chaîne avec le mécanisme quoted-printable.
                     </para>
                 </listitem>
-                </itemizedlist>
+
+                <listitem>
+                    <para>
+                        <methodname>Zend_Mime::encodeBase64Header()</methodname>: encode
+                        une chaîne en utilisant base64 pour les entêtes émail.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <methodname>Zend_Mime::encodeQuotedPrintableHeader()</methodname>: ncode une
+                        chaîne avec le mécanisme quoted-printable pour les entêtes émail.
+                    </para>
+                </listitem>
+            </itemizedlist>
             </para>
 
         <para>
@@ -93,7 +114,26 @@
                 <listitem>
                     <para><classname>Zend_Mime::DISPOSITION_INLINE</classname>: "inline"</para>
                 </listitem>
-                </itemizedlist>
+
+                <listitem>
+                    <para>
+                        <constant>Zend_Mime::MULTIPART_ALTERNATIVE</constant>:
+                        'multipart/alternative'
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <constant>Zend_Mime::MULTIPART_MIXED</constant>: 'multipart/mixed'
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <constant>Zend_Mime::MULTIPART_RELATED</constant>: 'multipart/related'
+                    </para>
+                </listitem>
+            </itemizedlist>
             </para>
     </sect2>