Ver Fonte

sync Japanese document with r16705.

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16722 44c647ce-9c0f-0410-b52a-842ac1e357ba
takagi há 16 anos atrás
pai
commit
5c30fd3509

+ 17 - 16
documentation/manual/ja/module_specs/Zend_Controller-Modular.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16165 -->
+<!-- EN-Revision: 16705 -->
 <sect1 id="zend.controller.modular">
     <title>モジュラーディレクトリ構造の規約の使用</title>
 
@@ -8,7 +8,7 @@
         <title>導入</title>
         <para>
             モジュラーディレクトリ構造の規約 (The Conventional Modular directory structure)
-            により、さまざまな MVC アプリケーションを自己完結した単位にまとめることができます。
+            により、さまざまな <acronym>MVC</acronym> アプリケーションを自己完結した単位にまとめることができます。
             また、それをさまざまなフロントコントローラで再利用できるようになります。
             このディレクトリ構造は、次のようになります。
         </para>
@@ -54,9 +54,9 @@ application/
             この考え方では、モジュール名が、
             その中に含まれるコントローラのプレフィックスとなります。
             上の例には、三つのモジュールコントローラ
-            'Blog_IndexController'、'News_IndexController' および
-            'News_ListController' が含まれます。また、グローバルコントローラも
-            'IndexController' と 'FooController' の二つが定義されています。
+            '<classname>Blog_IndexController</classname>'、'<classname>News_IndexController</classname>' および
+            '<classname>News_ListController</classname>' が含まれます。また、グローバルコントローラも
+            '<classname>IndexController</classname>' と '<classname>FooController</classname>' の二つが定義されています。
             これらは名前空間に属しません。この章のサンプルでは、
             ここで示したディレクトリ構造を使用します。
         </para>
@@ -68,13 +68,14 @@ application/
                 名前空間プレフィックスを必要としないことに注意しましょう。
                 したがって、上の例ではデフォルトモジュールのコントローラには
                 'Default_' は不要です。そのベースコントローラ名である
-                'IndexController' および 'FooController' にもとづいて単純にディスパッチされます。
+                '<classname>IndexController</classname>' および
+                '<classname>FooController</classname>' にもとづいて単純にディスパッチされます。
                 しかし、それ以外のモジュールでは名前空間プレフィックスを使用します。
             </para>
         </note>
 
         <para>
-            それでは、Zend Framework の MVC コンポーネントを使用して
+            それでは、Zend Framework の <acronym>MVC</acronym> コンポーネントを使用して
             これらのディレクトリ配置を実装するにはどうすればいいのでしょうか?
         </para>
     </sect2>
@@ -85,7 +86,7 @@ application/
         <para>
             モジュールを使用するための第一歩となるのが、
             フロントコントローラでのコントローラディレクトリの設定方法を変更することです。
-            基本的な MVC 版では、配列あるいは文字列を
+            基本的な <acronym>MVC</acronym> 版では、配列あるいは文字列を
             <methodname>setControllerDirectory()</methodname> に渡すか、
             あるいはパスを <methodname>addControllerDirectory()</methodname>
             に渡していました。モジュールを使用する場合は、
@@ -95,10 +96,10 @@ application/
         <para>
             <methodname>setControllerDirectory()</methodname> では、連想配列を渡す必要があります。
             連想配列のキーにはモジュール名、そしてその値としてディレクトリのパスを指定します。
-            特別な名前 <code>default</code> をキーにすると、グローバルコントローラ
+            特別な名前 <property>default</property> をキーにすると、グローバルコントローラ
             (モジュール名前空間を必要としないもの) を指定できます。
             すべてのエントリは、ひとつのパスをさす文字列のキーを含まなければなりません。
-            また、<code>default</code> というキーが必ず存在しなければなりません。
+            また、<property>default</property> というキーが必ず存在しなければなりません。
             次の例のようになります。
         </para>
 
