[DOCUMENTATION]Japanese sync 18817, 18892, and fix TODOs

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

documentation/manual/ja/module_specs/Zend_Config_Writer.xml

@@ -37,11 +37,11 @@
     </itemizedlist>
 
      <para>
-        <!-- TODO : to be translated -->
-        The Ini writer has two modes for rendering with regard to sections.
-        By default the top-level configuration is always written into section names.
-        By calling <code>$writer->setRenderWithoutSections()</code> all options are written
-        into the global namespace of the INI file and no sections are applied.
+        Ini ライターでは、セクションについてのレンダリング用のモードが２つあります。
+        既定では、トップレベルの構成節は、常にセクション名に含まれます。
+        <code>$writer->setRenderWithoutSections()</code> を呼ぶことにより、
+        オプションの全てが INI ファイルのグローバル名前空間に含まれます。
+        そして、セクションは使用されません。
     </para>
 
     <para>
@@ -140,11 +140,11 @@ $writer->write();
     </note>
 
     <para>
-        <!-- TODO : to be translated -->
-        For all the File-Based writers (INI, XML and PHP Array) internally
-        the <methodname>render()</methodname> is used to build the configuration
-        string. This method can be used from the outside also if you need
-        to access the string-representation of the configuration data.
+        構成節の文字列を作成するために、
+        ファイル・ベースのライタ（INI、XMLとPHP配列）全てで内部的に
+        <methodname>render()</methodname> が使用されます。
+        コンフィギュレーション・データの文字列表現にアクセスする必要があれば、
+        このメソッドを外部からも使用できます。
     </para>
 
 </sect1>

documentation/manual/ja/module_specs/Zend_View-Introduction.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17486 -->
+<!-- EN-Revision: 18892 -->
 <sect1 id="zend.view.introduction">
 
     <title>導入</title>
@@ -182,32 +182,30 @@ base/path/
         <title>ビュースクリプトでの短いタグ</title>
 
         <para>
-            我々が用意する例やドキュメントでは、<acronym>PHP</acronym> の短いタグ
-            <code>&lt;?</code> と <code>&lt;?=</code> を用いています。
-            さらに、<ulink
+            我々が用意する例では、<acronym>PHP</acronym> の長いタグ
+            <code>&lt;?php</code> を用います。
+            我々はまた、<ulink
                 url="http://www.php.net/manual/ja/control-structures.alternative-syntax.php">
-                制御構造に関する別の構文</ulink>
-            も使用しています。
+                制御構造に関する別の構文</ulink>の使用に賛成します。
             これらはビュースクリプトを書く際に便利なものです。
-            より簡潔に書くことができ、文を 1 行にまとめられるからです。
+            より簡潔に書くことができ、文を１行にまとめられ、
+            HTML 内で括弧を捜す必要を削減するからです。
         </para>
 
         <para>
-            多くの開発者は、可搬性などを考慮して完全なタグの使用を好むと言われています。
-            実際、php.ini.recommended ファイルでは
-            <code>short_open_tag</code> が無効になっていますし、
-            ビュースクリプト内で <acronym>XML</acronym> のテンプレートを使用する場合など、
+            以前の版では、ビュー・スクリプトをわずかにより冗長にしないように、
+            我々はしばしば短いタグ (<code>&lt;?</code> 及び <code>&lt;?=</code>)を使うことを推奨しました。
+            しかしながら、 <filename>php.ini</filename> の <constant>short_open_tag</constant>
+            設定のデフォルト値は製品において、または共有ホストでは一般的にオフです。
+            その結果、それらの使用は全く移植可能ではありません。
+            もしビュースクリプト内で <acronym>XML</acronym> のテンプレート、
             短い形式の開始タグは検証エラーの元となります。
+            結局、 <constant>short_open_tag</constant> がオフの時に短いタグを使うと、
+            ビュー・スクリプトはエラーを起こすか、または単純にビューアーに PHP コードを返します。
         </para>
 
         <para>
