[DOCUMENTATION] add 4 translation and fix TODOs

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

documentation/manual/ja/module_specs/Zend_Captcha-Adapters.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24024 -->
+<!-- EN-Revision: 24077 -->
 <sect1 id="zend.captcha.adapters">
     <title>CAPTCHA アダプタ</title>
 
@@ -268,18 +268,18 @@
             <listitem>
                 <para>
                     <methodname>isValid($value, $context = null)</methodname> validates the user's
-                    input against the ReCaptcha service.  $value is an array with the following
+                    input against the ReCaptcha service.  <varname>$value</varname> is an array with the following
                     keys:
                     <itemizedlist>
                         <listitem>
                             <para>
-                                recaptcha_challenge_field - Value of the ReCaptcha widget's 
+                                <varname>recaptcha_challenge_field</varname> - Value of the ReCaptcha widget's 
                                 challenge field (hidden)
                             </para>
                         </listitem>
                         <listitem>
                             <para>
-                                recaptcha_response_field - Value of the ReCaptcha widget's
+                                <varname>recaptcha_response_field</varname> - Value of the ReCaptcha widget's
                                 user input field
                             </para>
                         </listitem>

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

@@ -0,0 +1,88 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 22389 -->
+<sect2 id="zend.filter.set.alnum">
+    <title>Alnum(日本語)</title>
+
+    <para>
+        <classname>Zend_Filter_Alnum</classname> は、
+        アルファベットおよび数字だけを返すフィルターです。
+        他の全ての文字は抑止されます。
+        （訳注：ここでいうアルファベットおよび数字、とは各言語で使われる文字および数字の集合を意味します。英数字<emphasis>ではありません</emphasis>）
+    </para>
+
+    <sect3 id="zend.filter.set.alnum.options">
+        <title>Zend_Filter_Alnum でサポートされるオプション</title>
+
+        <para>
+            下記のオプションが <classname>Zend_Filter_Alnum</classname> でサポートされます。
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowwhitespace</property></emphasis>:
+                    このオプションが設定されていると、空白文字が許されます。
+                    設定されていない場合は抑止されます。既定値では、空白は許されません。
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.alnum.basic">
+        <title>基本的な使用法</title>
+
+        <para>
+            このフィルターの既定の振る舞いについては、下記の例をご覧ください。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alnum();
+$return = $filter->filter('This is (my) content: 123');
+// 'Thisismycontent123' を返します
+]]></programlisting>
+
+        <para>
+            上記の例は 'Thisismycontent123' を返します。
+            ご覧の通り、空白の全てと、括弧がフィルターされています。
+        </para>
+
+        <note>
+            <para>
+                <classname>Zend_Filter_Alnum</classname> はほとんどの言語で動作します。
+                しかし実際には、３つの例外、中国語、日本語、Koreanがあります。
+                これらの言語では、英語のアルファベットがそれらの言語の文字の替わりに使用されます。
+                この言語自身は <classname>Zend_Locale</classname> を使って検出されます。
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.filter.set.alnum.whitespace">
+        <title>空白を許す</title>
+
+        <para>
+            <classname>Zend_Filter_Alnum</classname> は空白も許します。
+            テキストから特別な文字を取り除きたい場合に役立つでしょう。下記の例をご覧ください。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alnum(array('allowwhitespace' => true));
+$return = $filter->filter('This is (my) content: 123');
+// 'This is my content 123' を返します。
+]]></programlisting>
+
+        <para>
+            上記の例は 'This is my content 123' を返します。
+            ご覧の通り、括弧はフィルターされましたが、空白には手が出されていません。
+        </para>
+
+        <para>
+            あとで <property>allowWhiteSpace</property> を変更するには、
+            <methodname>setAllowWhiteSpace()</methodname> や
+            <methodname>getAllowWhiteSpace()</methodname> を使用できます。
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 22247 -->
+<sect2 id="zend.filter.set.alpha">
+    <title>Alpha(日本語)</title>
+
+    <para>
+        <classname>Zend_Filter_Alpha</classname> は、
+        アルファベットを残して全てを削除した、文字列 <varname>$value</varname>
+        を返すフィルターです。このフィルターには、空白文字を許すオプションもあります。
+        （訳注：ここでいうアルファベット、とはアラビア文字やタイ文字、キリール文字など、各言語で使われる文字の集合を意味します。英字<emphasis>とは限りません</emphasis>）
+    </para>
+
+    <sect3 id="zend.filter.set.alpha.options">
+        <title>Zend_Filter_Alpha でサポートされるオプション</title>
+
+        <para>
+            下記のオプションが <classname>Zend_Filter_Alpha</classname> でサポートされます。
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowwhitespace</property></emphasis>:
+                    このオプションが設定されていると、空白文字が許されます。
+                    設定されていない場合は抑止されます。既定値では、空白文字は許されません。
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.alpha.basic">
+        <title>基本的な使用法</title>
+
+        <para>
+            下記は基本的な使用例です。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alpha();
+
+print $filter->filter('This is (my) content: 123');
+]]></programlisting>
+
+        <para>
+            上記の例は 'Thisismycontent' を返します。
+            空白文字と括弧が削除されていることに注意してください。
+        </para>
+
+        <note>
+            <para>
+                <classname>Zend_Filter_Alpha</classname> はほとんどの言語で動作します。
+                しかしながら、３つの例外、中国語、日本語、Koreanがあります。
+                これらの言語では、英語のアルファベットが使用されます。
+                言語は <classname>Zend_Locale</classname> の使用を通じて検出されます。
+            </para>
+        </note>
+    </sect3>
+
+     <sect3 id="zend.filter.set.alpha.whitespace">
+         <title>空白文字を許す</title>
+
+        <para>
+            <classname>Zend_Filter_Alpha</classname> は空白文字も許せます。
+            文字列から特別な文字を取り除きたい場合に役立つでしょう。
+            下記の例をご覧ください。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$filter = new Zend_Filter_Alpha(array('allowwhitespace' => true));
+
+print $filter->filter('This is (my) content: 123');
+]]></programlisting>
+
+        <para>
+            上記の例は 'This is my content ' を返します。
+            括弧やコロン、数字が全て除去された一方で、空白文字が残っていることに注意してください。
+        </para>
+
+        <para>
+            メソッド初期化後に <property>allowWhiteSpace</property> を変更するには、
+            <methodname>setAllowWhiteSpace()</methodname> が使えるでしょう。
+        </para>
+
+        <para>
+            メソッドの現在の <property>allowWhiteSpace</property> の値を照会するには、
+            <methodname>getAllowWhiteSpace()</methodname> が使えるでしょう。
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -6,7 +6,7 @@
 
     <para>
         このフィルタにより、 <classname>Zend_Filter</classname> とともに自分自身のメソッドを使えます。
