[DOCUMENT] sync 22756, 23527, 23610, 23643, 23663

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

documentation/manual/ja/module_specs/Zend_Controller-Router-Route-Hostname.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17592 -->
+<!-- EN-Revision: 23663 -->
 <sect3 id="zend.controller.router.routes.hostname">
     <title>Zend_Controller_Router_Route_Hostname</title>
 
@@ -29,7 +29,7 @@ $hostnameRoute = new Zend_Controller_Router_Route_Hostname(
 
 $plainPathRoute = new Zend_Controller_Router_Route_Static('');
 
-$router->addRoute('user', $hostnameRoute->chain($plainPathRoute);
+$router->addRoute('user', $hostnameRoute->chain($plainPathRoute));
 ]]></programlisting>
 
     <para>

documentation/manual/ja/module_specs/Zend_Mail_Read.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 23527 -->
 <sect1 id="zend.mail.read">
     <title>メールメッセージの読み込み</title>
 
@@ -331,7 +331,7 @@ echo '</pre>';
         <methodname>getPart()</methodname> メソッドで <classname>Zend_Mail_Part</classname> のインスタンスを取得します。
         <classname>Zend_Mail_Part</classname> は <classname>Zend_Mail_Message</classname> の基底クラスなので、
         <methodname>getHeader()</methodname> や <methodname>getHeaders()</methodname>、<methodname>getContent()</methodname>、
-        <methodname>getPart()</methodname>、<methodname>isMultipart</methodname> といったメソッドを同様に使えます。
+        <methodname>getPart()</methodname>、<methodname>isMultipart()</methodname> といったメソッドを同様に使えます。
         また、ヘッダもプロパティとして使用できます。</para>
 
         <programlisting language="php"><![CDATA[
@@ -345,7 +345,7 @@ echo "Content:\n";
 echo $part->getContent();
 ]]></programlisting>
 
-        <para><classname>Zend_Mail_Part</classname> は <code>RecursiveIterator</code> も実装しています。
+        <para><classname>Zend_Mail_Part</classname> は <classname>RecursiveIterator</classname> も実装しています。
         つまり、すべてのパートを順にスキャンすることも簡単にできます。また、
         結果を簡単に出力できるよう、マジックメソッド <methodname>__toString()</methodname>
         を実装しています。このメソッドは、パートの中身を返します。</para>