-            さらに、もし短いタグが使用できない設定のときに短いタグを使用してしまうと、
-            ビュースクリプトでエラーが発生したり
-            コードの内容がユーザに丸見えになってしまったりします。
-        </para>
-
-        <para>
-            後者の場合のように「短いタグを使いたいけれど設定でそれが無効になっている」
+            もしもこれらの警告にもかかわらず、「短いタグを使いたいけれど設定でそれが無効になっている」
             場合は、次のいずれかの方法を使用します。
         </para>
 
@@ -246,7 +244,7 @@ $view->setUseStreamWrapper(true);
             </listitem>
         </itemizedlist>
 
-        <note>
+        <warning>
             <title>ビューストリームラッパーによるパフォーマンスの低下</title>
 
             <para>
@@ -258,7 +256,7 @@ $view->setUseStreamWrapper(true);
                 スクリプトを書き換えてすべて完全なタグにしてしまう、
                 あるいはコンテンツのキャッシュをうまく行うなどの対策を推奨します。
             </para>
-        </note>
+        </warning>
     </sect2>
 
     <sect2 id="zend.view.introduction.accessors">

documentation/manual/ja/module_specs/Zend_Wildfire.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17062 -->
+<!-- EN-Revision: 18817 -->
 <sect1 id="zend.wildfire.chapter">
 
   <title>Zend_Wildfire</title>
@@ -15,20 +15,19 @@
     動的でスクリプタブルなプラグイン機構の間の通信を標準化することです。
     現時点でもっとも力を注いでいるのは、サーバサイドの <acronym>PHP</acronym>
     コードのログメッセージを
-    <ulink url="http://www.getfirebug.com/">Firebug</ulink>
-    <ulink url="http://getfirebug.com/logging.html">コンソール</ulink>
+    <ulink url="http://www.getfirebug.com/">Firebug コンソール</ulink>
     に送る仕組みを提供することです。
   </para>
   <para>
-    Firebug へのログ出力のために
+    
     <link linkend="zend.log.writers.firebug"><classname>Zend_Log_Writer_Firebug</classname></link>
-    コンポーネントを提供しています。通信プロトコルは
+    コンポーネントは、 Firebug へのログ出力のために提供されます。通信プロトコルは
     <acronym>HTTP</acronym> リクエストヘッダとレスポンスヘッダを使用し、
-    これによってサーバとクライアントコンポーネントの間の通信を行っています。
+    これによってサーバとクライアントコンポーネントの間の通信を行います。
     ページのコンテンツに何も手を加えなくても、
-    スクリプト実行時に生成したさまざまなデータをブラウザ側で記録できるのです。
-    この方式なら、<acronym>AJAX</acronym> リクエストのようにクリーンな <acronym>JSON</acronym>
-    および <acronym>XML</acronym> レスポンスを要求するリクエストのデバッグも行えます。
+    スクリプト実行時に生成されたブラウザにさまざまなデータを記録できるのです。
+    この方式なら、クリーンな <acronym>JSON</acronym> および <acronym>XML</acronym> レスポンスを要求する
+    <acronym>AJAX</acronym> リクエストのデバッグも行えます。
   </para>
   <para>
     <link linkend="zend.db.profiler.profilers.firebug"><classname>Zend_Db_Profiler_Firebug</classname></link>

documentation/manual/ja/ref/migration-19.xml

