[DOCUMENTATION] Japanese sync

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

documentation/manual/ja/module_specs/Zend_Filter-FilterChains.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15854 -->
+<!-- EN-Revision: 20309 -->
 <sect1 id="zend.filter.filter_chains">
 
     <title>フィルタチェイン</title>
@@ -13,7 +13,7 @@
         以下のコードで、二つのフィルタをユーザ名に対して適用する方法を説明します。
 
         <programlisting language="php"><![CDATA[
-<// フィルタチェインを作成し、そこにフィルタを追加します
+// フィルタチェインを作成し、そこにフィルタを追加します
 $filterChain = new Zend_Filter();
 $filterChain->addFilter(new Zend_Filter_Alpha())
             ->addFilter(new Zend_Filter_StringToLower());
@@ -33,6 +33,31 @@ $username = $filterChain->filter($_POST['username']);
         フィルタチェインに追加できます。
     </para>
 
+    <!-- TODO : to be translated -->
+    <sect2 id="zend.filter.filter_chains.order">
+        <title>Changing filter chain order</title>
+        
+        <para>
+            Since 1.10, the <classname>Zend_Filter</classname> chain also
+            supports altering the chain by prepending or appending filters. For
+            example, the next piece of code does exactly the same as the other
+            username filter chain example:
+        </para>
+        
+        <programlisting language="php"><![CDATA[
+// Create a filter chain and add filters to the chain
+$filterChain = new Zend_Filter();
+
+// this filter will be appended to the filter chain
+$filterChain->appendFilter(new Zend_Filter_StringToLower());
+
+// this filter will be prepended at the beginning of the filter chain.
+$filterChain->prependFilter(new Zend_Filter_Alpha());
+
+// Filter the username
+$username = $filterChain->filter($_POST['username']);
+]]></programlisting>
+    </sect2>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/ja/module_specs/Zend_Mail-MultipleEmails.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19426 -->
+<!-- EN-Revision: 20039 -->
 <sect1 id="zend.mail.multiple-emails">
     <title>SMTP 接続による複数のメールの送信</title>
 
@@ -12,6 +12,18 @@
         メッセージの配送の前に RSET コマンドを発行します。
     </para>
 
+    <!-- TODO : to be translated -->
+    <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>SMTP 接続による複数のメールの送信</title>
@@ -21,17 +33,24 @@
 $config = array('name' => 'sender.example.com');
 $transport = new Zend_Mail_Transport_Smtp('mail.example.com', $config);
 
+// 送信するメール全てで使う From 及び Reply-To のアドレス及び名前を設定します
+Zend_Mail::setDefaultFrom('sender@example.com', 'John Doe');
+Zend_Mail::setDefaultReplyTo('replyto@example.com','Jane Doe');
+
 // メッセージをループ処理します
 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(
         'Demonstration - Sending Multiple Mails per SMTP Connection'
     );
     $mail->setBodyText('...Your message here...');
     $mail->send($transport);
 }
+
+// 既定値をリセットします
+Zend_Mail::clearDefaultFrom();
+Zend_Mail::clearDefaultReplyTo();
 ]]></programlisting>
 
     </example>
@@ -61,8 +80,8 @@ $transport->setConnection($protocol);
 // メッセージをループ処理します
 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(
         'Demonstration - Sending Multiple Mails per SMTP Connection'
     );

documentation/manual/ja/module_specs/Zend_Markup-Renderers.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19777 -->
+<!-- EN-Revision: 20289 -->
 <sect1 id="zend.markup.renderers">
     <title>Zend_Markup レンダラー</title>
  
@@ -31,23 +31,179 @@ $bbcode = Zend_Markup::factory('Bbcode');
 // 他のことを配列にて定義します。
 $bbcode->addTag(
     'foo',
-    Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE
-        | Zend_Markup_Renderer_RendererAbstract::TAG_NORMAL,
+    Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
     array(
         'start' => '-bar-',
         'end'   => '-baz-',
-        'group' => 'inline',
+        'group' => 'inline'
     )
 );
  
 // これは 'my -bar-tag-baz-' と出力されるでしょう。
 echo $bbcode->render('my [foo]tag[/foo]');
 ]]></programlisting>
- 
+
         <para>
             あなたの作成したタグは、あなたのパーサーがタグ構造もサポートするときに
             機能することに注意してください。現在、 BBCode はこれをサポートします。
             Textile はカスタムタグをサポートしません。
         </para>
