update of Japanese translation of the reference guide

more-with-symfony/ja/translators.markdown

@@ -71,10 +71,18 @@ Yoshihiro TAKAHARA (高原 芳浩)
 
 **Twitter**: *http://twitter.com/tumf*
 
+Tomohiro MITSUMUNE (光宗 朋宏)
+------------------------------
+[株式会社カカクコム](http://corporate.kakaku.com/)のエンジニア。[写真共有サイトPHOTOHITO](http://photohito.com/)のメイン開発者。symfony には0.6.4の頃から触れている。そろそろ新しいフレームワークを触ってみたいと思っており、Symfony2 と Ruby on Rails3.0 が気になっている。
+
+**Web サイト**: *http://d.hatena.ne.jp/Kiske*
+
+**Twitter**: *http://twitter.com/Kiske*
+
 Masaki Kagaya (加賀谷 昌樹)
 ---------------------------
 
-PHP エンジニアおよび翻訳者としての修行を積むために MediaWiki、symfony および Doctrine の公式マニュアルの翻訳に携わる。2010年より PHP 公式マニュアルの翻訳を始める。
+PHP エンジニアおよび翻訳者としての修行を積むために MediaWiki、symfony および Doctrine の公式マニュアルの翻訳に携わる。
 
 **Web サイト**: *http://sarabande.jp*
 

reference/ja/01-Introduction.markdown

@@ -1,12 +1,12 @@
 まえがき
 ========
 
-Web 開発の速度と効率を上げる方法のなかで、もっとも簡単なのは symfony のようなフルスタックフレームワークを利用することです。
+Web 開発を効率よく進める方法のなかで、もっともかんたんなのは symfony のようなフルスタックフレームワークを利用することです。
 
-フレームワークにはたくさんの便利な機能が搭載されており、別のオブジェクトページャやデータベース抽象化レイヤーの実装に取り組まずに、ビジネスロジックに専念できるよう手助けしてくれます。しかしながら、学習コストもかかります。すべての組み込み機能とあり得るすべてのコンフィギュレーションを一夜で学ぶことはできません。
+フレームワークの機能は充実しているので、オブジェクトページャやデータベース抽象化レイヤーの実装に取り組まなくても、ビジネスロジックに専念できます。しかしながら、勉強する時間が必要になります。すべての組み込み機能とありうるすべてのコンフィギュレーションを一夜で学ぶことはできません。
 
-「[*実践 symfony*](http://www.symfony-project.org/jobeet/)」は、初心者が symfony を学び、Web 開発のベストプラクティスの実践を理解するためのすばらしい教材です。
+symfony の初心者の方には、まず最初に「[*実践 symfony*](http://www.symfony-project.org/jobeet/)」を読むことをおすすめします。Web 開発におけるベストプラクティスの実践もこの本から学ぶことができます。
 
-プロジェクトを始めるとき、質問にすぐ答えてくれるリファレンスガイドが手元に必要です。「*symfony リファレンスガイド*」はこのような案内をすることを目的とした本であり、「*実践 symfony*」の内容を補います。symfony を使って開発をするときはこの本をいつも手元に置きましょう。詳細な目次、用語の索引、各章の相互参照、表などのおかげで、調べたいコンフィギュレーションがすぐに見つかります。
+symfony による開発プロジェクトをはじめるとき、質問にすぐ答えてくれるリファレンスガイドが手元に必要です。「*symfony リファレンスガイド*」はこの目的のために書かれた本で、「*実践 symfony*」の内容を補います。symfony を使って開発をするときはいつもこの本を手元に置きましょう。詳細な目次、用語の索引、各章の相互参照、表などのおかげで、調べたいコンフィギュレーションはすぐに見つかります。
 
-筆者は symfony のリード開発者ですが、ときどきこの本を読み返して、コンフィギュレーションの特定の設定を探したり、大きなヒントを再発見したりしています。筆者と同じように読者のみなさんが毎日楽しく読んでいただけることを祈っております。
+筆者は symfony のリード開発者ですが、ときどきこの本を読み返して、コンフィギュレーションの特定の設定を探したり、大きなヒントを再発見したりしています。筆者と同じように、読者のみなさんもこの本を毎日楽しく読んでいただけることを願っております。

reference/ja/02-YAML.markdown

@@ -1,11 +1,11 @@
 YAML フォーマット
 ================
 
-symfony フレームワークにおいて、設定ファイルの大半は YAML (ヤメル) フォーマットです。[YAML](http://yaml.org/) の公式サイトによれば、YAML は「人間が読みやすいように最適化された、すべてのプログラミング言語のための標準データシリアライゼーション」です。
+symfony フレームワークにおいて、設定ファイルの大半は YAML (ヤメル) で書かれています。[YAML](http://yaml.org/) の公式サイトによれば、YAML とは「人間が読みやすいように最適化された、すべてのプログラミング言語のための標準的なデータシリアライゼーション」です。
 
-YAML はデータを記述するためのシンプルな言語です。PHP のように、文字列、ブール値、浮動小数点数、整数のようなシンプルなデータ型のための構文をもちます。PHP と異なる点は、配列 (シーケンス) とハッシュ (マッピング) のあいだに違いがあることです。
+YAML はデータを記述するためのシンプルな軽量マークアップ言語です。文字列、ブール値、浮動小数点数、整数のような単純なデータ型をあらわすための構文は PHP と似ています。PHP と異なる構文は配列 (シーケンス) とハッシュ (マッピング) です。
 
-YAML フォーマットは複雑な入れ子のデータ構造を記述することもできますが、この章では、symfony の設定ファイルを扱うために、YAML について最低限知る必要のある内容だけを説明します。
+複雑なネストのデータ構造も YAML であらわすことができますが、この章では、symfony の設定ファイルを扱うために、YAML について知っておかなければならない最小限の知識を説明します。
 
 
 スカラー
@@ -15,36 +15,34 @@ YAML フォーマットは複雑な入れ子のデータ構造を記述するこ
 
 ### 文字列
 
-    [yml]
-    YAML における文字列
-
--
+文字列はシングルクォートかダブルクォートで囲みます。
 
     [yml]
-    'YAML におけるシングルクォートで囲まれる文字'
+    'シングルクォートで囲まれた文字'
 
 >**TIP**
->シングルクォート (`'`) で囲まれる文字列のなかでシングルクォートを表現するには、2つ重ねなければなりません:
+>シングルクォート (`'`) で囲まれた文字列のなかでシングルクォートをあらわすには、シングルクォートを2つ連ねます。
 >
 >     [yml]
->     'シングルクォートで囲まれる文字列のなかでのシングルクォート '' '
+>     'シングルクォートで囲まれた文字列のなかでのシングルクォート '' '
 
-    [yml]
-    "YAML におけるダブルクォートの文字列\n"
 
-文字列が1つ以上の適切なスペースで始まるもしくは終わるときは、クォートスタイル (クォートで囲む方法) が便利です。
+文字列が1つ以上の適切なスペースではじまるもしくは終わる場合には、クォートスタイル (クォートで囲む方法) が適しています。
 
 >**TIP**
->ダブルクォートスタイルはエスケープシーケンス (`\`) を使って任意の文字列を表す方法も提供します。文字列に `\n` もしくは Unicode を埋め込むことが必要なときにこのスタイルが重宝します。
+>ダブルクォートスタイルでは任意の文字列をあらわすのにエスケープシーケンス (`\`) を使うこともできます。こちらのスタイルは文字列に `\n` もしくは Unicode を埋め込む場合に適しています。
+>
+>     [yml]
+>     "ダブルクォートで囲まれた文字列\n"
 
-文字列に改行を入れるとき、パイプ (`|`) によって示されるリテラルスタイルを選ぶことができます。このスタイルは複数行にわたる文字列を表し、改行は保たれます:
+文字列に改行を入れる場合、パイプ (`|`) によって示されるリテラルスタイルを選ぶことができます。このスタイルでは、文字列は複数行にわたってあらわされ、改行は保たれます。
 
     [yml]
     |
       \/ /| |\/| |
       / / | |  | |__
 
-代わりの方法として、文字列を大なり記号 (`>`) で示される折り畳みスタイルで表すことができます。それぞれの改行はスペースに置き換わります:
+ほかにも、大なり記号 (`>`) で示される折り畳みスタイルを選ぶことができます。それぞれの改行はスペースに置き換わります。
 
     [yml]
     >
@@ -54,7 +52,7 @@ YAML フォーマットは複雑な入れ子のデータ構造を記述するこ
       文字列としてレンダリングされます。
 
 >**NOTE**
->上記の例では、それぞれの行頭にある2つのスペースに注目してください。これらのスペースは出力結果の PHP 文字列には現れません。
+>上記の例では、それぞれの行頭にある2文字分のスペースにご注目ください。これらのスペースは出力結果の PHP 文字列にはあらわれません。
 
 ### 数字
 
@@ -94,65 +92,65 @@ YAML フォーマットは複雑な入れ子のデータ構造を記述するこ
 
 ### null
 
-ヌルの値は `null` もしくはチルダ (`~`) で表されます。
+ヌル (ナル) の値は `null` もしくはチルダ (`~`) であらわします。
 
 ### ブール値
 
-ブール値は `true` と `false` で表されます。
+ブール値は `true` と `false` であらわします。
 
 ### 日付
 
-日付の表記は ISO-8601 標準に準拠します:
+日付のフォーマットは ISO-8601 標準に準拠します。
 
     [yml]
     2001-12-14t21:59:43.10-05:00
 
 -
 
     [yml]
-    # シンプルな日付
+    # 単純な日付
     2002-12-14
 
 コレクション
 ------------
 
-シンプルなスカラーを記述するためだけに YAML ファイルが使われることはほとんどありません。ほとんどの場合、コレクションを記述することになります。コレクションは要素のシーケンスとマッピングで構成されます。シーケンスとマッピングは両方とも PHP 配列に変換されます。
+単純なスカラーをあらわすためだけに YAML ファイルを使うことはめったにありません。ほとんどの場合、コレクションをあらわすことになります。コレクションはシーケンスとマッピングのどちらかの要素になります。シーケンスとマッピングは両方とも PHP 配列に変換されます。
 
-シーケンスにおいて、ダッシュ (`-`) の直後にスペースを入れます:
+シーケンスでは、ダッシュ (`-`) の直後にスペースを入れます。
 
     [yml]
     - PHP
     - Perl
     - Python
 
-上記の YAML ファイルは次の PHP コードと同じです:
+上記の YAML コードは次の PHP コードと同等です。
 
     [php]
     array('PHP', 'Perl', 'Python');
 
-マッピングにおいて、それぞれのキーと値のペアを表すのにコロン (`:`) とスペースを使います:
+マッピングでは、キーと値のペアをあらわすには、コロン (`:`) とスペースを使います。
 
     [yml]
     PHP: 5.2
     MySQL: 5.1
     Apache: 2.2.20
 
-上記のコードは次の PHP コードと同じです:
+上記の YAML コードは次の PHP コードと同等です。
 
     [php]
     array('PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20');
 
 >**NOTE**
->マッピングではキーは有効な YAML スカラーになります。
+>マッピングでは、キーは有効なスカラーの値になります。
 
-少なくともスペースが1つ入っていれば、コロンと値のあいだのスペースの数は問いません:
+少なくともスペースが1つ入っていれば、コロンと値のあいだのスペースの数は問いません。
 
     [yml]
     PHP:    5.2
     MySQL:  5.1
     Apache: 2.2.20
 
-入れ子のコレクションを表すには、1つもしくは複数のスペースで字下げします:
+ネストのコレクションをあらわすには、1つもしくは複数のスペースでインデントを入れます。
 
     [yml]
     "symfony 1.0":
@@ -162,7 +160,7 @@ YAML フォーマットは複雑な入れ子のデータ構造を記述するこ
       PHP:    5.2
       Propel: 1.3
 
-上記の YAML は次の PHP コードと同じです:
+上記の YAML コードは次の PHP コードと同等です。
 
     [php]
     array(
@@ -176,9 +174,9 @@ YAML フォーマットは複雑な入れ子のデータ構造を記述するこ
       ),
     );
 
-YAML ファイルのなかで字下げするときに覚えておくことが1つあります: *字下げには1つもしくは複数のスペースを使い、タブを使ってはなりません*。
+YAML コードのなかでインデントを入れるときに念頭に置くことが1つあります。*1つもしくは複数のスペースを使います。タブを使ってはなりません*。
 
-次のようにシーケンスとマッピングを入れ子にできます:
+次のようにシーケンスとマッピングをネストにすることができます。
 
     [yml]
     '第1章':
@@ -188,19 +186,19 @@ YAML ファイルのなかで字下げするときに覚えておくことが1
       - はじめに
       - ヘルパー
 
-スコープを表すのに字下げよりも明確なインジケータが使われるので、フロースタイルはコレクションを表すのに便利です。
+スコープをあらわすのにインデントよりもわかりやすい記号が使われるので、フロースタイルはコレクションをあらわすのに適しています。
 
-シーケンスでは、コレクションは、角かっこ (`[]`) で囲まれカンマで区切られたリストとして表すことができます:
+シーケンススタイルでは、コレクションは、角かっこ (`[]`) で囲まれ、カンマで区切られたリストとしてあらわされます。
 
     [yml]
     [PHP, Perl, Python]
 
-マッピングでは、コレクションは、波かっこ (`{}`) で囲まれ、カンマで区切られたキーもしくは値として表すことができます:
+マッピングスタイルでは、コレクションは、波かっこ (`{}`) で囲まれ、カンマで区切られたキーもしくは値としてあらわされます。
 
     [yml]
     { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
 
-より見やすくするために、複数のスタイルを混ぜることができます:
+見やすくするために、複数のスタイルを組み合わせることができます。
 
     [yml]
     '第1章': [はじめに, イベントの種類]
@@ -215,30 +213,30 @@ YAML ファイルのなかで字下げするときに覚えておくことが1
 コメント
 --------
 
-コメントを表すには、行頭にハッシュ記号 (`#`) をつけます:
+文字列の行頭をハッシュ記号 (`#`) にすればコメントになります。
 
     [yml]
     # 行コメント
     "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # 行末のコメント
     "symfony 1.2": { PHP: 5.2, Propel: 1.3 }
 
 >**NOTE**
->コメントは YAML パーサーによって無視され、コレクションの入れ子の現在のレベルにしたがって字下げされます。
+>コメントは YAML パーサーによって無視され、コレクションのネストの現在のレベルにしたがってインデントが入ります。
 
 動的な YAML ファイル
 --------------------
 
-symfony では、YAML のなかで PHP コードを記述することが可能で、YAML ファイルがパースされる直前に PHP コードが評価されます:
+symfony のプロジェクトでは、YAML ファイルのなかで PHP コードを書くことが可能です。PHP コードが評価されるタイミングは YAML ファイルがパースされる直前です。
 
     [php]
     1.0:
       version: <?php echo file_get_contents('1.0/VERSION')."\n" ?>
     1.1:
       version: "<?php echo file_get_contents('1.1/VERSION') ?>"
 
-字下げで散らかさないようにご注意ください。YAML ファイルに PHP コードを追加するとき、次のシンプルなティップスを思い出してください:
+インデントで散らかさないようにご注意ください。YAML ファイルに PHP コードを書き加えるとき、次のルールを思い出してください。
 
- * `<?php ?>` ステートメントは行で始めるもしくは値に埋め込まなければなりません。
+ * `<?php ?>` ステートメントは行ではじめるか、値に埋め込まなければなりません。
 
  * `<?php ?>` ステートメントが単一行で終わるとき、改行 (`\n`) を明示的に出力する必要があります。
 
@@ -247,7 +245,7 @@ symfony では、YAML のなかで PHP コードを記述することが可能
 すべての例
 ----------
 
-次の例は、このドキュメントで説明したほとんどの YAML の構文を利用しています:
+次の例では、この章で述べたほとんどの YAML 構文を利用しています。
 
     [yml]
     "symfony 1.0":