@@ -228,23 +228,23 @@ $client->setFileUpload('file2.txt',
         <title>Zend_View_Helper_Navigation</title>
 
         <para>
-            <!-- TODO : to be translated -->
-            Prior to the 1.9 release, the menu helper
-            (<classname>Zend_View_Helper_Navigation_Menu</classname>) did not
-            render sub menus correctly. When the <code>onlyActiveBranch</code>
-            was <constant>TRUE</constant> and the option <code>renderParents</code>
-            <constant>FALSE</constant>, nothing would be rendered if the deepest active
-            page was at a depth lower than the <code>minDepth</code> option.
+            1.9のリリースより前は、
+            メニュー・ヘルパー (<classname>Zend_View_Helper_Navigation_Menu</classname>) は、
+            サブメニューを正しく生成しませんでした。
+            <code>onlyActiveBranch</code> が <constant>TRUE</constant> で、
+            オプションの <code>renderParents</code> が <constant>FALSE</constant> のとき、
+            もし、最も深いアクティブなページが <code>minDepth</code> オプションより低い階層にあると、
+            何もレンダリングされないでしょう。
         </para>
 
         <para>
-            In simpler words; if <code>minDepth</code> was set to <code>1</code>
-            and the active page was at one of the first level pages, nothing
-            would be rendered, as the following example shows.
+            より簡単に言うと、もし <code>minDepth</code> が <code>1</code> に設定され、
+            アクティブなページが最初のレベルのページの一つなら、
+            以下の例が示すように、何もレンダリングされないでしょう。
         </para>
 
         <para>
-            Consider the following container setup:
+            下記のコンテナのセットアップを考えて見ましょう。
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -277,7 +277,7 @@ $container = new Zend_Navigation(array(
 ]]></programlisting>
 
         <para>
-            The following code is used in a view script:
+            下記のコードがビュースクリプトで使用されます。
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -289,18 +289,17 @@ $container = new Zend_Navigation(array(
 ]]></programlisting>
 
         <para>
-            Before release 1.9, the code snippet above would output nothing.
+            リリース1.9より前は、上記のコードスニペットは、何も出力しません。
         </para>
 
         <para>
-            Since release 1.9, the <methodname>_renderDeepestMenu()</methodname> method in
-            <classname>Zend_View_Helper_Navigation_Menu</classname> will accept
-            active pages at one level below <code>minDepth</code>, as long as
-            the page has children.
+            リリース1.9以降では、ページの子供がある限り、
+            <classname>Zend_View_Helper_Navigation_Menu</classname> の <methodname>_renderDeepestMenu()</methodname>
+            メソッドは <code>minDepth</code> の１階層下のアクティブページを受け取ります。
         </para>
 
         <para>
-            The same code snippet will now output the following:
+            今では、同じコードスニペットで下記を出力します。
         </para>
 
         <programlisting language="html"><![CDATA[

documentation/manual/ja/ref/project-structure.xml

@@ -128,7 +128,8 @@
                             アクション・ヘルパーは、デフォルト・モジュールのための
                             "<classname>Controller_Helper_</classname>"、
                             または他のモジュールの "&lt;Module&gt;_Controller_Helper" として
-                            namespace されます。
+                            <!-- TODO -->namespace
+                            されます。
                         </para>
                     </listitem>
 
@@ -202,17 +203,14 @@
             <listitem>
                 <para>
                     <emphasis><filename>library/</filename></emphasis>:
-                    <!-- TODO: to be  translated -->
-                     This directory is for
-                    common libraries on which the application depends, and should be on the
-                    <acronym>PHP</acronym> <property>include_path</property>. Developers should
-                    place their application's library code under this directory in a unique
-                    namespace, following the guidelines established in the <acronym>PHP</acronym>
-                    manual's <ulink
-                        url="http://www.php.net/manual/ja/userlandnaming.php">ユーザレベルでの命名の
-                        手引き</ulink>, as well as those established by Zend itself. This
-                    directory may also include Zend Framework itself; if so, you would house it in
-                    <filename>library/Zend/</filename>.
+                    このディレクトリは、アプリケーションが依存する共通ライブラリのため、
+                    <acronym>PHP</acronym> <property>include_path</property> 上になければなりません。
+                    開発者は、 <acronym>PHP</acronym> のマニュアル（ゼンド自体によって確立されるそれらだけでなく）の
+                     <ulink url="http://www.php.net/manual/ja/userlandnaming.php">ユーザレベルでの命名の
+                        手引き</ulink> に沿って、一意の名前空間内のこのディレクトリ配下に
+                    それらのアプリケーション・ライブラリーのコードを置かなければなりません。
+                    このディレクトリは、 Zend Framework 自体も含むかもしれません。
+                    もしそうなら、それを <filename>library/Zend/</filename> にしまうでしょう。
                 </para>
             </listitem>
 
@@ -220,12 +218,10 @@
                 <para>
                     <emphasis><filename>public/</filename></emphasis>:
                     このディレクトリは、アプリケーションのためにすべての公開ファイルを含みます。
-                    <!-- TODO: to be translated -->
-                     <filename>index.php</filename> sets up and
-                    invokes <classname>Zend_Application</classname>, which in turn invokes the
-                    <filename>application/Bootstrap.php</filename> file, resulting in dispatching
-                    the front controller. The web root of your web server would typically be set to
-                    this directory.
+                    <filename>index.php</filename> は <classname>Zend_Application</classname> をセットアップして、実行します。
+                    そして、それは順番に <filename>application/Bootstrap.php</filename> ファイルを実行します。
+                    結果としてフロント・コントローラをディスパッチすることになります。
+                    ウェブサーバのウェブ・ルートは、このディレクトリに一般的にセットされます。
                 </para>
             </listitem>
 
@@ -233,36 +229,37 @@
                 <para>
                     <emphasis><filename>scripts/</filename></emphasis>:
                     このディレクトリは、メンテナンスやビルド・スクリプトを含みます。
-                    <!-- TODO: to be translated -->
-                     Such scripts might include command line,
-                    cron, or phing build scripts that are not executed at runtime but are part of
-                    the correct functioning of the application.
+                    このようなスクリプトは、コマンド・ライン、クロン、
+                    または実行時には実行されず、アプリケーションの
+                    <!-- TODO -->correct
+                    機能の一部である
+                    <!-- TODO -->phing
+                    ビルドされたスクリプトを含むかもしれません。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
                     <emphasis><filename>temp/</filename></emphasis>:
-                     The <filename>temp/</filename>
-                    folder is set aside for transient application data. This information would not
-                    typically be committed to the applications svn repository. If data under the
-                    <filename>temp/</filename> directory were deleted, the application should be
-                    able to continue running with a possible decrease in performance until data is
-                    once again restored or recached.
+                    <filename>temp/</filename> フォルダは、一時的なアプリケーションデータのためにとっておかれます。
+                    この情報は一般的に、アプリケーション svn リポジトリには入れられません。
+                    <filename>temp/</filename> ディレクトリ配下のデータが削除されると、
+                    データがもう一度リストアされるか、再キャッシュされるまで、
+                    アプリケーションは、パフォーマンスが低下した状態で動作し続ける可能性があります。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
                     <emphasis><filename>tests/</filename></emphasis>:
-                     This directory contains
-                    application tests. These could be hand-written, PHPUnit tests, Selenium-RC
-                    based tests or based on some other testing framework. By default, library code
-                    can be tested by mimicing the directory structure of your
-                    <filename>library/</filename> directory. Additionally, functional tests for
-                    your application could be written mimicing the
-                    <filename>application/</filename> directory structure (including the
-                    application subdirectory).
+                    このディレクトリは、アプリケーションのテストを含みます。
+                    これらは手書きや、PHPUnit テスト、Selenium-RC ベースのテスト、
+                    またはその他の何かのテスト・フレームワークに基づきます。
+                    既定では、ライブラリーのコードは <filename>library/</filename>
+                    ディレクトリのディレクトリ構造をまねることによりテストできます。
+                    さらに、アプリケーションのための機能テストは、
+                    <filename>application/</filename> ディレクトリの構造
+                    （アプリケーション・サブディレクトリを含む）をまねて書けました。
                 </para>
             </listitem>
         </itemizedlist>
@@ -272,8 +269,8 @@
         <title>モジュール構造</title>
 
         <para>
-            The directory structure for modules should mimic that of the
-            <filename>application/</filename> directory in the recommended project structure:
+            モジュールのためのディレクトリ構造は、推奨されたプロジェクト構造の中の
+            <filename>application/</filename> ディレクトリのそれを模倣しなければなりません。
         </para>
 
         <programlisting language="xml"><![CDATA[
@@ -297,8 +294,7 @@
 ]]></programlisting>
 
         <para>
-            The purpose of these directories remains exactly the same as for the recommended
-            project directory structure.
+            これらのディレクトリの目的は、推奨されたプロジェクト・ディレクトリ構造に関してと全く同じままです。
         </para>
     </sect1>
 
@@ -306,31 +302,31 @@
         <title>リライト設定ガイド</title>
 
         <para>
-            <acronym>URL</acronym> rewriting is a common function of <acronym>HTTP</acronym>
-            servers. However, the rules and configuration differ widely between them. Below are
-            some common approaches across a variety of popular web servers available at the time of
-            writing.
+            <acronym>URL</acronym> リライトは、 <acronym>HTTP</acronym> サーバの共通機能です。
+            しかしながら、ルールと構成は、それらの間ではなはだしく異なります。
+            下記は、書いた時点で利用できる、ポピュラーな様々なウェブサーバを通じた
+            多少の共通するアプローチです。
         </para>
 
         <sect2 id="project-structure.rewrite.apache">
             <title>Apache HTTPサーバ</title>
 
             <para>
-                All examples that follow use <property>mod_rewrite</property>, an official
-                module that comes bundled with Apache. To use it,
-                <property>mod_rewrite</property> must either be included at compile time or
-                enabled as a Dynamic Shared Object (<acronym>DSO</acronym>). Please consult the
-                <ulink url="http://httpd.apache.org/docs/">Apache documentation</ulink> for your
-                version for more information.
+                移行の例では全て、 <property>mod_rewrite</property> （ Apache にバンドルされた公式モジュール）
+                を使います。
+                それを使うために、 <property>mod_rewrite</property> はコンパイル時に含まれるか、
+                動的共用オブジェクト (<acronym>DSO</acronym>) として許可されなければなりません。
+                詳しくは、あなたのバージョンの <ulink
+                    url="http://httpd.apache.org/docs/">Apache ドキュメント</ulink>を参照してください。
             </para>
 
             <sect3 id="project-structure.rewrite.apache.vhost">
                 <title>バーチャルホスト内でのリライト</title>
 
                 <para>
-                    Here is a very basic virtual host definition. These rules direct all requests
-                    to <filename>index.php</filename>, except when a matching file is found under
-                    the <property>document_root</property>.
+                    これは非常に基本的なバーチャルホスト定義です。
+                    これらのルールは、一致するファイルが <property>document_root</property> 配下で見つかった時を除き、
+                    リクエスト全てを <filename>index.php</filename> に導きます。
                 </para>
 
                 <programlisting language="xml"><![CDATA[
@@ -352,8 +348,8 @@
 ]]></programlisting>
 
                 <para>
-                    Note the slash ("/") prefixing <filename>index.php</filename>; the rules for
-                    <filename>.htaccess</filename> differ in this regard.
+                    <filename>index.php</filename> の前におかれたスラッシュ ("/") に注意してください。
+                    <filename>.htaccess</filename> でのルールはこの点に関しては異なります。
                 </para>
             </sect3>
 
@@ -363,9 +359,9 @@
                 <para>
                     下記は<property>mod_rewrite</property>を利用する
                     <filename>.htaccess</filename>ファイルの例です。
-                    It is similar to the virtual host
-                    configuration, except that it specifies only the rewrite rules, and the leading
-                    slash is omitted from <filename>index.php</filename>.
+                    これは、リライト・ルールだけを定義し、
+                    <filename>index.php</filename> から先行するスラッシュが省略されたことを除けば、
+                    バーチャルホストの設定に似ています。
                 </para>
 
                 <programlisting language="text"><![CDATA[
@@ -391,8 +387,8 @@ RewriteRule ^.*$ index.php [NC,L]
             <title>Microsoft Internet Information サーバ</title>
 
             <para>
-                As of version 7.0, <acronym>IIS</acronym> now ships with a standard rewrite engine.
-                You may use the following configuration to create the appropriate rewrite rules.
+                バージョン 7.0 現在、 <acronym>IIS</acronym> には現在標準的なリライト・エンジンが含まれます。
+                適切なリライトルールを作成するために、以下の構成を使うかもしれません。
             </para>
 
             <programlisting language="xml"><![CDATA[