@@ -446,12 +446,12 @@ if (!$message->hasFlag('$SpamTested')) {
             フォルダをサポートするために実装しているインターフェイスが
             <classname>Zend_Mail_Storage_Folder_Interface</classname> です。
             これらすべてのクラスでは、コンストラクタで追加のオプションパラメータ
-            <code>folder</code> を指定できます。これは、ログイン後に使用するフォルダを指定するものです。
+            <property>folder</property> を指定できます。これは、ログイン後に使用するフォルダを指定するものです。
         </para>
         <para>
             ローカルの保存形式では、<classname>Zend_Mail_Storage_Folder_Mbox</classname>
             あるいは <classname>Zend_Mail_Storage_Folder_Maildir</classname>
-            のいずれかのクラスを使用します。どちらもパラメータ <code>dirname</code>
+            のいずれかのクラスを使用します。どちらもパラメータ <property>dirname</property>
             が必須で、これは基底ディレクトリの名前となります。
             maildir のフォーマットは maildir++ で定義されているもの
             (デフォルトの区切り文字はドットです)、一方 Mbox
@@ -495,7 +495,7 @@ $mail = new Zend_Mail_Storage_Imap(array('host'     => 'example.com',
             getFolders($root = null) メソッドを使用すると、
             ルートフォルダあるいは指定したフォルダから始まるフォルダ階層を取得できます。
             返り値は <classname>Zend_Mail_Storage_Folder</classname> のインスタンスとなります。これは
-            <code>RecursiveIterator</code> を実装しており、子要素もすべて
+            <classname>RecursiveIterator</classname> を実装しており、子要素もすべて
             <classname>Zend_Mail_Storage_Folder</classname> のインスタンスとなります。
             これらの各インスタンスはローカル名およびグローバル名を持っており、
             それぞれ <methodname>getLocalName()</methodname> メソッドおよび

documentation/manual/ja/module_specs/Zend_View-Helpers-Doctype.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21825 -->
+<!-- EN-Revision: 23610 -->
 <sect3 id="zend.view.helpers.initial.doctype">
     <title>Doctype ヘルパー</title>
 
@@ -23,6 +23,7 @@
         <listitem><para><constant>XHTML1_STRICT</constant></para></listitem>
         <listitem><para><constant>XHTML1_TRANSITIONAL</constant></para></listitem>
         <listitem><para><constant>XHTML1_FRAMESET</constant></para></listitem>
+        <listitem><para><constant>XHTML1_RDFA</constant></para></listitem>
         <listitem><para><constant>XHTML_BASIC1</constant></para></listitem>
         <listitem><para><constant>HTML4_STRICT</constant></para></listitem>
         <listitem><para><constant>HTML4_LOOSE</constant></para></listitem>
@@ -72,7 +73,6 @@ $doctypeHelper->doctype('XHTML1_STRICT');
             doctype を知りたくなったら、オブジェクトの
             <methodname>getDoctype()</methodname> をコールします。
             このオブジェクトは、ヘルパーを起動した際に取得できるものです。
-            invoking the helper.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -91,17 +91,73 @@ if ($view->doctype()->isXhtml()) {
 }
 ]]></programlisting>
 
-        <!-- TODO : to be translated -->
         <para>
-            You can also check if the doctype represents an <acronym>HTML5</acronym> document
+            doctype が <acronym>HTML5</acronym> 文書を表すかどうかチェックすることもできます。
         </para>
 
         <programlisting language="php"><![CDATA[
 if ($view->doctype()->isHtml5()) {
-    // do something differently
+    // 何かをします
 }
 ]]></programlisting>
     </example>
+
+    <example id="zend.view.helpers.initial.doctype.xhtml1_rdfa">
+        <title>Open Graph プロトコルで使用する Doctype を選択</title>
+
+        <para>
+            <ulink url="http://opengraphprotocol.org/">Open Graph プロトコル</ulink>を実装するには、
+            XHTML1_RDFA doctype を指定するでしょう。この doctype により、開発者は
+            <acronym>XHTML</acronym> 文書内で<ulink
+                url="http://www.w3.org/TR/xhtml-rdfa-primer/">Resource Description Framework</ulink>
+            を使用できるようになります。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$doctypeHelper = new Zend_View_Helper_Doctype();
+$doctypeHelper->doctype('XHTML1_RDFA');
+]]></programlisting>
+
+        <para>
+        'property' メタタグ属性が Open Graph プロトコル仕様の通りに使用されると、
+        RDFa doctype により、XHTMLでの検証が可能になります。
+        ビュースクリプト内部の例です。
+        </para>
+
+        <programlisting language="html"><![CDATA[
+<?php echo $this->doctype('XHTML1_RDFA'); ?>
+<html xmlns="http://www.w3.org/1999/xhtml"
+      xmlns:og="http://opengraphprotocol.org/schema/">
+<head>
+   <meta property="og:type" content="musician" />
+]]></programlisting>
+
+        <para>
+            前記の例では、property に og:type を設定しました。
+            og は、HTMLタグで指定した Open Graph 名前空間を参照します。
+            content は、そのページが musician （音楽家）についてのものであることを特定します。
+            サポートされるプロパティについては、<ulink
+                url="http://opengraphprotocol.org/">Open Graph プロトコル・ドキュメント</ulink>
+            をご覧下さい。<link
+                linkend="zend.view.helpers.initial.headmeta">HeadMeta ヘルパー</link>は、
+            それらの Open Graph プロトコルのメタタグをプログラム的に設定するために使用されるかもしれません。
+        </para>
+
+        <para>
+            これは、もし XHTML1_RDFA に設定された場合にチェックする方法です。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+<?php echo $this->doctype() ?>
+<html xmlns="http://www.w3.org/1999/xhtml" 
+      <?php if ($view->doctype()->isRdfa()): ?>
+      xmlns:og="http://opengraphprotocol.org/schema/"
+      xmlns:fb="http://www.facebook.com/2008/fbml"
+      <?php endif; ?>
+>
+]]></programlisting>
+        
+    </example>
 </sect3>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/ja/module_specs/Zend_View-Helpers-HeadMeta.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21825 -->
+<!-- EN-Revision: 23610 -->
 <sect3 id="zend.view.helpers.initial.headmeta">
     <title>HeadMeta ヘルパー</title>
 
