[DOCUMENTATION] Japanese temporary ref/project-structure

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

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18056 -->
+<!-- EN-Revision: 18656 -->
 <appendix id="project-structure">
     <title>Zend Framework MVC アプリケーションのために推奨されるプロジェクト構造</title>
 
@@ -112,63 +112,66 @@
                             <emphasis><filename>controllers/</filename></emphasis>,
                             <emphasis><filename>models/</filename></emphasis>,
                             <emphasis><filename>views/</filename></emphasis>:
-                            <!-- TODO -->
-                            These directories
-                            serve as the default controller, model or view directories. Having
-                            these three directories inside the application directory provides the
-                            best layout for starting a simple project as well as starting a modular
-                            project that has global <filename>controllers/models/views</filename>.
+                            これらのディレクトリは、デフォルトのコントローラ、モデルまたは
+                            ビューのディレクトリとして用いられます。
+                            アプリケーション・ディレクトリの中にこれらの３つのディレクトリを持たせると、
+                            グローバルな <filename>controllers/models/views</filename> を持つ
+                            モジュラー・プロジェクトと同様に、
+                            単純なプロジェクトを始めるための最良のレイアウトが提供されます。
                         </para>
                     </listitem>
 
                     <listitem>
                         <para>
-                            <emphasis><filename>controllers/helpers/</filename></emphasis>: These
-                            directories will contain action helpers. Action helpers will be
-                            namespaced either as "<classname>Controller_Helper_</classname>" for
-                            the default module or "&lt;Module&gt;_Controller_Helper" in other
-                            modules.
+                            <emphasis><filename>controllers/helpers/</filename></emphasis>:
+                            これらのディレクトリにはアクション・ヘルパーを含みます。
+                            アクション・ヘルパーは、デフォルト・モジュールのための
+                            "<classname>Controller_Helper_</classname>"、
+                            または他のモジュールの "&lt;Module&gt;_Controller_Helper" として
+                            namespace されます。
                         </para>
                     </listitem>
 
                     <listitem>
                         <para>
-                            <emphasis><filename>layouts/</filename></emphasis>: This layout
-                            directory is for <acronym>MCV</acronym>-based layouts. Since
-                            <classname>Zend_Layout</classname> is capable of
-                            <acronym>MVC</acronym>- and non-<acronym>MVC</acronym>-based layouts,
-                            the location of this directory reflects that layouts are not on a
-                            1-to-1 relationship with controllers and are independent of templates
-                            within <filename>views/</filename>.
+                            <emphasis><filename>layouts/</filename></emphasis>:
+                            このレイアウト・ディレクトリは、 <acronym>MVC</acronym> ベースのレイアウト用です。
+                            <classname>Zend_Layout</classname> は <acronym>MVC</acronym> ベース、
+                            及び非 <acronym>MVC</acronym> ベースのレイアウトができるので、
+                            このディレクトリの位置は、レイアウトがコントローラとは１対１の関係ではなく、
+                            <filename>views/</filename> 内のテンプレートから独立していることを反映します。
                         </para>
                     </listitem>
 
                     <listitem>
                         <para>
-                            <emphasis><filename>modules/</filename></emphasis>: Modules allow a
-                            developer to group a set of related controllers into a logically
-                            organized group. The structure under the modules directory would
-                            resemble the structure under the application directory.
+                            <emphasis><filename>modules/</filename></emphasis>:
+                            モジュールにより、開発者は
+                            一組の関連したコントローラを論理的に系統化されたグループに分類できます。
+                            モジュール・ディレクトリ配下の構造は、
+                            アプリケーション・ディレクトリ配下の構造に似ています。
                         </para>
                     </listitem>
 
                     <listitem>
                         <para>
-                            <emphasis><filename>services/</filename></emphasis>: This directory is
-                            for your application specific web-service files that are provided by
-                            your application, or for implementing a <ulink
-                                url="http://www.martinfowler.com/eaaCatalog/serviceLayer.html">Service
-                                Layer</ulink> for your models.
+                            <emphasis><filename>services/</filename></emphasis>:
+                            このディレクトリは、
+                            アプリケーションによって、
+                            またはモデルのための<ulink
+                                url="http://www.martinfowler.com/eaaCatalog/serviceLayer.html">サービス・レイヤ</ulink>
+                            を実装するために提供される、
+                            アプリケーションに依存したウェブ・サービス・ファイルのためのものです。
                         </para>
                     </listitem>
 
                     <listitem>
                         <para>
-                            <emphasis><filename>Bootstrap.php</filename></emphasis>: This file is
-                            the entry point for your application, and should implement
-                            <classname>Zend_Application_Bootstrap_Bootstrapper</classname>.
-                            The purpose for this file is to bootstrap the application and make
-                            components available to the application by initializing them.
+                            <emphasis><filename>Bootstrap.php</filename></emphasis>:
+                            このファイルはアプリケーションのためのエントリ・ポイントで、
+                            <classname>Zend_Application_Bootstrap_Bootstrapper</classname> を実装するべきです。
+                            このファイルのための目的は、アプリケーションを起動すること、
+                            及びそれらを初期化することによって、コンポーネントがアプリケーションを利用できるようにすることです。
                         </para>
                     </listitem>
                 </itemizedlist>
@@ -176,25 +179,31 @@
 
             <listitem>
                 <para>
-                    <emphasis><filename>data/</filename></emphasis>: This directory provides a
-                    place to store application data that is volatile and possibly temporary. The
-                    disturbance of data in this directory might cause the application to fail.
-                    Also, the information in this directory may or may not be committed to a
-                    subversion repository. Examples of things in this directory are session files,
-                    cache files, sqlite databases, logs and indexes.
+                    <emphasis><filename>data/</filename></emphasis>:
+                    このディレクトリは、
+                    揮発性でおそらく一時的なアプリケーションのデータを格納するための場所を提供します。
+                    このディレクトリのデータの障害は、アプリケーションが失敗する原因になるかもしれません。
+                    また、このディレクトリの情報は、サブバージョン・リポジトリに関与するかもしれませんし、
+                    関与しないかもしれません。
+                    このディレクトリの物体の例は、
+                    セッション・ファイル、キャッシュ・ファイル、sqlite データベース、
+                    そしてログとインデックスです。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis><filename>docs/</filename></emphasis>: This directory contains
-                    documentation, either generated or directly authored.
+                    <emphasis><filename>docs/</filename></emphasis>:
+                    このディレクトリは、生成されたか、または直接編集された
+                    ドキュメンテーションを含みます。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis><filename>library/</filename></emphasis>: This directory is for
+                    <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
@@ -209,8 +218,10 @@
 
             <listitem>
                 <para>
-                    <emphasis><filename>public/</filename></emphasis>: This directory contains all
-                    public files for your application. <filename>index.php</filename> sets up and
+                    <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
@@ -220,8 +231,10 @@
 
             <listitem>
                 <para>
-                    <emphasis><filename>scripts/</filename></emphasis>: This directory contains
-                    maintenance and/or build scripts. Such scripts might include command line,
+                    <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.
                 </para>
@@ -229,7 +242,8 @@
 
             <listitem>
                 <para>
-                    <emphasis><filename>temp/</filename></emphasis>: The <filename>temp/</filename>
+                    <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
@@ -240,7 +254,8 @@
 
             <listitem>
                 <para>
-                    <emphasis><filename>tests/</filename></emphasis>: This directory contains
+                    <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