[DOCUMENTATION] correct translation word for "before", and some translation for documentation standard

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

documentation/manual/ja/module_specs/Zend_Soap_Wsdl.xml

@@ -34,7 +34,7 @@
                     <simpara>
                         <code>$strategy</code> - 複雑な型（オブジェクト）を検出する方策を
                         識別するために用いられるオプションのフラグです。
-                        これはバージョン1.7以前はブール値 <code>$extractComplexTypes</code>でしたが、
+                        これはバージョン1.7より前はブール値 <code>$extractComplexTypes</code>でしたが、
                         後方互換性のためにまだブール値として設定できます。
                         デフォルトで、1.6の検出動作が設定されます。
                         複雑な型の検出の方策について詳しくは、この節をご覧下さい:

documentation/manual/ja/ref/documentation-standard.xml

@@ -2,7 +2,7 @@
 <!-- Reviewed: no -->
 <!-- EN-Revision: 22743 -->
 <appendix id="doc-standard">
-    <title>Zend Framework ドキュメント標準</title>
+    <title>Zend Framework ドキュメント標準(一部日本語)</title>
 
     <sect1 id="doc-standard.overview">
         <title>概要</title>
@@ -42,8 +42,7 @@
             <title>XML タグ</title>
 
             <para>
-                Each manual file must include the following <acronym>XML</acronym> declarations at
-                the top of the file:
+                各マニュアルのファイル先頭に、下記の <acronym>XML</acronym> 宣言がなければなりません。
             </para>
 
             <programlisting language="xml"><![CDATA[
@@ -52,9 +51,8 @@
 ]]></programlisting>
 
             <para>
-                <acronym>XML</acronym> files from translated languages must also include a revision
-                tag containing the revision of the corresponding English-language file the
-                translation was based on.
+                翻訳した言語の <acronym>XML</acronym> ファイルには、
+                対応する翻訳元の英語ファイルのリビジョンに等しいリビジョン・タグもなければなりません。
             </para>
 
             <programlisting language="xml"><![CDATA[
@@ -67,6 +65,7 @@
         <sect2 id="doc-standard.file-formatting.max-line-length">
             <title>行の最大長</title>
 
+            <!-- TODO : to be translated -->
             <para>
                 The maximum line length, including tags, attributes, and indentation, is not to
                 exceed 100 characters. There is only one exception to this rule: attribute and value
@@ -77,9 +76,9 @@
         <sect2 id="doc-standard.file-formatting.indentation">
             <title>インデント</title>
 
-            <para>Indentation should consist of 4 spaces. Tabs are not allowed.</para>
+            <para>インデントは、空白文字４つで構成されなければなりません。タブは許されません。</para>
 
-            <para>Tags which are at the same level must have the same indentation.</para>
+            <para>同じレベルにあるタグは、同じインデントを持たなければなりません。</para>
 
             <programlisting language="xml"><![CDATA[
 <sect1>
@@ -90,8 +89,7 @@
 ]]></programlisting>
 
             <para>
-                Tags which are one level under the previous tag must be indented with 4 additional
-                spaces.
+                前のタグの１つ下のレベルのタグは、さらに4つの空白文字でインデントされなければなりません。
             </para>
 
             <programlisting language="xml"><![CDATA[
@@ -102,8 +100,8 @@
 ]]></programlisting>
 
             <para>
-                Multiple block tags within the same line are not allowed; multiple inline tags are
-                allowed, however.
+                複数のブロック・タグは、同一行の中では許されません。
+                しかしながら、インライン・タグは複数許されます。
             </para>
 
             <programlisting language="xml"><![CDATA[
@@ -122,15 +120,17 @@
             <title>行の終端</title>
 
             <para>
-                Line termination follows the Unix text file convention. Lines must end with a
-                single linefeed (LF) character. Linefeed characters are represented as ordinal 10,
-                or hexadecimal 0x0A.
+                行の終端は、Unixテキスト・ファイル規約に従います。
+                行は、単一のラインフィード（LF）文字で終わらなければなりません。
+                ラインフィード文字は、序数10または16進の0x0Aとして表現されます。
             </para>
 
             <para>
-                Note: Do not use carriage returns (<acronym>CR</acronym>) as is the convention in
-                Apple OS's (0x0D) or the carriage return - linefeed combination
-                (<acronym>CRLF</acronym>) as is standard for the Windows OS (0x0D, 0x0A).
+                注意：
+                Apple OS で規約となっているキャリッジ・リターン (<acronym>CR</acronym>;0x0D)
+                または、Windows OS で標準となっているキャリッジ・リターンと
+                ラインフィード (<acronym>CRLF</acronym>) の組合せ (0x0D, 0x0A)
+                を使用してはいけません。
             </para>
         </sect2>
 
@@ -158,8 +158,8 @@
             <sect3 id="doc-standard.file-formatting.whitespace.trailing">
                 <title>タグ内での空白</title>
 
+                <!-- TODO : to be translated -->
                 <para>
-                    <!-- TODO : to be translated -->
                     Opening block tags should have no whitespace immediately following them other
                     than line breaks (and indentation on the following line).
                 </para>
@@ -171,7 +171,7 @@
 ]]></programlisting>
 
                 <para>
-                    Opening inline tags should have no whitespace immediately following them.
+                    開始のインライン・タグの直後に空白文字を置いてはいけません。
                 </para>
 
                 <programlisting language="xml"><![CDATA[
@@ -182,6 +182,7 @@ This is the class <classname> Zend_Class</classname>.
 This is the class <classname>Zend_Class</classname>.
 ]]></programlisting>
 
+                <!-- TODO : to be translated -->
                 <para>
                     Closing block tags may be preceded by whitespace equivalent to the current
                     indentation level, but no more than that amount.
@@ -198,7 +199,7 @@ This is the class <classname>Zend_Class</classname>.
 ]]></programlisting>
 
                 <para>