@@ -112,7 +113,7 @@ $front->setControllerDirectory(array(
         <para>
             <methodname>addControllerDirectory()</methodname> では、オプションの二番目の引数を受け付けます。
             モジュールを使用する際には、モジュール名を二番目の引数で渡します。
-            指定しない場合は、そのパスは <code>default</code> 名前空間に追加されます。
+            指定しない場合は、そのパスは <emphasis>default</emphasis> 名前空間に追加されます。
             次の例のようになります。
         </para>
 
@@ -143,9 +144,9 @@ $front->addModuleDirectory('/path/to/application/modules');
 ]]></programlisting>
 
         <para>
-            上の例は <code>default</code>、
-            <code>foo</code> および <code>bar</code> というモジュールを定義しており、
-            それぞれのモジュール内に <code>controllers</code>
+            上の例は <emphasis>default</emphasis>、
+            <emphasis>foo</emphasis> および <emphasis>bar</emphasis> というモジュールを定義しており、
+            それぞれのモジュール内に <filename>controllers/</filename>
             ディレクトリを保持しています。
         </para>
 
@@ -205,8 +206,8 @@ $front->addModuleDirectory('/path/to/application/modules');
         <title>モジュールあるいはグローバルのデフォルトコントローラ</title>
 
         <para>
-            デフォルトのルータでは、コントローラが URL で指定されなかった場合には
-            デフォルトのコントローラ (特に指定しなければ <emphasis>IndexController</emphasis>)
+            デフォルトのルータでは、コントローラが <acronym>URL</acronym> で指定されなかった場合には
+            デフォルトのコントローラ (特に指定しなければ <classname>IndexController</classname>)
             を使用します。モジュール対応のコントローラにおいて、
             モジュールのみを指定してコントローラを指定しなかった場合は、
             ディスパッチャはまず最初にモジュールパス内のデフォルトコントローラを探します。

+ 5 - 5
documentation/manual/ja/module_specs/Zend_Controller-Plugins-ActionStack.xml

@@ -1,22 +1,22 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16178 -->
+<!-- EN-Revision: 16705 -->
 <sect3 id="zend.controller.plugins.standard.actionstack">
     <title>ActionStack</title>
 
     <para>
         <emphasis>ActionStack</emphasis> プラグインは、リクエストをスタックで管理します。
-        <code>postDispatch</code> プラグインとして動作します。
+        <emphasis>postDispatch</emphasis> プラグインとして動作します。
         現在のリクエストオブジェクトで既に転送先が指定されている
         (別のアクションがコールされている) 場合は、何も行いません。
         転送されていない場合はスタックの最上位の要素を取り出し、
         そのリクエストが指すアクションに転送します。
-        スタックの処理は LIFO (後入れ先出し) 方式で行います。
+        スタックの処理は <acronym>LIFO</acronym> (後入れ先出し) 方式で行います。
     </para>
 
     <para>
         このプラグインをフロントコントローラから取得するには、
-        <classname>Zend_Controller_Front::getPlugin('Zend_Controller_Plugin_ActionStack')</classname>
+        <methodname>Zend_Controller_Front::getPlugin('Zend_Controller_Plugin_ActionStack')</methodname>
         とします。プラグインオブジェクトを取得したら、
         さまざまな仕組みを利用できるようになります。
     </para>
@@ -33,7 +33,7 @@
         <listitem><para>
                 <methodname>getRegistryKey()</methodname> および <methodname>setRegistryKey()</methodname>。
                 これらは、スタックに格納する際にレジストリのどのキーを使用するかを指定します。
-                デフォルト値は 'Zend_Controller_Plugin_ActionStack' です。
+                デフォルト値は '<classname>Zend_Controller_Plugin_ActionStack</classname>' です。
         </para></listitem>
 
         <listitem><para>

+ 8 - 8
documentation/manual/ja/module_specs/Zend_Controller-Plugins-ErrorHandler.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16178 -->
+<!-- EN-Revision: 16705 -->
 <sect3 id="zend.controller.plugins.standard.errorhandler">
     <title>Zend_Controller_Plugin_ErrorHandler</title>
 