-        機能を果たすメソッドすでにあるとき、新しいフィルタを生成する必要はありません。
+        機能を果たすメソッドがすでにあるとき、新しいフィルタを生成する必要はありません。
     </para>
 
     <sect3 id="zend.filter.set.callback.options">

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

@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 21987 -->
+<sect2 id="zend.validate.set.alnum">
+    <title>Alnum(一部日本語)</title>
+
+    <para>
+        <classname>Zend_Validate_Alnum</classname> により、
+        与えられた文字列がアルファベットおよび数字だけを含むかどうか検証できます。
+        検証したい入力に対する長さの制限はありません。
+        （訳注：ここでいうアルファベットおよび数字、とは各言語で使われる文字および数字の集合を意味します。英数字<emphasis>ではありません</emphasis>）
+    </para>
+
+    <sect3 id="zend.validate.set.alnum.options">
+        <title>Zend_Validate_Alnum でサポートされるオプション</title>
+
+        <para>
+            下記のオプションが <classname>Zend_Validate_Alnum</classname> でサポートされます。
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowWhiteSpace</property></emphasis>: 空白文字が許されるかどうか。
+                    このオプションの既定値は <constant>FALSE</constant> です。
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.validate.set.alnum.basic">
+        <title>基本的な使用法</title>
+
+        <para>
+            下記は基本的な使用例です。
+        </para>
+
+        <!-- TODO : to be translated -->
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Alnum();
+if ($validator->isValid('Abcd12')) {
+    // value contains only allowed chars
+} else {
+    // false
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.alnum.whitespace">
+        <title>空白を使用</title>
+
+        <para>
+            Per default whitespaces are not accepted because they are not part of the alphabet.
+            Still, there is a way to accept them as input. This allows to validate complete
+            sentences or phrases.
+        </para>
+
+        <para>
+            To allow the usage of whitespaces you need to give the
+            <property>allowWhiteSpace</property> option. This can be done while creating an instance
+            of the validator, or afterwards by using <methodname>setAllowWhiteSpace()</methodname>.
+            To get the actual state you can use <methodname>getAllowWhiteSpace()</methodname>.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Alnum(array('allowWhiteSpace' => true));
+if ($validator->isValid('Abcd and 12')) {
+    // value contains only allowed chars
+} else {
+    // false
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.alnum.languages">
+        <title>別の言語を使用</title>
+
+        <para>
+            When using <classname>Zend_Validate_Alnum</classname> then the language which the user
+            sets within his browser will be used to set the allowed characters. This means when your
+            user sets <emphasis>de</emphasis> for german then he can also enter characters like
+            <emphasis>ä</emphasis>, <emphasis>ö</emphasis> and <emphasis>ü</emphasis> additionally
+            to the characters from the english alphabet.
+        </para>
+
+        <para>
+            Which characters are allowed depends completly on the used language as every language
+            defines it's own set of characters.
+        </para>
+
+        <para>
+            実際には、それらの固有の文書で受け付けられない３つの言語があります。
+            それらの言語は、<emphasis>Korean</emphasis>、<emphasis>日本語</emphasis>、
+            <emphasis>中国語</emphasis>です。
+            <!-- TODO : to be translated -->
+            because this languages are using an alphabet where a
+            single character is build by using multiple characters.
+        </para>
+
+        <para>
+            これらの言語を使用する場合、入力は英語のアルファベットを使用した検証のみ行なわれます。
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -0,0 +1,109 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 21987 -->
+<sect2 id="zend.validate.set.alpha">
+    <title>Alpha(一部日本語)</title>
+
+    <para>
+        <classname>Zend_Validate_Alpha</classname> により、
+        与えられた文字列がアルファベットだけを含むかどうか検証できます。
+        検証したい入力に対する長さの制限はありません。
+        このバリデータは数字を受け付けませんが、
+        <classname>Zend_Validate_Alnum</classname> と関係があります。
+        （訳注：ここでいうアルファベット、とはアラビア文字やタイ文字、キリール文字など、各言語で使われる文字の集合を意味します。英字<emphasis>とは限りません</emphasis>）
+    </para>
+
+    <sect3 id="zend.validate.set.alpha.options">
+        <title>Zend_Validate_Alpha でサポートされるオプション</title>
+
+        <para>
+            下記のオプションが <classname>Zend_Validate_Alpha</classname> でサポートされます。
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allowWhiteSpace</property></emphasis>: 空白文字が許されるかどうか。
+                    このオプションの既定値は <constant>FALSE</constant> です。
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.validate.set.alpha.basic">
+        <title>基本的な使用法</title>
+
+        <para>
+            下記は基本的な使用例です。
+        </para>
+
+        <!-- TODO : to be translated -->
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Alpha();
+if ($validator->isValid('Abcd')) {
+    // value contains only allowed chars
+} else {
+    // false
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.alpha.whitespace">
+        <title>空白を使用</title>
+
+        <para>
+            Per default whitespaces are not accepted because they are not part of the alphabet.
+            Still, there is a way to accept them as input. This allows to validate complete
+            sentences or phrases.
+        </para>
+
+        <para>
+            To allow the usage of whitespaces you need to give the
+            <property>allowWhiteSpace</property> option. This can be done while creating an instance
+            of the validator, or afterwards by using <methodname>setAllowWhiteSpace()</methodname>.
+            To get the actual state you can use <methodname>getAllowWhiteSpace()</methodname>.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Alpha(array('allowWhiteSpace' => true));
+if ($validator->isValid('Abcd and efg')) {
+    // value contains only allowed chars
+} else {
+    // false
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.alpha.languages">
+        <title>別の言語を使用</title>
+
+        <para>
+            When using <classname>Zend_Validate_Alpha</classname> then the language which the user
+            sets within his browser will be used to set the allowed characters. This means when your
+            user sets <emphasis>de</emphasis> for german then he can also enter characters like
+            <emphasis>ä</emphasis>, <emphasis>ö</emphasis> and <emphasis>ü</emphasis> additionally
+            to the characters from the english alphabet.
+        </para>
+
+        <para>
+            Which characters are allowed depends completly on the used language as every language
+            defines it's own set of characters.
+        </para>
+
+        <para>
+            実際には、それらの固有の文書で受け付けられない３つの言語があります。
+            それらの言語は、<emphasis>Korean</emphasis>、<emphasis>日本語</emphasis>、
+            <emphasis>中国語</emphasis>です。
+            <!-- TODO : to be translated -->
+            because this languages are using an alphabet where a
+            single character is build by using multiple characters.
+        </para>
+
+        <para>
+            これらの言語を使用する場合、入力は英語のアルファベットを使用した検証のみ行なわれます。
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

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

@@ -2,20 +2,20 @@
 <!-- Reviewed: no -->
 <!-- EN-Revision: 21821 -->
 <sect2 id="zend.validate.set.greaterthan">
-    <title>GreaterThan(一部日本語)</title>
+    <title>GreaterThan(日本語)</title>
 
-    <!-- TODO : to be translated -->
     <para>
-        <classname>Zend_Validate_GreaterThan</classname> allows you to validate if a given value is
-        greater than a minimum border value.
+        <classname>Zend_Validate_GreaterThan</classname> により、
+        与えられた値が最小の境界値よりも大きいかどうか検証できます。
     </para>
 
     <note>
-        <title>Zend_Validate_GreaterThan supports only number validation</title>
+        <title>Zend_Validate_GreaterThan は、数値の検証のみサポートします</title>
 
         <para>
-            It should be noted that <classname>Zend_Validate_GreaterThan</classname> supports only
-            the validation of numbers. Strings or dates can not be validated with this validator.
+            <classname>Zend_Validate_GreaterThan</classname> は、
+            数値の検証のみをサポートすることに注意してください。
+            文字列や日付はこのバリデータでは検証できません。
         </para>
     </note>
 
@@ -38,22 +38,20 @@
     <sect3 id="zend.validate.set.greaterthan.basic">
         <title>基本的な使用法</title>
 
-        <!-- TODO : to be translated -->
         <para>
-            To validate if a given value is greater than a defined border simply use the following
-            example.
+            任意の値が定義済みの境界より大きいかどうか検証するには、
+            単に以下の例を使います。
         </para>
 
         <programlisting language="php"><![CDATA[
 $valid  = new Zend_Validate_GreaterThan(array('min' => 10));
 $value  = 10;
 $return = $valid->isValid($value);
-// returns true
+// true を返します。
 ]]></programlisting>
 
         <para>
-            The above example returns <constant>TRUE</constant> for all values which are equal to 10
-            or greater than 10.
+            上記の例は、10 以上の全ての値で <constant>TRUE</constant> を返します。
         </para>
     </sect3>
 </sect2>

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

@@ -2,14 +2,14 @@
 <!-- Reviewed: no -->
 <!-- EN-Revision: 21241 -->
 <sect2 id="zend.validate.set.hex">
-    <title>Hex(一部日本語)</title>
+    <title>Hex(日本語)</title>
 
-    <!-- TODO : to be translated -->
     <para>
-        <classname>Zend_Validate_Hex</classname> allows you to validate if a given value contains
-        only hexadecimal characters. These are all characters from <emphasis>0 to 9</emphasis> and
-        <emphasis>A to F</emphasis> case insensitive. There is no length limitation for the input
-        you want to validate.
+        <classname>Zend_Validate_Hex</classname> により、
+        任意の値が16進の文字だけを含むかどうか検証できます。
+        それらは、<emphasis>0 から 9 まで</emphasis>と、
+        文字の大小を区別しない<emphasis>A から F まで</emphasis>の、全ての文字です。
+        検証したい入力に対する長さの制限はありません。
     </para>
 
     <programlisting language="php"><![CDATA[
@@ -22,11 +22,11 @@ if ($validator->isValid('123ABC')) {
 ]]></programlisting>
 
     <note>
-        <title>Invalid characters</title>
+        <title>無効な文字</title>
 
         <para>
-            All other characters will return false, including whitespace and decimal point. Also
-            unicode zeros and numbers from other scripts than latin will not be treaten as valid.
+            他の文字は全て false を返します。それには空白や小数点を含みます。
+            ラテン文字以外の文書由来のユニコードのゼロや数字も、無効として扱われます。
         </para>
     </note>
 

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

@@ -2,21 +2,21 @@
 <!-- Reviewed: no -->
 <!-- EN-Revision: 21263 -->
 <sect2 id="zend.validate.set.lessthan">
-    <title>LessThan(一部日本語)</title>
+    <title>LessThan(日本語)</title>
 
-    <!-- TODO : to be translated -->
     <para>
-        <classname>Zend_Validate_LessThan</classname> allows you to validate if a given value is
-        less than a maximum border value. It is the cousine of
-        <classname>Zend_Validate_GreaterThan</classname>.
+        <classname>Zend_Validate_LessThan</classname> により、
+        与えられた値が最大の境界値よりも小さいかどうか検証できます。
+        それは <classname>Zend_Validate_GreaterThan</classname> に対応するものです。
     </para>
 
     <note>
-        <title>Zend_Validate_LessThan supports only number validation</title>
+        <title>Zend_Validate_LessThan は、数値の検証のみサポートします</title>
 
         <para>
-            It should be noted that <classname>Zend_Validate_LessThan</classname> supports only the
-            validation of numbers. Strings or dates can not be validated with this validator.
+            <classname>Zend_Validate_LessThan</classname> は、
+            数値の検証のみをサポートすることに注意してください。
+            文字列や日付はこのバリデータでは検証できません。
         </para>
     </note>
 
@@ -39,22 +39,20 @@
     <sect3 id="zend.validate.set.lessthan.basic">
         <title>基本的な使用法</title>
 
-        <!-- TODO : to be translated -->
         <para>
-            To validate if a given value is less than a defined border simply use the following
-            example.
+            任意の値が定義済みの境界より小さいかどうか検証するには、
+            単に以下の例を使います。
         </para>
 
         <programlisting language="php"><![CDATA[
 $valid  = new Zend_Validate_LessThan(array('max' => 10));
 $value  = 10;
 $return = $valid->isValid($value);
-// returns true
+// true を返します。
 ]]></programlisting>
 
         <para>
-            The above example returns <constant>TRUE</constant> for all values which are equal to 10
-            or lower than 10.
+            上記の例は、10 以下の全ての値で <constant>TRUE</constant> を返します。
         </para>
     </sect3>
 </sect2>