Merge pull request #6292 from softark/docs-guide-ja-intro-revised

Docs guide ja intro revised　[ci skip]

Merge pull request #6292 from softark/docs-guide-ja-intro-revised
8721e357 · Alexander Makarov · 8fb4ce5d · 7da5ddde · 8721e357 · 8721e357
Commit 8721e357 authored Nov 28, 2014 by Alexander Makarov
7 changed files
--- a/docs/guide-ja/README.md
+++ b/docs/guide-ja/README.md
-Yii 2.0 公式ガイド
+決定版 Yii 2.0 ガイド
-==================
+=====================
-このチュートリアルは [Yii ドキュメント規約](http://www.yiiframework.com/doc/terms/) の下に
+このチュートリアルは [Yii ドキュメント規約](http://www.yiiframework.com/doc/terms/) の下にリリースされています。
-リリースされています。
 All Rights Reserved.
@@ -65,11 +64,11 @@ All Rights Reserved.
 * [プロパティ](concept-properties.md)
 * [イベント](concept-events.md)
 * [ビヘイビア](concept-behaviors.md)
-* [コンフィギュレーション](concept-configurations.md)
+* [構成情報](concept-configurations.md)
 * [エイリアス](concept-aliases.md)
 * [クラスのオートロード](concept-autoloading.md)
 * [サービスロケータ](concept-service-locator.md)
-* [依存性注入コンテナ](concept-di-container.md)
+* [依存注入コンテナ](concept-di-container.md)
 データベースの取り扱い
@@ -102,8 +101,8 @@ All Rights Reserved.
 * **TBD** [並べ替え](output-sorting.md)
 * [データプロバイダ](output-data-providers.md)
 * [データウィジェット](output-data-widgets.md)
-* [クライアントスクリプトを使う](output-client-scripts.md)
+* [クライアントスクリプトを扱う](output-client-scripts.md)
-* [テーマを使う](output-theming.md)
+* [テーマ](output-theming.md)
 セキュリティ
@@ -169,7 +168,7 @@ RESTful ウェブサービス
 * [国際化](tutorial-i18n.md)
 * [メール](tutorial-mailing.md)
 * [パフォーマンスチューニング](tutorial-performance-tuning.md)
-* **TBD** [共有ホスト環境](tutorial-shared-hosting.md)
+* [共有ホスト環境](tutorial-shared-hosting.md)
 * [テンプレートエンジン](tutorial-template-engines.md)
 * [サードパーティのコードを扱う](tutorial-yii-integration.md)
@@ -177,14 +176,14 @@ RESTful ウェブサービス
 ウィジェット
 ------------
-* GridView: link to demo page
+* GridView: **TBD** link to demo page
-* ListView: link to demo page
+* ListView: **TBD** link to demo page
-* DetailView: link to demo page
+* DetailView: **TBD** link to demo page
-* ActiveForm: link to demo page
+* ActiveForm: **TBD** link to demo page
-* Pjax: link to demo page
+* Pjax: **TBD** link to demo page
-* Menu: link to demo page
+* Menu: **TBD** link to demo page
-* LinkPager: link to demo page
+* LinkPager: **TBD** link to demo page
-* LinkSorter: link to demo page
+* LinkSorter: **TBD** link to demo page
 * [Bootstrap ウィジェット](widget-bootstrap.md)
 * [Jquery UI ウィジェット](widget-jui.md)

--- a/docs/guide-ja/images/application-lifecycle.graphml
+++ b/docs/guide-ja/images/application-lifecycle.graphml
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <graphml xmlns="http://graphml.graphdrawing.org/xmlns" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:y="http://www.yworks.com/xml/graphml" xmlns:yed="http://www.yworks.com/xml/yed/3" xsi:schemaLocation="http://graphml.graphdrawing.org/xmlns http://www.yworks.com/xml/schema/graphml/1.1/ygraphml.xsd">
  <!--Created by yEd 3.13-->
-  <key for="graphml" id="d0" yfiles.type="resources"/>
+  <key attr.name="Description" attr.type="string" for="graph" id="d0"/>
  <key for="port" id="d1" yfiles.type="portgraphics"/>
  <key for="port" id="d2" yfiles.type="portgeometry"/>
  <key for="port" id="d3" yfiles.type="portuserdata"/>
  <key attr.name="url" attr.type="string" for="node" id="d4"/>
  <key attr.name="description" attr.type="string" for="node" id="d5"/>
  <key for="node" id="d6" yfiles.type="nodegraphics"/>
-  <key attr.name="Description" attr.type="string" for="graph" id="d7"/>
+  <key for="graphml" id="d7" yfiles.type="resources"/>
  <key attr.name="url" attr.type="string" for="edge" id="d8"/>
  <key attr.name="description" attr.type="string" for="edge" id="d9"/>
  <key for="edge" id="d10" yfiles.type="edgegraphics"/>
  <graph edgedefault="directed" id="G">
-    <data key="d7"/>
+    <data key="d0"/>
    <node id="n0" yfiles.foldertype="group">
      <data key="d4"/>
      <data key="d6">
@@ -49,7 +49,7 @@
              <y:Geometry height="30.0" width="324.9258883570935" x="-1249.511914911339" y="-169.79793039957679"/>
              <y:Fill color="#FFFFFF" transparent="false"/>
              <y:BorderStyle color="#000000" type="line" width="1.0"/>
-              <y:NodeLabel alignment="center" autoSizePolicy="content" fontFamily="Dialog" fontSize="12" fontStyle="plain" hasBackgroundColor="false" hasLineColor="false" height="18.701171875" modelName="custom" textColor="#000000" visible="true" width="292.0" x="16.46294417854665" y="5.6494140625">アプリケーションのコンフィギュレーションをロード<y:LabelModel>
+              <y:NodeLabel alignment="center" autoSizePolicy="content" fontFamily="Dialog" fontSize="12" fontStyle="plain" hasBackgroundColor="false" hasLineColor="false" height="18.701171875" modelName="custom" textColor="#000000" visible="true" width="208.0" x="58.46294417854665" y="5.6494140625">アプリケーションの構成情報をロード<y:LabelModel>
                  <y:SmartNodeLabelModel distance="4.0"/>
                </y:LabelModel>
                <y:ModelParameter>
@@ -375,8 +375,7 @@
          <y:Path sx="0.0" sy="0.0" tx="0.0" ty="0.0"/>
          <y:LineStyle color="#666666" type="line" width="2.0"/>
          <y:Arrows source="none" target="standard"/>
-          <y:EdgeLabel alignment="center" backgroundColor="#99CCFF" configuration="AutoFlippingLabel" distance="2.0" fontFamily="Dialog" fontSize="12" fontStyle="plain" hasLineColor="false" height="33.40234375" modelName="custom" preferredPlacement="anywhere" ratio="0.5" textColor="#000000" visible="true" width="136.0" x="-145.73495249688403" y="70.83422851562506">コンフィギュレーション
+          <y:EdgeLabel alignment="center" backgroundColor="#99CCFF" configuration="AutoFlippingLabel" distance="2.0" fontFamily="Dialog" fontSize="12" fontStyle="plain" hasLineColor="false" height="18.701171875" modelName="custom" preferredPlacement="anywhere" ratio="0.5" textColor="#000000" visible="true" width="76.0" x="-115.73495249688426" y="78.18481445312506">構成情報配列<y:LabelModel>
-配列<y:LabelModel>
              <y:SmartEdgeLabelModel autoRotationEnabled="false" defaultAngle="0.0" defaultDistance="10.0"/>
            </y:LabelModel>
            <y:ModelParameter>
@@ -507,7 +506,7 @@
      </data>
    </edge>
  </graph>
-  <data key="d0">
+  <data key="d7">
    <y:Resources/>
  </data>
 </graphml>
--- a/docs/guide-ja/images/application-lifecycle.png
+++ b/docs/guide-ja/images/application-lifecycle.png
--- a/docs/guide-ja/images/request-lifecycle.graphml
+++ b/docs/guide-ja/images/request-lifecycle.graphml
 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <graphml xmlns="http://graphml.graphdrawing.org/xmlns" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:y="http://www.yworks.com/xml/graphml" xmlns:yed="http://www.yworks.com/xml/yed/3" xsi:schemaLocation="http://graphml.graphdrawing.org/xmlns http://www.yworks.com/xml/schema/graphml/1.1/ygraphml.xsd">
  <!--Created by yEd 3.13-->
-  <key for="graphml" id="d0" yfiles.type="resources"/>
+  <key attr.name="Description" attr.type="string" for="graph" id="d0"/>
  <key for="port" id="d1" yfiles.type="portgraphics"/>
  <key for="port" id="d2" yfiles.type="portgeometry"/>
  <key for="port" id="d3" yfiles.type="portuserdata"/>
  <key attr.name="url" attr.type="string" for="node" id="d4"/>
  <key attr.name="description" attr.type="string" for="node" id="d5"/>
  <key for="node" id="d6" yfiles.type="nodegraphics"/>
-  <key attr.name="Description" attr.type="string" for="graph" id="d7"/>
+  <key for="graphml" id="d7" yfiles.type="resources"/>
  <key attr.name="url" attr.type="string" for="edge" id="d8"/>
  <key attr.name="description" attr.type="string" for="edge" id="d9"/>
  <key for="edge" id="d10" yfiles.type="edgegraphics"/>
  <graph edgedefault="directed" id="G">
-    <data key="d7"/>
+    <data key="d0"/>
    <node id="n0">
      <data key="d6">
        <y:SVGNode>
@@ -370,7 +370,7 @@
              <y:Geometry height="30.0" width="169.93387606143483" x="307.6574954986572" y="262.00096702575684"/>
              <y:Fill color="#FFFFFF" transparent="false"/>
              <y:BorderStyle color="#000000" type="line" width="1.0"/>
-              <y:NodeLabel alignment="center" autoSizePolicy="content" fontFamily="Dialog" fontSize="12" fontStyle="plain" hasBackgroundColor="false" hasLineColor="false" height="18.701171875" modelName="custom" textColor="#000000" visible="true" width="160.0" x="4.966938030717415" y="5.6494140625">アプリのコンフィグをロード<y:LabelModel>
+              <y:NodeLabel alignment="center" autoSizePolicy="content" fontFamily="Dialog" fontSize="12" fontStyle="plain" hasBackgroundColor="false" hasLineColor="false" height="18.701171875" modelName="custom" textColor="#000000" visible="true" width="148.0" x="10.966938030717415" y="5.6494140625">アプリの構成情報をロード<y:LabelModel>
                  <y:SmartNodeLabelModel distance="4.0"/>
                </y:LabelModel>
                <y:ModelParameter>
@@ -650,7 +650,7 @@
      </data>
    </edge>
  </graph>
-  <data key="d0">
+  <data key="d7">
    <y:Resources>
      <y:Resource id="1">&lt;?xml version="1.0" encoding="utf-8"?&gt;
 &lt;svg version="1.1" id="Ebene_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"

--- a/docs/guide-ja/images/request-lifecycle.png
+++ b/docs/guide-ja/images/request-lifecycle.png
--- a/docs/guide-ja/intro-upgrade-from-v1.md
+++ b/docs/guide-ja/intro-upgrade-from-v1.md
--- a/docs/guide-ja/intro-yii.md
+++ b/docs/guide-ja/intro-yii.md
@@ -3,7 +3,7 @@ Yii とは何か
 Yii は現代的なウェブアプリケーションを迅速に開発するための、高性能な、コンポーネントベースの PHP フレームワークです。
 Yii という名前 (`イー` すなわち `[ji:]` と発音します) は、中国語では「易」であり、「シンプルかつ進化的」であることを意味します。
-また **Yes It Is** の省略形であると考えることも出来ます。
+また **Yes It Is** のアクロニム(頭字語)であると考えることも出来ます。
 Yii は何に向いているか
@@ -17,20 +17,20 @@ Yii は汎用的なウェブプログラミングフレームワークです。
 Yii を他のフレームワークと比べるとどうか?
 -----------------------------------------
-あなたが既に他のフレームワークに親しんでいる場合は、Yii を比較するとどうなるのかを知りたいと思うでしょう:
+あなたが既に他のフレームワークに親しんでいる場合は、Yii を比較するとどうなるのかを知りたいと思うでしょう。
- ほとんどの PHP フレームワーク同様、Yii は MVC (Model-View-Controller) デザインパターンを実装し、このパターンに基づいたコードの組織化を促進しています。
+- ほとんどの PHP フレームワーク同様、Yii は MVC (Model-View-Controller) デザインパターンを実装し、このパターンに基づいたコードの組織化を推進しています。
 - Yii は、コードはシンプルかつエレガントに書かれるべきである、という哲学を採用しています。
  Yii は、何らかのデザインパターンを厳密に守ることを主たる目的として大袈裟な設計をすることは、決してしようとしません。
- Yii は、検証済みで直ちに使える多数の機能を提供するフル装備のフレームワークです:
+- Yii は、検証済みで直ちに使える多数の機能を提供するフル装備のフレームワークです。
-  リレーショナルデータベースと NoSQL データベースの両方のためのクエリビルダとアクティブレコード; RESTful API 開発サポート; 多層構成のキャッシュサポート; その他諸々。
+  リレーショナルデータベースと NoSQL データベースの両方のためのクエリビルダとアクティブレコード、RESTful API 開発サポート、多層構成のキャッシュサポート、その他諸々。
 - Yii は極めて拡張性の高いフレームワークです。あなたはコアのコードのほとんど全ての要素をカスタマイズしたり置き換えたりすることが出来ます。
-また、Yii の堅固なエクステンションアーキテクチャを利用して、再配布可能なエクステンションを使用したり開発したりすることも出来ます。
+  また、Yii の堅固なエクステンションアーキテクチャを利用して、再配布可能なエクステンションを使用したり開発したりすることも出来ます。
- 高性能であることは常に Yii の主たる目的の一つです。
+- 高性能であることは常に Yii の主たる目標です。
-Yii は「独演会」ではありません。Yii は [強力なコア開発チーム][] および Yii 開発に間断なく貢献してくれるプロフェッショナルの大きなコミュニティーに支えられたプロジェクトです。
+Yii はワンマンショーではありません。Yii は [強力なコア開発チーム][] および Yii 開発に間断なく貢献してくれるプロフェッショナルの大きなコミュニティーに支えられたプロジェクトです。
 Yii 開発チームは最新のウェブ開発の潮流や、他のフレームワークやプロジェクトに見られる最善の慣行と機能から目を離しません。
-他のところで見られる関連性の高い最善の慣行と機能は定期的にコアフレームワークに組み込まれ、シンプルかつエレガントなインターフェイスを通じて公開されます。
+他のところで見出された関連性の高い最善の慣行と機能は、定期的にコアフレームワークに組み込まれ、シンプルかつエレガントなインターフェイスを通じて公開されます。
 [強力なコア開発チーム]: http://www.yiiframework.com/about/
@@ -40,7 +40,7 @@ Yii のバージョン
 Yii は現在、利用可能な二つのメジャーバージョン、すなわち 1.1 と 2.0 を持っています。
 バージョン 1.1 は古い世代のもので、現在はメンテナンスモードにあります。
 バージョン 2.0 は、最新のテクノロジーとプロトコル、例えば、Composer、PSR、名前空間、トレイトなどを採用して、Yii を完全に書き直したものです。
-バージョン 2.0 がこのフレームワークの現在の世代を表すものであり、今後数年間にわたって主要な開発努力の対象となるものです。
+バージョン 2.0 がこのフレームワークの現世代を表すものであり、今後数年間にわたって主要な開発努力の対象となるものです。
 このガイドは主としてバージョン 2.0 について述べます。
@@ -48,9 +48,10 @@ Yii は現在、利用可能な二つのメジャーバージョン、すなわ
 ------------------
 Yii 2.0 は PHP 5.4.0 以上を必要とします。
-個別の機能に対するさらに詳細な必要条件は、全ての Yii リリースに含まれている必要条件チェッカーを走らせることによって知ることが出来ます。
+個別の機能に対する詳細な必要条件は、全ての Yii リリースに含まれている必要条件チェッカを走らせることによって知ることが出来ます。
-Yii は純粋なオブジェクト指向のフレームワークですので、Yii を使うためにはオブジェクト指向プログラミング (OOP) の基本的な知識が必要とされます。
+Yii を使うためには、オブジェクト指向プログラミング (OOP) の基本的な知識が必要です。
+なぜなら、Yii は純粋な OOP ベースのフレームワークだからです。
 また、Yii 2.0 は [名前空間](http://php.net/manual/ja/language.namespaces.php) や [トレイト](http://php.net/manual/ja/language.oop5.traits.php) のような PHP の最新の機能を利用しています。
 これらの概念を理解することは、Yii 2.0 を採用することをより一層容易にするでしょう。