@@ -105,7 +105,7 @@
         <para>
             捕捉した例外は、リクエストで登録したオブジェクトの中に記録されます。
             これを取得するには、
-            <classname>Zend_Controller_Action::_getParam('error_handler')</classname>
+            <methodname>Zend_Controller_Action::_getParam('error_handler')</methodname>
             を使用します。
         </para>
 
@@ -121,28 +121,28 @@ class ErrorController extends Zend_Controller_Action
 
         <para>
             エラーオブジェクトを取得したら、次に
-            <varname>$errors->type</varname> でその型を調べます。
+            <command>$errors->type</command> でその型を調べます。
             これは、次のいずれかとなります。
         </para>
 
         <itemizedlist>
             <listitem>
                 <para>
-                    <classname>Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_CONTROLLER</classname>
+                    <constant>Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_CONTROLLER</constant>
                     は、コントローラが見つからなかったことを表します。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <classname>Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_ACTION</classname>
+                    <constant>Zend_Controller_Plugin_ErrorHandler::EXCEPTION_NO_ACTION</constant>
                     は、アクションが見つからなかったことを表します。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <classname>Zend_Controller_Plugin_ErrorHandler::EXCEPTION_OTHER</classname>
+                    <constant>Zend_Controller_Plugin_ErrorHandler::EXCEPTION_OTHER</constant>
                     は、その他の例外を表します。
                 </para>
             </listitem>
@@ -179,8 +179,8 @@ class ErrorController extends Zend_Controller_Action
 
         <para>
             エラーハンドラで発生した礼儀を取得するには、
