Merge pull request #5707 from softark/docs-ja-2014-10-23

docs/guide-ja/intro-upgrade-from-v1.md

@@ -3,9 +3,9 @@
 
 Yii フレームワークは 2.0 のために完全に書き直されたため、バージョン 1.1 と 2.0 の間には数多くの違いがあります。
 結果として、バージョン 1.1 からのアップグレードは、マイナーバージョン間でのアップグレードのような些細な問題ではなくなりました。
-この章では、二つのバージョン間の主要な違いを説明します。
+この節では、二つのバージョン間の主要な違いを説明します。
 
-もし以前に Yii 1.1 を使ったことがなければ、あなたはこの章を飛ばして直接に "[始めよう](start-installation.md)" に進んでも大丈夫です。
+もし以前に Yii 1.1 を使ったことがなければ、あなたはこの節を飛ばして直接に "[始めよう](start-installation.md)" に進んでも大丈夫です。
 
 Yii 2.0 は、この要約でカバーされているよりも多くの新機能を導入していることに注意してください。
 公式ガイド全体を通読して全ての新機能について学習することを強く推奨します。
@@ -17,9 +17,9 @@ Yii 2.0 縺ｯ縲√％縺ｮ隕∫ｴ〒繧ｫ繝舌縺輔ｌ縺ｦ縺ｋ繧医ｊ繧ょ､壹￥縺ｮ譁ｰ讖溯
 
 Yii 2.0 は、事実上の標準的 PHP パッケージ管理ソフトである [Composer](https://getcomposer.org/) を全面的に採用しています。
 コアフレームワークも、エクステンションも、インストールは Composer を通じて処理されます。
-[Yii をインストールする](start-installation.md) の章を参照して、Yii 2.0 をインストールする方法を学習してください。
+[Yii をインストールする](start-installation.md) の節を参照して、Yii 2.0 をインストールする方法を学習してください。
 新しいエクステンションを作成したい場合、または既存の 1.1 エクステンションを 2.0 互換のエクステンションに変換したい場合は、
-ガイドの [エクステンションを作成する](structure-extensions.md#creating-extensions) の章を参照してください。
+ガイドの [エクステンションを作成する](structure-extensions.md#creating-extensions) の節を参照してください。
 
 
 PHP の必要条件
@@ -102,7 +102,7 @@ $object = Yii::createObject([
 ], [$param1, $param2]);
 ```
 
-設定に関する更なる詳細は、[オブジェクトの設定](concept-configurations.md) の章で見ることが出来ます。
+設定に関する更なる詳細は、[オブジェクトの設定](concept-configurations.md) の節で見ることが出来ます。
 
 
 イベント
@@ -125,7 +125,7 @@ $component->on($eventName, $handler);
 // $component->off($eventName, $handler);
 ```
 
-イベント関連の機能には数多くの改良がなされました。更なる詳細は [イベント](concept-events.md) の章を参照してください。
+イベント関連の機能には数多くの改良がなされました。更なる詳細は [イベント](concept-events.md) の節を参照してください。
 
 
 パスエイリアス
@@ -143,7 +143,7 @@ Yii 2.0 縺ｯ縲√ヱ繧ｹ繧ｨ繧､繝ｪ繧｢繧ｹ縺ｮ菴ｿ逕ｨ繧偵√ヵ繧｡繧､繝ｫ/繝ぅ繝ｬ繧ｯ繝医
 サードパーティのライブラリ、例えば Zend フレームワークなどを使う場合には、そのフレームワークのインストールディレクトリを指す `@Zend` というパスエイリアスを定義することが出来ます。
 一旦そうしてしまえば、その Zend フレームワークのライブラリ中のどんなクラスでも、同じようにオートロードすることが出来るようになります。
 
-パスエイリアスに関する詳細は [パスエイリアス](concept-aliases.md) の章を参照してください。
+パスエイリアスに関する詳細は [パスエイリアス](concept-aliases.md) の節を参照してください。
 
 
 ビュー
@@ -165,7 +165,7 @@ echo $this->render('_item', ['item' => $item]);
 PHP を主たるテンプレート言語として使うのに加えて、Yii 2.0 は人気のある二つのテンプレートエンジン、Smarty と Twig に対する正式なサポートを備えています。
 Prado テンプレートエンジンはもうサポートされません。
 これらのテンプレートエンジンを使うためには、[[yii\base\View::$renderers|View::$renderers]] プロパティをセットして、`view` アプリケーションコンポーネントを設定する必要があります。
-詳細は [テンプレートエンジン](tutorial-template-engines.md) の章を参照してください。
+詳細は [テンプレートエンジン](tutorial-template-engines.md) の節を参照してください。
 
 
 モデル
@@ -199,7 +199,7 @@ public function scenarios()
 
 ほとんどの場合、[[yii\base\Model::rules()|rules()]] メソッドが存在し得るシナリオを十全に記述することが出来るなら、そして `unsafe` な属性を宣言する必要が無いなら、[[yii\base\Model::scenarios()|scenarios()]] をオーバーライドする必要はありません。
 
-モデルについてさらに詳細を学習するために、[モデル](structure-models.md) の章を参照してください。
+モデルについてさらに詳細を学習するために、[モデル](structure-models.md) の節を参照してください。
 
 
 コントローラ
@@ -223,7 +223,7 @@ public function actionView($id)
 }
 ```
 
-コントローラに関する更なる詳細については [コントローラ](structure-controllers.md) の章を参照してください。
+コントローラに関する更なる詳細については [コントローラ](structure-controllers.md) の節を参照してください。
 
 
 ウィジェット
@@ -250,7 +250,7 @@ $form = ActiveForm::begin([
 ActiveForm::end();
 ```
 
-更なる詳細については [ウィジェット](structure-widgets.md) の章を参照してください。
+更なる詳細については [ウィジェット](structure-widgets.md) の節を参照してください。
 
 
 テーマ
@@ -266,7 +266,7 @@ ActiveForm::end();
 また、`CThemeManager` コンポーネントはもうありません。
 その代りに、`theme` は `view` アプリケーションコンポーネントの設定可能なプロパティになりました。
 
-更なる詳細については [テーマ](output-theming.md) の章を参照してください。
+更なる詳細については [テーマ](output-theming.md) の節を参照してください。
 
 
 コンソールアプリケーション
@@ -282,7 +282,7 @@ ActiveForm::end();
 
 Yii 2.0 はコメントブロックからコマンドのヘルプ情報を自動的に生成する機能をサポートしています。
 
-更なる詳細については [コンソールコマンド](tutorial-console.md) の章を参照してください。
+更なる詳細については [コンソールコマンド](tutorial-console.md) の節を参照してください。
 
 
 国際化
@@ -293,7 +293,7 @@ Yii 2.0 縺ｯ [PECL intl PHP 繝｢繧ｸ繝･繝ｼ繝ｫ](http://pecl.php.net/package/intl) 縺
 メッセージは `i18n` アプリケーションコンポーネント経由で翻訳されるようになりました。
 このコンポーネントはメッセージソースのセットを管理するもので、メッセージのカテゴリに基づいて異なるメッセージソースを使うことを許容します。
 
-更なる詳細については [国際化](tutorial-i18n.md) の章を参照してください。
+更なる詳細については [国際化](tutorial-i18n.md) の節を参照してください。
 
 
 アクションフィルター
@@ -318,7 +318,7 @@ public function behaviors()
 }
 ```
 
-更なる詳細については [フィルター](structure-filters.md) の章を参照してください。
+更なる詳細については [フィルター](structure-filters.md) の節を参照してください。
 
 
 アセット
@@ -331,7 +331,7 @@ Yii 2.0 縺ｯ縲*繧｢繧ｻ繝ヨ繝舌Φ繝峨Ν* 縺ｨ蜻ｼ縺ｰ繧後ｋ譁ｰ縺励＞讎ょｿｵ繧貞ｰ主
 アセットバンドルを [[yii\web\AssetBundle::register()]] を通じて登録することによって、そのバンドルに含まれるアセットにウェブでアクセスできるようになります。
 Yii 1 とは異なり、バンドルを登録したページは、そのバンドルで規定された JavaScript と CSS ファイルを自動的に参照するようになります。
 
-更なる詳細については [アセットを管理する](structure-assets.md) の章を参照してください。
+更なる詳細については [アセットを管理する](structure-assets.md) の節を参照してください。
 
 
 ヘルパー
@@ -345,7 +345,7 @@ Yii 2.0 縺ｯ繧医￥菴ｿ繧上ｌ繧九せ繧ｿ繝ぅ繝け縺ｪ繝倥Ν繝代繧ｯ繝ｩ繧ｹ繧呈焚螟
 * [[yii\helpers\FileHelper]]
 * [[yii\helpers\Json]]
 
-更なる詳細については [ヘルパー概要](helper-overview.md) の章を参照してください。
+更なる詳細については [ヘルパー概要](helper-overview.md) の節を参照してください。
 
 
 フォーム
@@ -366,7 +366,7 @@ Yii 2.0 縺ｯ [[yii\widgets\ActiveForm]] 繧剃ｽｿ縺｣縺ｦ繝輔か繝ｼ繝繧剃ｽ懈縺吶ｋ髫
 <?php yii\widgets\ActiveForm::end(); ?>
 ```
 
-更なる詳細については [フォームを作成する](input-forms.md) の章を参照してください。
+更なる詳細については [フォームを作成する](input-forms.md) の節を参照してください。
 
 
 クエリビルダ
@@ -390,7 +390,7 @@ $rows = $command->queryAll();
 
 何より良いのは、このようなクエリ構築メソッドが [Active Record](db-active-record.md) を扱う時にも使える、ということです。
 
-更なる詳細については [クエリビルダ](db-query-builder.md) の章を参照してください。
+更なる詳細については [クエリビルダ](db-query-builder.md) の節を参照してください。
 
 
 アクティブレコード
@@ -462,7 +462,7 @@ public function init()
 コンストラクタにパラメータを追加する場合は、[[yii\db\ActiveRecord::instantiate()]] をオーバーライドする必要があるかもしれないことに注意してください。
 
 アクティブレコードについては、他にも多くの変更と機能強化がなされています。
-詳細については [アクティブレコード](db-active-record.md) の章を参照してください。
+詳細については [アクティブレコード](db-active-record.md) の節を参照してください。
 
 
 アクティブレコードのビヘイビア
@@ -504,7 +504,7 @@ User 縺ｨ IdentityInterface
 そして `CUserIdentity` クラスはもうありません。代りに、使い方がもっと単純な [[yii\web\IdentityInterface]] を実装すべきです。
 アドバンストアプリケーションテンプレートがそういう例を提供しています。
 
-更なる詳細は [認証](security-authentication.md)、[権限](security-authorization.md)、そして [高度なアプリケーションのテクニック](tutorial-advanced-app.md) の章を参照してください。
+更なる詳細は [認証](security-authentication.md)、[権限](security-authorization.md)、そして [高度なアプリケーションのテクニック](tutorial-advanced-app.md) の節を参照してください。
 
 
 URL 管理
@@ -523,12 +523,12 @@ Yii 2 縺ｮ URL 邂｡逅 1.1 縺ｮ縺昴ｌ縺ｨ莨ｼ縺溘ｈ縺↑繧ゅ縺ｧ縺吶
 ]
 ```
 
-更なる詳細については [URL 管理](runtime-url-handling.md) の章を参照してください。
+更なる詳細については [URL 管理](runtime-url-handling.md) の節を参照してください。
 
 
 Yii 1.1 と 2.x を一緒に使う
 ---------------------------
 
 Yii 2.0 と一緒に使いたい Yii 1.1 のレガシーコードを持っている場合は、
-[Yii 1.1 と 2.x を一緒に使う](tutorial-yii-integration.md) の章を参照してください。
+[Yii 1.1 と 2.x を一緒に使う](tutorial-yii-integration.md) の節を参照してください。
 

docs/guide-ja/start-forms.md

+フォームを扱う
+==============
+
+この節では、ユーザからデータを取得するフォームを持つ新しいページを作る方法を説明します。
+このページは名前の入力フィールドとメールの入力フィールドを持つフォームを表示します。
+ユーザからこれら二つの情報を受け取った後、ページは確認のために入力された値をエコーバックします。
+
+この目的を達するために、一つの [アクション](structure-controllers.md) と 二つの [ビュー](structure-views.md) を作成する以外に、
+一つの [モデル](structure-models.md) をも作成します。
+
+このチュートリアルを通じて、次のことを学びます:
+
+* フォームを通じてユーザが入力したデータを表す [モデル](structure-models.md) を作成する方法
+* 入力されたデータを検証する規則を宣言する方法
+* [ビュー](structure-views.md) の中で HTML フォームを構築する方法
+
+
+モデルを作成する<a name="creating-model"></a>
+----------------
+
+ユーザからの入力を要求するデータは下に示されているように `EntryForm` モデルクラスとして表現され、`models/EntryForm.php` というファイルに保存されます。
+クラスファイルの命名規約についての詳細は [クラスのオートロード](concept-autoloading.md) の節を参照してください。
+
+```php
+<?php
+
+namespace app\models;
+
+use yii\base\Model;
+
+class EntryForm extends Model
+{
+    public $name;
+    public $email;
+
+    public function rules()
+    {
+        return [
+            [['name', 'email'], 'required'],
+            ['email', 'email'],
+        ];
+    }
+}
+```
+
+このクラスは、Yii によって提供される基底クラス [[yii\base\Model]] を拡張するものです。
+通常、この基底クラスがフォームデータを表現するのに使われます。
+
+> Info|情報: [[yii\base\Model]] はデータベーステーブルと関連*しない*モデルクラスの親として使われます。
+データベーステーブルと対応するモデルクラスでは、通常は [[yii\db\ActiveRecord]] が親になります。
+
+`EntryForm` クラスは二つのパブリックメンバー、`name` と `email` を持っており、これらがユーザによって入力されたデータを保管するのに使われます。
+このクラスはまた `rules()` という名前のメソッドを持っています。このメソッドがデータを検証する一連の規則を返します。
+上記で宣言されている検証規則は次のことを述べています:
+
+* `name` と `email` は、ともに値を要求される
+* `email` のデータは構文的に正当なメールアドレスでなければならない
+
+`EntryForm` オブジェクトにユーザが入力したデータを投入した後、[[yii\base\Model::validate()|validate()]] を呼んでデータ検証ルーチンを始動することが出来ます。
+データ検証が失敗すると [[yii\base\Model::hasErrors|hasErrors]] プロパティが true に設定され、
+そして、[[yii\base\Model::getErrors|errors]] を通じて、どのような検証エラーが発生したかを知ることが出来ます。
+
+
+```php
+<?php
+$model = new EntryForm();
+$model->name = 'Qiang';
+$model->email = 'bad';
+if ($model->validate()) {
+    // 良し!
+} else {
+    // 失敗!
+    // $model->getErrors() を使う
+}
+```
+
+
+アクションを作成する<a name="creating-action"></a>
+--------------------
+
+次に、この新しいモデルを使う `entry` アクションを `site` コントローラに作る必要があります。
+アクションを作成して使うプロセスについては、すでに [「こんにちは」と言う](start-hello.md) の節で説明されました。
+
+```php
+<?php
+
+namespace app\controllers;
+
+use Yii;
+use yii\web\Controller;
+use app\models\EntryForm;
+
+class SiteController extends Controller
+{
+    // ... 既存のコード ...
+
+    public function actionEntry()
+    {
+        $model = new EntryForm;
+
+        if ($model->load(Yii::$app->request->post()) && $model->validate()) {
+            // $model に受け取ったデータを検証する
+
+            // ここで $model について意味のあることを何かする ...
+
+            return $this->render('entry-confirm', ['model' => $model]);
+        } else {
+            // ページの初期表示か、または、何か検証エラーがある
+            return $this->render('entry', ['model' => $model]);
+        }
+    }
+}
+```
+
+アクションは最初に `EntryForm` オブジェクトを生成します。そして、次に、モデルに `$_POST` のデータ、
+Yii においては [[yii\web\Request::post()]] によって提供されるデータを投入しようと試みます。
+モデルへのデータ投入が成功した場合（つまり、ユーザが HTML フォームを送信した場合)、アクションは
+[[yii\base\Model::validate()|validate()]] を呼んで、入力された値が有効なものであることを確認します。
+
+> Info|情報: `Yii::$app` という式は [アプリケーション](structure-applications.md) インスタンスを表現します。
+  これはグローバルにアクセス可能なシングルトンです。これは、また、特定の機能性をサポートする `request`、
+  `response`, `db` などのコンポーネントを提供する [サービスロケータ](concept-service-locator.md) でもあります。
+  上記のコードでは、アプリケーションインスタンスの`request` コンポーネントが `$_POST` データにアクセスするために使われています。
+
+すべてが適正である場合、アクションは `entry-confirm` という名前のビューを表示して、データの送信が成功したことをユーザに確認させます。
+データが送信されなかったり、データがエラーを含んでいたりする場合は、`entry` ビューが表示され、その中で HTML フォームが
+（もし有れば）検証エラーのメッセージとともに表示されます。
+
+> Note|注意: この簡単な例では、有効なデータ送信に対して単純に確認ページを表示しています。実際の仕事では、
+  [フォーム送信の諸問題](http://en.wikipedia.org/wiki/Post/Redirect/Get) を避けるために、
+  [[yii\web\Controller::refresh()|refresh()]] または [[yii\web\Controller::redirect()|redirect()]] を使うことを考慮すべきです。
+
+
+ビューを作成する<a name="creating-views"></a>
+----------------
+
+最後に、`entry-confirm` と `entry` と言う名前の二つのビューファイルを作成します。
+今まさに説明したように、これらが `entry` アクションによって表示されます。
+
+`entry-confirm` ビューは単純に名前とメールのデータを表示するものです。このビューは `views/site/entry-confirm.php` というファイルに保存しなければなりません。
+
+```php
+<?php
+use yii\helpers\Html;
+?>
+<p>あなたは次の情報を入力しました:</p>
+
+<ul>
+    <li><label>名前</label>: <?= Html::encode($model->name) ?></li>
+    <li><label>メール</label>: <?= Html::encode($model->email) ?></li>
+</ul>
+```
+
+`entry` ビューは HTML フォームを表示します。これは `views/site/entry.php` というファイルに保存しなければなりません。
+
+```php
+<?php
+use yii\helpers\Html;
+use yii\widgets\ActiveForm;
+?>
+<?php $form = ActiveForm::begin(); ?>
+
+    <?= $form->field($model, 'name') ?>
+
+    <?= $form->field($model, 'email') ?>
+
+    <div class="form-group">
+        <?= Html::submitButton('送信', ['class' => 'btn btn-primary']) ?>
+    </div>
+
+<?php ActiveForm::end(); ?>
+```
+
+このビューは HTML フォームを構築するのに、[[yii\widgets\ActiveForm|ActiveForm]] と呼ばれる強力な [ウィジェット](structure-widgets.md) を使います。
+ウィジェットの `begin()` メソッドと `end()` メソッドが、それぞれ、フォームの開始タグと終了タグを表示します。
+この二つのメソッドの呼び出しの間に、[[yii\widgets\ActiveForm::field()|field()]] メソッドによって入力フィールドが作成されます。
+最初の入力フィールドは "name" のデータ、第二の入力フィールドは "email" のデータのためのものです。
+入力フィールドの後に、[[yii\helpers\Html::submitButton()]] メソッドが呼ばれて、送信ボタンを生成しています。
+
+
+試してみる<a name="trying-it-out"></a>
+----------
+
+どのように動作するかを見るために、ブラウザで下記の URL をアクセスしてください:
+
+```
+http://hostname/index.php?r=site/entry
+```
+
+二つの入力フィールドを持つフォームを表示するページが表示されるでしょう。
+それぞれの入力フィールドの前には、どんなデータを入力すべきかを示すラベルがあります。
+何も入力せずに、あるいは、無効なメールアドレスを入力して送信ボタンをクリックすると、
+それぞれ問題のある入力フィールドの続きにエラーメッセージが表示されます。
+
+![検証エラーのあるフォーム](images/start-form-validation.png)
+
+有効な名前とメールアドレスを入力してから送信ボタンをクリックすると、たった今入力したデータを表示する新しいページが表示されます。
+
+![データ入力の確認](images/start-entry-confirmation.png)
+
+
+### 魔法の説明<a name="magic-explained"></a>
+
+あなたは、舞台裏で HTML フォームがどのように動いているのか、不思議に思うかも知れません。なぜなら、
+フォームが、ほとんど魔法のように、各入力フィールドのラベルを表示し、データを正しく入力しない場合には
+ページをリロードすることなくエラーメッセージを表示するからです。
+
+そう、データの検証は、最初に JavaScript を使ってクライアントサイドで実行され、次に PHP によってサーバーサイドで実行されます。
+[[yii\widgets\ActiveForm]] は、賢いことに、`EntryForm` で宣言した検証規則を抽出し、それを実行可能な JavaScript コードに変換して、
+JavaScript を使ってデータ検証を実行します。
+ブラウザで JavaScript を無効にした場合でも、`actionEntry()` メソッドで示されているように、サーバーサイドでの検証は実行されます。
+これにより、どのような状況であっても、データの有効性が保証されます。
+
+> Warning|警告: クライアントサイドの検証は、ユーザにとってのより良い使い心地のために利便性を提供するものです。
+  クライアントサイドの検証の有無にかかわらず、サーバサードの検証は常に必要とされます。
+
+入力フィールドのラベルは、モデルのプロパティ名を使用して、`field()` メソッドによって生成されます。
+例えば、`name` というプロパティから `Name` というラベルが生成されます。
+
+ビューの中で、下記のコードのように、ラベルをカスタマイズすることも出来ます:
+
+```php
+<?= $form->field($model, 'name')->label('お名前') ?>
+<?= $form->field($model, 'email')->label('メールアドレス') ?>
+```
+
+> Info|情報: Yii はこのようなウィジェットを数多く提供して、複雑で動的なビューを素速く作成することを手助けしてくれます。
+  後で学ぶように、新しいウィジェットを書くことも非常に簡単です。
+  あなたは、将来のビュー開発を単純化するために、多くのビューコードを再利用可能なウィジェットに変換したいと思うことでしょう。
+
+
+まとめ<a name="summary"></a>
+------
+
+ガイドのこの節においては、MVC デザインパターンの全ての部分に触れました。
+そして、ユーザデータを表現し、当該データを検証するモデルクラスを作成する方法を学びました。
+
+また、ユーザからデータを取得する方法と、ブラウザにデータを表示して返す方法も学びました。
+この作業は、アプリケーションを開発するときに、多大な時間を必要とするものになり得るものです。
+しかし、Yii はこの作業を非常に容易にする強力なウィジェットを提供しています。
+
+次の節では、ほとんど全てのアプリケーションで必要とされるデータベースを取り扱う方法を学びます。

docs/guide-ja/start-hello.md

 「こんにちは」と言う
 ====================
 
-この章では、アプリケーションに新しい「こんにちは」というページを作成する方法を説明します。
+この節では、アプリケーションに新しい「こんにちは」というページを作成する方法を説明します。
 この目的を達するために、[アクション](structure-controllers.md#creating-actions) と [ビュー](structure-views.md) を作成することになります:
 
 * アプリケーションがこのページへのリクエストをそのアクションに送致(dispatch)し、
@@ -25,7 +25,7 @@
   アクションの実行結果が、エンドユーザが受け取るレスポンスです。
 
 アクションは [コントローラ](structure-controllers.md) の中で宣言されなければなりません。
-話を簡単にするために、`say` アクションを既存の `SiteController` の中で宣言しても構いません。
+話を簡単にするために、`say` アクションを既存の `SiteController` の中で宣言しましょう。
 このコントローラは `controllers/SiteController.php` というクラスファイルの中で定義されています。
 次のようにして、新しいアクションを書き始めます:
 
@@ -133,11 +133,11 @@ URL から `message` パラメータを省略すると、"Hello" だけを表示
 まとめ<a name="summary"></a>
 ------
 
-この章では、MVC デザインパターンのうちのコントローラとビューの部分に触れました。
+この節では、MVC デザインパターンのうちのコントローラとビューの部分に触れました。
 特定のリクエストを処理するためのアクションをコントローラの一部として作成しました。
 また、レスポンスのコンテンツを構成するためにビューも作成しました。
 この単純な例においては、使用される唯一のデータが `message` パラメータであったため、モデルは関係してきませんでした。
 
 また、Yii におけるルートについても学びました。ルートはユーザのリクエストとコントローラのアクションとの橋渡しとして働くものです。
 
-次の章では、モデルを作成する方法を学び、そして、HTML フォームを含むページを追加します。
+次の節では、モデルを作成する方法を学び、そして、HTML フォームを含むページを追加します。

docs/guide-ja/start-installation.md

@@ -40,7 +40,7 @@ Composer 縺後う繝ｳ繧ｹ繝医繝ｫ縺輔ｌ縺溘ｉ縲√え繧ｧ繝悶°繧峨い繧ｯ繧ｻ繧ｹ縺ｧ縺阪
 > Github にログインすると API の帯域制限が緩和され、Composer が仕事を続けることが出来るようになります。
 > 更なる詳細については、[Composer documentation](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens) を参照してください。
 
-> Tip: Yii の最新の開発バージョンをインストールしたい場合は、[stability option](https://getcomposer.org/doc/04-schema.md#minimum-stability) を追加した次のコマンドを代りに使うことが出来ます:
+> Tip|ヒント: Yii の最新の開発バージョンをインストールしたい場合は、[stability option](https://getcomposer.org/doc/04-schema.md#minimum-stability) を追加した次のコマンドを代りに使うことが出来ます:
 >
 >     composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
 >
@@ -112,7 +112,7 @@ Yii 縺ｮ譛菴主ｿｦ∵擅莉ｶ繧呈ｺ縺溘☆繧医≧縺ｫ PHP 縺ｮ繧､繝ｳ繧ｹ繝医繝ｫ繧呈ｧ区
 ウェブサーバを設定する<a name="configuring-web-servers"></a>
 ----------------------
 
-> Info|情報: もし Yii の試運転をしているだけで、実運用のサーバに配置する意図がないのであれば、当面、この節は飛ばしても構いません。
+> Info|情報: もし Yii の試運転をしているだけで、実運用のサーバに配置する意図がないのであれば、当面、この項は飛ばしても構いません。
 
 上記の説明に従ってインストールされたアプリケーションは、[Apache HTTP サーバ](http://httpd.apache.org/) と [Nginx HTTP サーバ](http://nginx.org/) のどちらでも、また、Windows、Mac OS X、Linux のどれでも、PHP 5.4 以上を走らせている環境であれば、そのままの状態で動作するはずです。
 Yii 2.0 は、また、facebook の [HHVM](http://hhvm.com/) とも互換性があります。
@@ -128,7 +128,7 @@ Yii 2.0 縺ｯ縲√∪縺溘’acebook 縺ｮ [HHVM](http://hhvm.com/) 縺ｨ繧ゆｺ呈鋤諤ｧ縺後
 
 > Info|情報: ウェブサーバの設定を修正する権限のない共用ホスティング環境でアプリケーションが走る場合でも、
 セキュリティ強化のためにアプリケーションの構造を調整することが出来ます。
-更なる詳細については、[共有ホスティング環境](tutorial-shared-hosting.md) の章を参照してください。
+更なる詳細については、[共有ホスティング環境](tutorial-shared-hosting.md) の節を参照してください。
 
 
 ### 推奨される Apache の設定<a name="recommended-apache-configuration"></a>

docs/guide-ja/start-workflow.md

@@ -3,7 +3,7 @@
 
 Yii のインストールが終ると、実際に動く Yii のアプリケーションにアクセスすることが出来るようになります。
 その URL は、`http://hostname/basic/web/index.php` あるいは `http://hostname/index.php` など、設定によつて異なります。
-この章では、アプリケーションに組み込み済みの機能を紹介し、コードがどのように組織されているか、
+この節では、アプリケーションに組み込み済みの機能を紹介し、コードがどのように組織されているか、
 そして、一般にアプリケーションがリクエストをどのように処理するかを説明します。
 
 > Info|情報: 話を簡単にするために、この「始めよう」のチュートリアルを通じて、

docs/internals-ja/translation-workflow.md

@@ -26,7 +26,7 @@ Yii は国際的なアプリケーションと開発者にとって役に立つ
 値が空白の場合は、メッセージは翻訳されないものと見なされます。
 翻訳が不要になったメッセージは、翻訳が一組の '@@' マークで囲まれます。
 メッセージ文字列は複数形書式とともに使うことが出来ます。
-詳細は [ガイドの国際化の章](../guide-ja/tutorial-i18n.md) を参照してください。
+詳細はガイドの [国際化](../guide-ja/tutorial-i18n.md) の節を参照してください。
 
 ドキュメンテーション
 --------------------