-                    Closing inline tags must not be preceded by any whitespace.
+                    終わりのインライン・タグの前に空白文字を置いてはいけません。
                 </para>
 
                 <programlisting language="xml"><![CDATA[
@@ -269,10 +270,8 @@ This is the class <classname>Zend_Class</classname>
 ]]></programlisting>
 
                 <para>
-                    <!-- TODO : to be translated -->
-                    The first child tag should open directly below its parent, with no empty line
-                    between them; the last child tag should close directly before the closing tag of
-                    its parent.
+                    最初の子タグは、空行を置かずに親タグの直下に開かなければいけません。
+                    最後の子タグは、親タグが閉じる直前で閉じなければいけません。
                 </para>
 
                 <programlisting language="xml"><![CDATA[
@@ -308,6 +307,7 @@ This is the class <classname>Zend_Class</classname>
         <sect2 id="doc-standard.file-formatting.program-listing">
             <title>プログラム・リスティング</title>
 
+            <!-- TODO : to be translated -->
             <para>
                 The opening <emphasis>&lt;programlisting&gt;</emphasis> tag must indicate the
                 appropriate "language" attribute and be indented at the same level as its sibling
@@ -582,16 +582,16 @@ $render = "xxx";
             </para>
 
             <para>
-                <!-- TODO : to be translated -->
-                The style guidelines were written in large part to assist translators in recognizing
-                the lines that have changed using normal <command>diff</command> tools.
-                Autoformatting makes this process more difficult.
+                スタイル・ガイドラインは、通常の<command>diff</command>ツールを用いて
+                変更した行を翻訳者が確認できるようにするために主に書かれました。
+                自動フォーマットは、この処理をより難しくします。
             </para>
         </sect2>
 
         <sect2 id="doc-standard.recommendations.images">
             <title>イメージを使ってください</title>
 
+            <!-- TODO : to be translated -->
             <para>
                 Good images and diagrams can improve readability and comprehension. Use them
                 whenever they will assist in these goals. Images should be placed in the

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

@@ -26,7 +26,7 @@
 
         <programlisting language="php"><![CDATA[
 /**
- * Before 1.10
+ * 1.10 より前
  */
     public function errorAction()
     {
@@ -38,7 +38,7 @@
     // ...
 
 /**
- * With 1.10
+ * 1.10 では
  */
     public function errorAction()
     {
@@ -55,6 +55,7 @@
     <sect2 id="migration.110.zend.feed.reader">
         <title>Zend_Feed_Reader</title>
 
+        <!-- TODO : to be translated -->
         <para>
             With the introduction of Zend Framework 1.10, <classname>Zend_Feed_Reader</classname>'s
             handling of retrieving Authors and Contributors was changed, introducing
@@ -98,13 +99,13 @@
 
         <programlisting language="php"><![CDATA[
 /**
- * Before 1.10
+ * 1.10 より前
  */
 $feed = Zend_Feed_Reader::import('http://example.com/feed');
 $authors = $feed->getAuthors();
 
 /**
- * With 1.10
+ * 1.10 では
  */
 $feed = Zend_Feed_Reader::import('http://example.com/feed');
 $authors = $feed->getAuthors()->getValues();
@@ -115,8 +116,9 @@ $authors = $feed->getAuthors()->getValues();
         <title>Zend_File_Transfer</title>
 
         <sect3 id="migration.110.zend.file.transfer.files">
-            <title>Security change</title>
+            <title>セキュリティの変更</title>
 
+            <!-- TODO : to be translated -->
             <para>
                 For security reasons <classname>Zend_File_Transfer</classname> does no longer store
                 the original mimetype and filesize which is given from the requesting client into
@@ -162,6 +164,7 @@ $authors = $feed->getAuthors()->getValues();
                             <entry><constant>TOO_MUCH</constant></entry>
                             <entry><constant>TOO_MANY</constant></entry>
 
+                            <!-- Do not translate -->
                             <entry>
                                 Too many files, maximum '%max%' are allowed but '%count%' are given
                             </entry>
@@ -171,6 +174,7 @@ $authors = $feed->getAuthors()->getValues();
                             <entry><constant>TOO_LESS</constant></entry>
                             <entry><constant>TOO_FEW</constant></entry>
 
+                            <!-- Do not translate -->
                             <entry>
                                 Too few files, minimum '%min%' are expected but '%count%' are given
                             </entry>
@@ -186,16 +190,17 @@ $authors = $feed->getAuthors()->getValues();
         </sect3>
     </sect2>
 
-    <!-- TODO : to be translated -->
     <sect2 id="migration.110.zend.filter.html-entities">
         <title>Zend_Filter_HtmlEntities</title>
 
         <para>
-            In order to default to a more secure character encoding,
-            <classname>Zend_Filter_HtmlEntities</classname> now defaults to <acronym>UTF-8</acronym>
-            instead of <acronym>ISO-8859-1</acronym>.
+            よりセキュアな文字エンコードを既定値にするために、
+            <classname>Zend_Filter_HtmlEntities</classname> は、
+            <acronym>ISO-8859-1</acronym> の代わりに
+            <acronym>UTF-8</acronym> を既定値にしました。
         </para>
 
+        <!-- TODO : to be translated -->
         <para>
             Additionally, because the actual mechanism is dealing with character encodings and not
             character sets, two new methods have been added, <methodname>setEncoding()</methodname>
@@ -262,7 +267,7 @@ $trans = new Zend_Translate(
             <para>
                 かかれたバリデータ自身の内部からエラーを返すよう設定するときは、
                 <methodname>_error()</methodname>メソッドを呼ばなくてはいけません。
-                Zend Framework 1.10 以前では、パラメータを与えなくてもこのメソッドを呼び出せました。
+                Zend Framework 1.10 より前では、パラメータを与えなくてもこのメソッドを呼び出せました。
                 そこで、最初に見つかったメッセージテンプレートを使いました。
             </para>
 
@@ -306,7 +311,7 @@ My_Validator extends Zend_Validate_Abstract
             <title>日付バリデータの簡略化</title>
 
             <para>
-                Zend Framework 1.10 以前では、同一の２つのメッセージが、
+                Zend Framework 1.10 より前では、同一の２つのメッセージが、
                 日付バリデータ内でスローされていました。
                 これらは、<constant>NOT_YYYY_MM_DD</constant>と<constant>FALSEFORMAT</constant>でした。
                 Zend Framework 1.10 現在では、
@@ -319,7 +324,7 @@ My_Validator extends Zend_Validate_Abstract
             <title>Alpha、Alnum及びBarcodeバリデータの修正</title>
 
             <para>
-                Zend Framework 1.10 以前では、バーコード・アダプタ２種類と、
+                Zend Framework 1.10 より前では、バーコード・アダプタ２種類と、
                 Alpha 及び Alnum バリデータ内のメッセージが同一でした。
                 このため、カスタムのメッセージ、翻訳、
                 またはこれらのバリデータの複数のインスタンスを使うときに問題がありました。

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

@@ -2,7 +2,7 @@
 <!-- Reviewed: no -->
 <!-- EN-Revision: 21825 -->
 <sect1 id="migration.19">
-    <title>Zend Framework 1.9(日本語)</title>
+    <title>Zend Framework 1.9(一部日本語)</title>
 
     <para>
         1.9.0 よりも前にリリースされた Zend Framework から 1.9 のどのリリースに更新する際でも、
@@ -396,11 +396,13 @@ $container = new Zend_Navigation(array(
             <title>Zend_Filter_HtmlEntities</title>
 
             <para>
-                In order to default to a more secure character encoding,
-                <classname>Zend_Filter_HtmlEntities</classname> now defaults to
-                <acronym>UTF-8</acronym> instead of <acronym>ISO-8859-1</acronym>.
+                よりセキュアな文字エンコードを既定値にするために、
+                <classname>Zend_Filter_HtmlEntities</classname> は、
+                <acronym>ISO-8859-1</acronym> の代わりに
+                <acronym>UTF-8</acronym> を既定値にしました。
             </para>
 
+            <!-- TODO : to be translated -->
             <para>
                 Additionally, because the actual mechanism is dealing with character encodings and
                 not character sets, two new methods have been added,