@@ -68,6 +68,38 @@
         </listitem>
     </itemizedlist>
 
+     <para>
+        XHTML1_RDFA doctype では、<link
+            linkend="zend.view.helpers.initial.doctype">Doctype ヘルパー</link>
+        で設定される以下のメソッドもサポートされます。
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                <command>appendProperty($property, $content, $modifiers)</command>
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <command>offsetSetProperty($index, $property, $content, $modifiers)</command>
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <command>prependProperty($property, $content, $modifiers)</command>
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                <command>setProperty($property, $content, $modifiers)</command>
+            </para>
+        </listitem>
+    </itemizedlist>
+
     <para>
         <varname>$keyValue</varname> は 'name' あるいは 'http-equiv'
         キーの値を定義します。<varname>$content</varname> は
@@ -84,6 +116,8 @@
         です。<varname>$keyValue</varname> には、
         <varname>$keyType</varname> ('name' あるいは 'http-equiv')
         で指定したキーのコンテンツを指定します。
+        もし doctype が XHTML1_RDFA に設定されていたら、<varname>$keyType</varname>
+        は 'property' としても指定されるかもしれません。
         <varname>$placement</varname> は 'SET' (既存の値をすべて上書きする)
         か 'APPEND' (スタックの最後に追加する)、
         あるいは 'PREPEND' (スタックの先頭に追加する) となります。
@@ -150,10 +184,9 @@ $this->headMeta()->appendHttpEquiv('Content-Type',
                  ->appendHttpEquiv('Content-Language', 'en-US');
 ]]></programlisting>
 
-        <!-- TODO : to be translated -->
          <para>
-            If you are serving an <acronym>HTML</acronym>5 document, you should provide the character
-            set like this:
+            もし <acronym>HTML</acronym>5 文書を提供しているなら、
+            このように文字セットを提示すべきです。:
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -180,6 +213,34 @@ $this->headMeta()->appendHttpEquiv('Refresh',
 <?php echo $this->headMeta() ?>
 ]]></programlisting>
     </example>
+
+    <example id="zend.view.helpers.initial.headmeta.property">
+        <title>XHTML1_RDFA doctype を用いた HeadMeta 使用法</title>
+
+        <para>
+            <link linkend="zend.view.helpers.initial.doctype">Doctype ヘルパー</link>
+            で RDFa doctype を有功にすると、標準的な 'name' や 'http-equiv' に加えて、
+            HeadMeta で 'property' 属性が使えるようになります。
+            これは Facebook の <ulink url="http://opengraphprotocol.org/">Open Graph プロトコル</ulink>
+            で一般的に用いられます。
+        </para>
+
+        <para>
+            例えば、Open Graph ページのタイトルと型を以下のように指定するかもしれません。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$this->doctype(Zend_View_Helper_Doctype::XHTML_RDFA);
+$this->headMeta()->setProperty('og:title', 'my article title');
+$this->headMeta()->setProperty('og:type', 'article');
+echo $this->headMeta();
+
+//出力です。
+//   <meta property="og:title" content="my article title" />
+//   <meta property="og:type" content="article" />
+]]></programlisting>
+
+    </example>
 </sect3>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/ja/ref/performance-database.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20876 -->
+<!-- EN-Revision: 23643 -->
 <sect1 id="performance.database">
     <title>Zend_Dbパフォーマンス</title>
 
@@ -91,8 +91,8 @@
             <para>
                 もし<acronym>SQL</acronym>が変数の引数を必要とする場合、
                 <acronym>SQL</acronym>にプレースホルダーを用意してください。
-                そして、<acronym>SQL</acronym>に値を挿入するために <methodname>vsprintf</methodname>
-                と <methodname>array_walk</methodname> の組み合わせを利用してください。
+                そして、<acronym>SQL</acronym>に値を挿入するために <methodname>vsprintf()</methodname>
+                と <methodname>array_map()</methodname> の組み合わせを利用してください。
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -100,7 +100,7 @@
 // $this->getAdapter() を使ってそれを参照します
 $sql = vsprintf(
     self::SELECT_FOO,
-    array_walk($values, array($adapter, 'quoteInto'))
+    array_map(array($adapter, 'quoteInto'), $values)
 );
 ]]></programlisting>
         </sect3>