-            <code>error_handler</code> オブジェクトのプロパティ
-            <code>exception</code> を使用します。
+            <emphasis>error_handler</emphasis> オブジェクトのプロパティ
+            <property>exception</property> を使用します。
         </para>
 
         <programlisting language="php"><![CDATA[

+ 5 - 5
documentation/manual/ja/module_specs/Zend_Controller-Plugins.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16595 -->
+<!-- EN-Revision: 16705 -->
 <sect1 id="zend.controller.plugins" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>プラグイン</title>
 
@@ -51,7 +51,7 @@
                     <link linkend="zend.controller.dispatcher">ディスパッチャ</link> でディスパッチされる前にコールされます。
                     このコールバックは、プロキシやフィルタ的な動作をさせることができます。
                     リクエストの内容を変更してディスパッチフラグをリセット
-                    (<classname>Zend_Controller_Request_Abstract::setDispatched(false)</classname> を使用します)
+                    (<methodname>Zend_Controller_Request_Abstract::setDispatched(false)</methodname> を使用します)
                     することで、現在のアクションをスキップさせたり置き換えたりすることができます。
                 </para>
             </listitem>
@@ -62,7 +62,7 @@
                     でディスパッチされた後にコールされます。
                     このコールバックは、プロキシやフィルタ的な動作をさせることができます。
                     リクエストの内容を変更してディスパッチフラグをリセット
-                    (<classname>Zend_Controller_Request_Abstract::setDispatched(false)</classname> を使用します)
+                    (<methodname>Zend_Controller_Request_Abstract::setDispatched(false)</methodname> を使用します)
                     することで、新しいディスパッチ先アクションを指定することができます。
                 </para>
             </listitem>
@@ -111,7 +111,7 @@ class MyPlugin extends Zend_Controller_Plugin_Abstract
         <title>プラグインの使用法</title>
         <para>
             プラグインクラスを登録するには、
-            <classname>Zend_Controller_Front::registerPlugin()</classname> をコールします。
+            <methodname>Zend_Controller_Front::registerPlugin()</methodname> をコールします。
             これは、いつでも行うことができます。
             次の例は、コントローラチェインでプラグインを使用する方法を示すものです。
         </para>
@@ -199,7 +199,7 @@ $front->dispatch();
             <listitem><para>
                     <methodname>getPlugin($class)</methodname>
                     は、指定したクラス名のプラグインを取得します。
-                    一致するプラグインがない場合は false を返します。
+                    一致するプラグインがない場合は <constant>FALSE</constant> を返します。
                     同じクラス名のプラグインが複数登録されている場合は、結果を配列で返します。
             </para></listitem>
 

+ 26 - 26
documentation/manual/ja/module_specs/Zend_Controller-QuickStart.xml

@@ -1,14 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16178 -->
+<!-- EN-Revision: 16705 -->
 <sect1 id="zend.controller.quickstart">
     <title>Zend_Controller クイックスタート</title>
 
     <sect2 id="zend.controller.quickstart.introduction">
         <title>導入</title>
         <para>
-            <classname>Zend_Controller</classname> は、Zend Framework の MVC
-            システムの中心となるものです。MVC は <ulink
+            <classname>Zend_Controller</classname> は、Zend Framework の <acronym>MVC</acronym>
+            システムの中心となるものです。<acronym>MVC</acronym> は <ulink
                 url="http://en.wikipedia.org/wiki/Model-view-controller">モデル-ビュー-コントローラ</ulink>
             の頭文字をとったもので、アプリケーションのロジックと表示ロジックを分離させる設計手法です。
             <classname>Zend_Controller_Front</classname> は
@@ -16,7 +16,7 @@
                 url="http://www.martinfowler.com/eaaCatalog/frontController.html">
                 フロントコントローラ</ulink> パターンを実装しており、
             すべてのリクエストをいったんフロントコントローラで受け取った上でその
-            URL にもとづいたアクションコントローラに配送します。
+            <acronym>URL</acronym> にもとづいたアクションコントローラに配送します。
         </para>
         <para>
             <classname>Zend_Controller</classname> は、拡張性を考慮して作成されています。
@@ -67,7 +67,7 @@ html/
 
             <para>
                 ウェブサーバのドキュメントルートを、先ほどのレイアウト中の
-                <code>html</code> ディレクトリに設定します。
+                <filename>html/</filename> ディレクトリに設定します。
             </para>
         </sect3>
 
@@ -105,7 +105,7 @@ RewriteRule ^.*$ index.php [NC,L]
             </note>
 
             <para>
-                IIS 7.0 をお使いの場合は、次のような rewrite 設定を使用します。
+                <acronym>IIS</acronym> 7.0 をお使いの場合は、次のような rewrite 設定を使用します。
             </para>
 
             <programlisting language="xml"><![CDATA[
@@ -178,15 +178,15 @@ Zend_Controller_Front::run('/path/to/app/controllers');
             <para>
                 アクションコントローラについて説明する前に、まず
                 Zend Framework でのリクエストの処理方法について知っておきましょう。
-                デフォルトでは、URL パスの最初の部分がコントローラ、
-                そしてその次の部分がアクションに対応します。たとえば URL が
+                デフォルトでは、<acronym>URL</acronym> パスの最初の部分がコントローラ、
+                そしてその次の部分がアクションに対応します。たとえば <acronym>URL</acronym>
                 <filename>http://framework.zend.com/roadmap/components</filename>
                 である場合、パスは <filename>/roadmap/components</filename>
-                となり、これは <code>roadmap</code> コントローラの
-                <code>components</code> アクションに対応します。
-                アクションを省略した場合は <code>index</code> アクションであるとみなされます。
-                またコントローラを省略した場合は <code>index</code> コントローラであるとみなされます
-                (Apache が自動的に <code>DirectoryIndex</code>
+                となり、これは <emphasis>roadmap</emphasis> コントローラの
+                <emphasis>components</emphasis> アクションに対応します。
+                アクションを省略した場合は <emphasis>index</emphasis> アクションであるとみなされます。
+                またコントローラを省略した場合は <emphasis>index</emphasis> コントローラであるとみなされます
+                (Apache が自動的に <emphasis>DirectoryIndex</emphasis>
                 に対応させるという規約に従っています)。
             </para>
 
@@ -194,17 +194,17 @@ Zend_Controller_Front::run('/path/to/app/controllers');
                 <classname>Zend_Controller</classname> のディスパッチャは、
                 コントローラを対応するクラスに関連付けます。
                 デフォルトでは、コントローラ名の先頭を大文字にしたものに
-                <code>Controller</code> をつなげたものがクラス名となります。
-                つまり、上の例では <code>roadmap</code> コントローラが
-                <code>RoadmapController</code> クラスに対応することになります。
+                <emphasis>Controller</emphasis> をつなげたものがクラス名となります。
+                つまり、上の例では <emphasis>roadmap</emphasis> コントローラが
+                <emphasis>RoadmapController</emphasis> クラスに対応することになります。
             </para>
 
             <para>
                 同様に、アクションもコントローラクラスのメソッドに関連付けます。
                 デフォルトでは、アクション名を小文字に変換して
-                <code>Action</code> を追加したものがメソッド名となります。
-                つまり、上の例では <code>components</code> アクションは
-                <code>componentsAction</code> メソッドになり、最終的に
+                <emphasis>Action</emphasis> を追加したものがメソッド名となります。
+                つまり、上の例では <emphasis>components</emphasis> アクションは
+                <methodname>componentsAction()</methodname> メソッドになり、最終的に
                 <methodname>RoadmapController::componentsAction()</methodname>
                 がコールされることになります。
             </para>
@@ -213,7 +213,7 @@ Zend_Controller_Front::run('/path/to/app/controllers');
                 続いて、デフォルトのアクションコントローラと
                 アクションメソッドを作ってみましょう。
                 先ほど説明したように、デフォルトのコントローラ名およびアクション名はどちらも
-                <code>index</code> となります。
+                <emphasis>index</emphasis> となります。
                 <filename>application/controllers/IndexController.php</filename>
                 を開き、次の内容を入力しましょう。
             </para>
@@ -234,15 +234,15 @@ class IndexController extends Zend_Controller_Action
                 アクションヘルパーが有効になります。つまり、
                 アクションメソッドとそれに対応するビュースクリプトを用意すれば、
                 すぐにその内容をレンダリングできるというわけです。
-                デフォルトでは、MVCのビュー層として <classname>Zend_View</classname> を使用します。
+                デフォルトでは、<acronym>MVC</acronym> のビュー層として <classname>Zend_View</classname> を使用します。
                 <emphasis>ViewRenderer</emphasis> は、コントローラ名
-                (たとえば <code>index</code>) とアクション名
-                (たとえば <code>index</code>) から処理するテンプレートを決定します。
+                (たとえば <emphasis>index</emphasis>) とアクション名
+                (たとえば <emphasis>index</emphasis>) から処理するテンプレートを決定します。
                 デフォルトでは、テンプレートの拡張子は
                 <filename>.phtml</filename> となります。つまり、上の例では
                 <filename>index/index.phtml</filename> をレンダリングします。
                 さらに <emphasis>ViewRenderer</emphasis> は、
-                コントローラと同一階層にある <code>views</code>
+                コントローラと同一階層にある <filename>views/</filename>
                 ディレクトリを自動的にビューの基底ディレクトリとみなし、
                 <filename>views/scripts/</filename> ビュースクリプトがおかれるものと考えます。
                 したがって、実際にレンダリングされるテンプレートは
@@ -260,7 +260,7 @@ class IndexController extends Zend_Controller_Action
                 <filename>application/views/scripts/</filename> です。
                 デフォルトコントローラにおけるデフォルトのアクションのビュースクリプトは
                 <filename>application/views/scripts/index/index.phtml</filename>
-                となります。このファイルを作成し、何か HTML を入力してみましょう。
+                となります。このファイルを作成し、何か <acronym>HTML</acronym> を入力してみましょう。
             </para>
 
             <programlisting language="php"><![CDATA[
@@ -332,7 +332,7 @@ PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
             <para>
                 ここまでくれば、実際にブラウザでサイトを表示してみることができます。
                 あなたのドメインが <filename>example.com</filename> だとすると、
-                以下のいずれかの URL で先ほど作成したページが表示されることでしょう。
+                以下のいずれかの <acronym>URL</acronym> で先ほど作成したページが表示されることでしょう。
             </para>
 
             <itemizedlist>