sync en

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

documentation/manual/ja/module_specs/Zend_Http_Client-Advanced.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 22466 -->
 <sect1 id="zend.http.client.advanced">
     <title>Zend_Http_Client - 高度な使用法</title>
 
@@ -17,7 +17,7 @@
             この際には同じリクエストメソッドを使用しなければなりません。
             しかし、ほとんどのクライアントはこの機能を実装しておらず、
             リダイレクトの際には常に GET メソッドを使用するようになっています。
-            デフォルトでは、Zend_Http_Client も同じように動作します。
+            デフォルトでは、<classname>Zend_Http_Client</classname> も同じように動作します。
             つまり、301 や 302 によるリダイレクト指示を受けると、
             GET パラメータや POST パラメータをすべてリセットした上で新しい場所に
             GET リクエストを送信します。この振る舞いを変更するには、設定パラメータ
@@ -42,7 +42,7 @@ $client->setConfig(array('strictredirects' => false));
     <sect2 id="zend.http.client.cookies">
         <title>クッキーの追加および持続的なクッキーの使用</title>
         <para>
-            Zend_Http_Client を使用すると、リクエストに簡単にクッキーを追加できます。
+            <classname>Zend_Http_Client</classname> を使用すると、リクエストに簡単にクッキーを追加できます。
             ヘッダを変更したりする必要はありません。クッキーを追加するには
             setCookie() メソッドを使用します。このメソッドにはいくつかの用法があります。
             <example id="zend.http.client.cookies.example-1">
@@ -60,11 +60,11 @@ $cookie = Zend_Http_Cookie::fromString('flavor=chocolate%20chips');
 $client->setCookie($cookie);
 ]]></programlisting>
             </example>
-            Zend_Http_Cookie オブジェクトについての詳細は
+            <classname>Zend_Http_Cookie</classname> オブジェクトについての詳細は
             <xref linkend="zend.http.cookies" /> を参照ください。
         </para>
         <para>
-            Zend_Http_Client は、クッキーの持続性 (stickiness) も提供しています。
+            <classname>Zend_Http_Client</classname> は、クッキーの持続性 (stickiness) も提供しています。
             送受信したクッキーをクライアントの内部で保持し、
             それ以降のリクエストで自動的に再送信します。
             これは、たとえばリモートサイトにログインして
@@ -90,7 +90,7 @@ $client->setUri('http://example.com/read_member_news.php');
 $client->request('GET');
 ]]></programlisting>
             </example>
-            Zend_Http_CookieJar クラスについての詳細は
+            <classname>Zend_Http_CookieJar</classname> クラスについての詳細は
             <xref linkend="zend.http.cookies.cookiejar" /> を参照ください。
         </para>
     </sect2>