+
+        <!-- TODO : to be translated -->
+        <para>
+            Some renderers (like the HTML renderer) also have support for a
+            'tag' parameter. This replaces the 'start' and 'end' parameters, and
+            it renders the tags including some default attributes and the
+            closing tag. 
+        </para>
+        
+        <sect3 id="zend.markup.renderers.add.callback">
+            <title>Add a callback tag</title>
+            
+            <para>
+                By adding a callback tag, you can do a lot more then just a
+                simple replace of the tags. For instance, you can change the
+                contents, use the parameters to influence the output etc.
+            </para>
+            
+            <para>
+                A callback is a class that implements the
+                <classname>Zend_Markup_Renderer_TokenInterface</classname>
+                interface. An example of a callback class:
+            </para>
+            
+            <programlisting language="php"><![CDATA[
+class My_Markup_Renderer_Html_Upper extends Zend_Markup_Renderer_TokenConverterInterface
+{
+
+    public function convert(Zend_Markup_Token $token, $text)
+    {
+        return '!up!' . strtoupper($text) . '!up!';
+    }
+
+}
+]]></programlisting>
+
+            <para>
+                Now you can add the 'upper' tag, with as callback, an instance
+                of the <classname>My_Markup_Renderer_Html_Upper</classname>
+                class. A simple example:
+            </para>
+            
+            <programlisting language="php"><![CDATA[
+// Creates instance of Zend_Markup_Renderer_Html,
+// with Zend_Markup_Parser_BbCode as its parser
+$bbcode = Zend_Markup::factory('Bbcode');
+
+// this will create a simple 'foo' tag
+// The first parameter defines the tag's name.
+// The second parameter takes an integer that defines the tags type.
+// The third parameter is an array that defines other things about a
+// tag, like the tag's group, and (in this case) a start and end tag.
+$bbcode->addTag(
+    'upper',
+    Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
+    array(
+        'callback' => new My_Markup_Renderer_Html_Upper(),
+        'group'    => 'inline'
+    )
+);
+
+// now, this will output: 'my !up!TAG!up!'
+echo $bbcode->render('my [upper]tag[/upper]');
+]]></programlisting>
+        </sect3>
+    </sect2>
+
+    <sect2 id="zend.markup.renderers.list">
+        <title>List of tags</title>
+
+        <table id="zend.markup.renderers.list.tags">
+            <title>List of tags</title>
+
+            <tgroup cols="2" align="left" colsep="1" rowsep="1">
+                <thead>
+                    <row>
+                        <entry>Sample input (bbcode)</entry>
+
+                        <entry>Sample output</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry>[b]foo[/b]</entry>
+
+                        <entry><![CDATA[<strong>foo</strong>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[i]foo[/i]</entry>
+
+                        <entry><![CDATA[<em>foo</em>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[cite]foo[/cite]</entry>
+
+                        <entry><![CDATA[<cite>foo</cite>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[del]foo[/del]</entry>
+
+                        <entry><![CDATA[<del>foo</del>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[ins]foo[/ins]</entry>
+
+                        <entry><![CDATA[<ins>foo</ins>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[sup]foo[/sup]</entry>
+
+                        <entry><![CDATA[<sup>foo</sup>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[sub]foo[/sub]</entry>
+
+                        <entry><![CDATA[<sub>foo</sub>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[span]foo[/span]</entry>
+
+                        <entry><![CDATA[<span>foo</span>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[acronym title="PHP Hypertext Preprocessor]PHP[/acronym]</entry>
+
+                        <entry><![CDATA[<acronym title="PHP Hypertext Preprocessor">PHP</acronym>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[url=http://framework.zend.com/]Zend Framework[/url]</entry>
+
+                        <entry><![CDATA[<a href="http://framework.zend.com/">Zend Framework</a>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[h1]foobar[/h1]</entry>
+
+                        <entry><![CDATA[<h1>foobar</h1>]]></entry>
+                    </row>
+
+                    <row>
+                        <entry>[img]http://framework.zend.com/images/logo.gif[/img]</entry>
+
+                        <entry><![CDATA[<img src="http://framework.zend.com/images/logo.gif" />]]></entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
     </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Mime.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19440 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="zend.mime.mime">
     <title>Zend_Mime</title>
 
@@ -23,8 +23,8 @@
             <listitem>
                 <para>
                     <methodname>Zend_Mime::isPrintable()</methodname>:
-                    指定した文字列の中に表示できない文字がなければ TRUE、
-                    それ以外の場合に FALSE を返します。
+                    指定した文字列の中に表示できない文字がなければ <constant>TRUE</constant> 、
+                    それ以外の場合に <constant>FALSE</constant> を返します。
                 </para>
             </listitem>
             <listitem>

documentation/manual/ja/module_specs/Zend_Mime_Message.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="zend.mime.message">
     <title>Zend_Mime_Message</title>
 
@@ -10,7 +10,7 @@
       <para><classname>Zend_Mime_Message</classname> は <acronym>MIME</acronym> 準拠のメッセージを表すものであり、
       ひとつあるいは複数の部分に分かれたメッセージ (<link
       linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> オブジェクトで表されます)
-      を保持することができます。<classname>Zend_Mime_Message</classname> では、<classname>Zend_Mime_Part</classname> を使用して
+      を保持できます。<classname>Zend_Mime_Message</classname> では、<classname>Zend_Mime_Part</classname> を使用して
       <acronym>MIME</acronym> 準拠のマルチパートメッセージを作成します。
       エンコーディングやバウンダリの処理も透過的に行われます。
       与えられた文字列から <classname>Zend_Mime_Message</classname> オブジェクトを再構成することも可能です
@@ -41,9 +41,11 @@
         <code>-&gt;setParts($partsArray)</code> をコールして配列を
         <link linkend="zend.mime.part"><classname>Zend_Mime_Part</classname></link> オブジェクトに書き戻さなければなりません。</para>
 
-        <para>関数 <code>-&gt;isMultiPart()</code> は、<classname>Zend_Mime_Message</classname>
-        オブジェクトに複数のパートが登録されている場合に true を返します。
-        この場合、実際の出力はマルチパート Mime メッセージとなります。</para>
+        <para>
+            関数 <code>-&gt;isMultiPart()</code> は、<classname>Zend_Mime_Message</classname>
+            オブジェクトに複数のパートが登録されている場合に <constant>TRUE</constant> を返します。
+            この場合、実際の出力はマルチパート Mime メッセージとなります。
+        </para>
         </sect2>
 
     <sect2 id="zend.mime.message.bondary">
@@ -74,7 +76,7 @@
         オブジェクトの作成 (実験段階)</title>
 
         <para><acronym>MIME</acronym> に準拠したメッセージを含む文字列をもとにして、
-        <classname>Zend_Mime_Message</classname> オブジェクトを構築することができます。
+        <classname>Zend_Mime_Message</classname> オブジェクトを構築できます。
         <classname>Zend_Mime_Message</classname> には、このような文字列をパースして
         <classname>Zend_Mime_Message</classname> オブジェクトを返す
         静的なファクトリメソッドが用意されています。</para>
@@ -82,7 +84,7 @@
         <para><methodname>Zend_Mime_Message::createFromMessage($str, $boundary)</methodname>
         は、渡された文字列をデコードして <classname>Zend_Mime_Message</classname>
         オブジェクトを返します。<code>-&gt;getParts()</code>
-        を使用すると、その中身を確認することができます。</para>
+        を使用すると、その中身を確認できます。</para>
     </sect2>
 </sect1>
 <!--

documentation/manual/ja/module_specs/Zend_Navigation-Pages-URI.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17356 -->
+<!-- EN-Revision: 20115 -->
 <sect2 id="zend.navigation.pages.uri">
     <title>Zend_Navigation_Page_Uri</title>
 
@@ -43,7 +43,7 @@
                     <entry><type>String</type></entry>
                     <entry><constant>NULL</constant></entry>
                     <entry>
-                        画面への<acronym>URI</acronym>。さまざまな文字列またはnullになりうる。
+                        画面への<acronym>URI</acronym>。さまざまな文字列または <constant>NULL</constant> になりうる。
                     </entry>
                 </row>
             </tbody>

documentation/manual/ja/module_specs/Zend_Paginator-Usage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19418 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="zend.paginator.usage">
     <title>使用法</title>
 
@@ -100,7 +100,7 @@ $paginator = Zend_Paginator::factory($array);
 
         <note>
             <para>
-                Null アダプタの場合は、
+                <classname>Null</classname> アダプタの場合は、
                 データコレクションのかわりに要素数をコンストラクタで指定します。
             </para>
         </note>

documentation/manual/ja/module_specs/Zend_Registry.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="zend.registry.using">
 
     <title>レジストリの使用法</title>
@@ -36,7 +36,7 @@ Zend_Registry::set('index', $value);
         </example>
 
         <para>
-            値としては、オブジェクトや配列、スカラーを指定することができます。
+            値としては、オブジェクトや配列、スカラーを指定できます。
             レジストリの特定のエントリに保存されている値を変更するには、
             <methodname>set()</methodname> を使用して新しい値を指定します。
         </para>

documentation/manual/ja/module_specs/Zend_Validate-Hostname.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19568 -->
+<!-- EN-Revision: 20115 -->
 <sect2 id="zend.validate.set.hostname">
 
     <title>ホスト名</title>
@@ -115,7 +115,7 @@ $validator =
     );
 ]]></programlisting>
 
-        あるいは、TRUE または FALSE を
+        あるいは、 <constant>TRUE</constant> または <constant>FALSE</constant> を
         <methodname>setValidateIdn()</methodname> に渡すことで、
         IDN の検証を有効あるいは無効にすることもできます。
 
@@ -150,7 +150,7 @@ $validator =
     );
 ]]></programlisting>
 
-        あるいは、TRUE または FALSE を
+        あるいは、 <constant>TRUE</constant> または <constant>FALSE</constant> を
         <methodname>setValidateIdn()</methodname> に渡すことで、
         TLD の検証を有効あるいは無効にすることもできます。
     </para>

documentation/manual/ja/module_specs/Zend_Validate.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19577 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="zend.validate.introduction">
 
     <title>導入</title>
@@ -298,8 +298,8 @@ iif (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                 <listitem>
                     <para>
                         <emphasis><methodname>Zend_Validate::hasDefaultNamespaces()</methodname></emphasis>:
-                        デフォルトの名前空間が設定されている場合は true、
-                        設定されていない場合は false を返します。
+                        デフォルトの名前空間が設定されている場合は <constant>TRUE</constant> 、
+                        設定されていない場合は <constant>FALSE</constant> を返します。
                     </para>
                 </listitem>
             </itemizedlist>

documentation/manual/ja/ref/language-snippets.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19995 -->
+<!-- EN-Revision: 20313 -->
 <!-- links -->
 <!ENTITY lang                                   'ja'>
-<!ENTITY zf.manual.link                         'http://framework.zend.com/manual/ja/'>
-<!ENTITY php.manual.link                        'http://www.php.net/manual/ja/'>
+<!ENTITY zf.manual.link                         'http://framework.zend.com/manual/ja'>
+<!ENTITY php.manual.link                        'http://www.php.net/manual/ja'>
 
 <!-- manual.xml.in -->
 <!ENTITY book.title                             'プログラマ向けリファレンスガイド'>
@@ -31,3 +31,24 @@
 <!ENTITY appendix.migration.title               'Zend Framework 移行上の注意'>
 
 <!ENTITY appendix.performance.title             'Zend Framework パフォーマンスガイド'>
+
+<!-- requirements table -->
+<!ENTITY requirements.extensions.table.title    'Zend Framework で各コンポーネントが使用する PHP 拡張'>
+<!ENTITY requirements.zendcomponents.table.title 'Zend Framework のコンポーネントと、使用している PHP 拡張'>
+<!ENTITY requirements.dependencies.table.title  'Zend Framework のコンポーネントと、それが依存する他のZend Framework コンポーネント'>
+
+<!ENTITY requirements.php.extensions            '<acronym>PHP</acronym> 拡張'>
+<!ENTITY requirements.dependency.type           '依存形式'>
+<!ENTITY requirements.used.by.zf.components     '使用する Zend Framework コンポーネント'>
+<!ENTITY requirements.zf.component              'Zend Framework コンポーネント'>
+<!ENTITY requirements.dependent.zf.components   '依存する Zend Framework コンポーネント'>
+
+<!ENTITY requirements.hard                      'ハード'>
+<!ENTITY requirements.soft                      'ソフト'>
+<!ENTITY requirements.fix                       '固定'>
+<!ENTITY requirements.sub                       'Sub'>
+
+<!ENTITY requirements.all.components            'コンポーネント全て'>
+<!ENTITY requirements.virtually.all.components  '事実上全てのコンポーネント'>
+<!ENTITY requirements.all.pdo.adapters          '<acronym>PDO</acronym> データベースアダプタ全て'>
+