@@ -148,13 +148,13 @@ $client->setHeaders(array(
             そしてオプションの三番目の引数がデータとなります。
             三番目のパラメータが <constant>NULL</constant> の場合は、
             最初のパラメータに指定したファイル名のファイルがあるものとみなされ、
-            Zend_Http_Client がそれを読み込んでアップロードしようとします。
+            <classname>Zend_Http_Client</classname> がそれを読み込んでアップロードしようとします。
             三番目のパラメータが <constant>NULL</constant> 以外の場合は、
             ファイル名は最初のパラメータを使用しますが実際の内容はディスク上に存在する必要がなくなります。
-            二番目のパラメータのフォーム名は常に必須です。HTML フォームでアップロードする場合、これは
+            二番目のパラメータのフォーム名は常に必須です。 <acronym>HTML</acronym> フォームでアップロードする場合、これは
             &gt;input&lt; タグの "name" 属性と等しくなります。
             四番目のオプションのパラメータは、ファイルの content-type です。
-            指定しなかった場合、Zend_Http_Client は、
+            指定しなかった場合、<classname>Zend_Http_Client</classname> は、
             ディスクから読み込んだファイルに対して mime_content_type
             関数を使用して content-type を判定します。
             いずれの場合でも、デフォルトの MIME 型は
@@ -194,7 +194,7 @@ $client->request('POST');
     <sect2 id="zend.http.client.raw_post_data">
         <title>生の POST データの送信</title>
         <para>
-            Zend_Http_Client で生の POST データを送信するには
+            <classname>Zend_Http_Client</classname> で生の POST データを送信するには
             setRawData() メソッドを使用します。このメソッドはふたつのパラメータを受け取ります。
             まず最初が、リクエスト本文で送信するデータです。
             二番目のパラメータはオプションで、データの content-type を指定します。
@@ -232,7 +232,7 @@ $client->setRawData($xml)->setEncType('text/xml')->request('POST');
     <sect2 id="zend.http.client.http_authentication">
         <title>HTTP 認証</title>
         <para>
-            現在 Zend_Http_Client がサポートしているのは、ベーシック <acronym>HTTP</acronym> 認証のみです。
+            現在 <classname>Zend_Http_Client</classname> がサポートしているのは、ベーシック <acronym>HTTP</acronym> 認証のみです。
             この機能を利用するには <methodname>setAuth()</methodname> メソッドを使用するか、
             あるいはユーザ名とパスワードを URI で指定します。
             <methodname>setAuth()</methodname> メソッドが受け取るパラメータは三つで、
@@ -305,6 +305,7 @@ $client->setUri('http://christer:secret@example.com');
         </para>
         <example id="zend.http.client.multiple_requests.example-1">
             <title>単一のクライアントによる連続したリクエストの実行</title>
+
             <programlisting language="php"><![CDATA[
 // まず、クライアントのインスタンスを作成します。
 $client = new Zend_Http_Client('http://www.example.com/fetchdata.php', array(
@@ -313,7 +314,7 @@ $client = new Zend_Http_Client('http://www.example.com/fetchdata.php', array(
 
 // セッションにクッキーが保存されていますか?
 if (isset($_SESSION['cookiejar']) &&
-    $_SESSION['cookiejar'] instanceof Zend_Http_CookieJar)) {
+    $_SESSION['cookiejar'] instanceof Zend_Http_CookieJar) {
 
     $client->setCookieJar($_SESSION['cookiejar']);
 } else {

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20827 -->
+<!-- EN-Revision: 21992 -->
 <sect1 id="zend.markup.renderers">
     <title>Zend_Markup レンダラー</title>
  
@@ -10,13 +10,13 @@
     </para>
  
     <sect2 id="zend.markup.renderers.add">
-        <title>自作のタグの追加</title>
+        <title>自作のマークアップを追加</title>
  
         <para>
-            自作のタグを追加することによって、<classname>Zend_Markup</classname> レンダラーに
-            自作の機能の追加できます。 タグ構造とともに、
+            自作のマークアップを追加することによって、<classname>Zend_Markup</classname> レンダラーに
+            自作の機能の追加できます。 マークアップ構造とともに、
             あなたが望むいかなる機能も追加ができます。
-            簡潔なタグから複雑なタグ構造まで。 'foo' タグでの単純な例:
+            簡潔なマークアップから複雑なマークアップ構造まで。 'foo' マークアップでの単純な例:
         </para>
  
         <programlisting language="php"><![CDATA[
@@ -24,12 +24,12 @@
 // Zend_Markup_Renderer_Html のインスタンスを生成します。
 $bbcode = Zend_Markup::factory('Bbcode');
  
-// これは単純な 'foo' タグが作成されるでしょう
-// 第一引数は自身のタグ名を定義します。
-// 第二引数はタグの定数で定義された整数を引数に取ります。
-// 第三引数は、タグについて、タググループと(この例では)開始ならびに終了タグのように
+// これは単純な 'foo' マークアップを作成するでしょう
+// 第一引数は自身のマークアップ名を定義します。
+// 第二引数はマークアップの定数で定義された整数を引数に取ります。
+// 第三引数は、マークアップについて、マークアップグループと(この例では)開始ならびに終了マークアップのように
 // 他のことを配列にて定義します。
-$bbcode->addTag(
+$bbcode->addMarkup(
     'foo',
     Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
     array(
@@ -39,30 +39,29 @@ $bbcode->addTag(
     )
 );
  
-// これは 'my -bar-tag-baz-' と出力されるでしょう。
-echo $bbcode->render('my [foo]tag[/foo]');
+// これは 'my -bar-markup-baz-' と出力されるでしょう。
+echo $bbcode->render('my [foo]markup[/foo]');
 ]]></programlisting>
 
         <para>
-            あなたの作成したタグは、あなたのパーサーがタグ構造もサポートするときに
+            あなたの作成したマークアップは、あなたのパーサーがマークアップ構造もサポートするときに
             機能することに注意してください。現在、 BBCode はこれをサポートします。
-            Textile はカスタムタグをサポートしません。
+            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.
+            Some renderers (like the <acronym>HTML</acronym> renderer) also have support for a
+            'markup' parameter. This replaces the 'start' and 'end' parameters, and
+            it renders the markups including some default attributes and the
+            closing markup.
         </para>
 
         <sect3 id="zend.markup.renderers.add.callback">
-            <title>Add a callback tag</title>
+            <title>Add a callback markup</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
+                By adding a callback markup, you can do a lot more then just a
+                simple replace of the markups. For instance, you can change the
                 contents, use the parameters to influence the output etc.
             </para>
 
@@ -73,7 +72,8 @@ echo $bbcode->render('my [foo]tag[/foo]');
             </para>
 
             <programlisting language="php"><![CDATA[
-class My_Markup_Renderer_Html_Upper extends Zend_Markup_Renderer_TokenConverterInterface
+class My_Markup_Renderer_Html_Upper
+    implements Zend_Markup_Renderer_TokenConverterInterface
 {
 
     public function convert(Zend_Markup_Token $token, $text)
@@ -85,22 +85,22 @@ class My_Markup_Renderer_Html_Upper extends Zend_Markup_Renderer_TokenConverterI
 ]]></programlisting>
 
             <para>
-                Now you can add the 'upper' tag, with as callback, an instance
+                Now you can add the 'upper' markup, 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
+// Zend_Markup_Parser_BbCode をパーサーとして、
+// Zend_Markup_Renderer_Html のインスタンスを生成します。
 $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.
+// これは単純な 'foo' マークアップを作成するでしょう
+// 第一引数は自身のマークアップ名を定義します。
+// 第二引数はマークアップ型を定義する整数を引数に取ります。
 // 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(
+// markup, like the markup's group, and (in this case) a start and end markup.
+$bbcode->addMarkup(
     'upper',
     Zend_Markup_Renderer_RendererAbstract::TYPE_REPLACE,
     array(
@@ -109,17 +109,17 @@ $bbcode->addTag(
     )
 );
 
-// now, this will output: 'my !up!TAG!up!'
-echo $bbcode->render('my [upper]tag[/upper]');
+// これは 'my !up!MARKUP!up!' と出力されるでしょう。
+echo $bbcode->render('my [upper]markup[/upper]');
 ]]></programlisting>
         </sect3>
     </sect2>
 
     <sect2 id="zend.markup.renderers.list">
-        <title>タグ一覧</title>
+        <title>マークアップ一覧</title>
 
-        <table id="zend.markup.renderers.list.tags">
-            <title>タグ一覧</title>
+        <table id="zend.markup.renderers.list.markups">
+            <title>マークアップ一覧</title>
 
             <tgroup cols="2" align="left" colsep="1" rowsep="1">
                 <thead>