From 218de429371b00e5170abebb8d5e763f8fd7319e Mon Sep 17 00:00:00 2001 From: Nobuo Kihara <softark@gmail.com> Date: Sun, 2 Nov 2014 15:29:37 +0900 Subject: [PATCH] docs/guide-ja/intro-*, docs/guide-ja/start-* minor changes [ci skip] --- docs/guide-ja/intro-upgrade-from-v1.md | 14 +++++++------- docs/guide-ja/start-databases.md | 2 +- docs/guide-ja/start-gii.md | 2 +- docs/guide-ja/start-hello.md | 16 ++++++++-------- docs/guide-ja/start-workflow.md | 2 +- 5 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/guide-ja/intro-upgrade-from-v1.md b/docs/guide-ja/intro-upgrade-from-v1.md index 79925d8..05c90af 100644 --- a/docs/guide-ja/intro-upgrade-from-v1.md +++ b/docs/guide-ja/intro-upgrade-from-v1.md @@ -176,8 +176,8 @@ Yii 2.0 は [[yii\base\Model]] を 1.1 における `CModel` と同様な基底� `CFormModel` というクラスは完全に廃止されました。 Yii 2 では、それの代りに、[yii\base\Model]] を拡張してフォームモデルクラスを作成すべきです。 -Yii 2.0 は シナリオを宣言するための [[yii\base\Model::scenarios()|scenarios()]] というメソッドを導入しました。 -このメソッドを使って、どのようなシナリオがサポートされるか、また、どのシナリオの下である属性が検証される必要があるか、安全とみなされるか否か、などを宣言します。 +Yii 2.0 は サポートされるシナリオを宣言するための [[yii\base\Model::scenarios()|scenarios()]] というメソッドを導入しました。 +このメソッドを使って、あるシナリオの下で、どの属性が検証される必要があるか、また、どの属性が安全とみなされるか否か、などを宣言することが出来ます。 例えば: ```php @@ -193,12 +193,12 @@ public function scenarios() 上記では二つのシナリオが宣言されています: `backend` と `frontend` です。 `backend` シナリオでは、`email` と `role` の属性が両方とも安全であり、一括代入が可能です。 `frontend` シナリオでは、`email` は一括代入が可能ですが、`role` は不可能です。 -`email` と `role` は、両方とも、ルールを使って検証されなければなりません。 +`email` と `role` は、両方とも、規則を使って検証されなければなりません。 -[[yii\base\Model::rules()|rules()]] メソッドが Yii 1.1 同様に検証ルールを宣言するために使われます。 +[[yii\base\Model::rules()|rules()]] メソッドが Yii 1.1 同様に検証規則を宣言するために使われます。 [[yii\base\Model::scenarios()|scenarios()]] が導入されたことにより、`unsafe` バリデータが無くなったことに注意してください。 -ほとんどの場合、[[yii\base\Model::rules()|rules()]] メソッドが存在し得るシナリオを十全に記述することが出来るなら、そして `unsafe` な属性を宣言する必要が無いなら、[[yii\base\Model::scenarios()|scenarios()]] をオーバーライドする必要はありません。 +ほとんどの場合、[[yii\base\Model::rules()|rules()]] メソッドが在り得るシナリオを十分に既定しているなら、そして `unsafe` な属性を宣言する必要が無いなら、[[yii\base\Model::scenarios()|scenarios()]] をオーバーライドする必要はありません。 モデルについてさらに詳細を学習するために、[モデル](structure-models.md) の節を参照してください。 @@ -389,7 +389,7 @@ $sql = $command->sql; $rows = $command->queryAll(); ``` -何より良いのは、このようなクエリ構築メソッドが [Active Record](db-active-record.md) を扱う時にも使える、ということです。 +何より良いのは、このようなクエリ構築メソッドが [アクティブレコード](db-active-record.md) を扱う時にも使える、ということです。 更なる詳細については [クエリビルダ](db-query-builder.md) の節を参照してください。 @@ -397,7 +397,7 @@ $rows = $command->queryAll(); アクティブレコード ------------------ -Yii 2.0 は [Active Record](db-active-record.md) に数多くの変更を導入しました。 +Yii 2.0 は [アクティブレコード](db-active-record.md) に数多くの変更を導入しました。 最も顕著な違いは、クエリの構築方法とリレーショナルクエリの処理の二つです。 1.1 の `CDbCriteria` クラスは Yii 2 では [[yii\db\ActiveQuery]] に置き換えられました。 diff --git a/docs/guide-ja/start-databases.md b/docs/guide-ja/start-databases.md index aec8268..a5ccf7d 100644 --- a/docs/guide-ja/start-databases.md +++ b/docs/guide-ja/start-databases.md @@ -127,7 +127,7 @@ $country->save(); ``` > Info|情報: アクティブレコードは、オブジェクト指向の流儀でデータベースのデータにアクセスし、操作する強力な方法です。 -[Active Record](db-active-record.md) の節で、更に詳細な情報を得ることが出来ます。 +[アクティブレコード](db-active-record.md) の節で、更に詳細な情報を得ることが出来ます。 もう一つの方法として、[データアクセスオブジェクト(DAO)](db-dao.md) と呼ばれる、より低レベルなデータアクセス方法を使って データベースを操作することも出来ます。 diff --git a/docs/guide-ja/start-gii.md b/docs/guide-ja/start-gii.md index 600ce54..f0b3219 100644 --- a/docs/guide-ja/start-gii.md +++ b/docs/guide-ja/start-gii.md @@ -46,7 +46,7 @@ defined('YII_ENV') or define('YII_ENV', 'dev'); http://hostname/index.php?r=gii ``` -> Note|注意: ローカルホスト以外のマシンから GII にアクセスしようとすると、既定ではセキュリティ上の +> Note|注意: ローカルホスト以外のマシンから Gii にアクセスしようとすると、既定ではセキュリティ上の > 目的からアクセスが拒否されます。下記のように Gii を構成して、許可される IP アドレスを追加することが出来ます。 > ```php diff --git a/docs/guide-ja/start-hello.md b/docs/guide-ja/start-hello.md index c3571b8..9e4199e 100644 --- a/docs/guide-ja/start-hello.md +++ b/docs/guide-ja/start-hello.md @@ -4,14 +4,14 @@ この節では、アプリケーションに新しい「こんにちは」というページを作成する方法を説明します。 この目的を達するために、[アクション](structure-controllers.md#creating-actions) と [ビュー](structure-views.md) を作成することになります: -* アプリケーションがこのページへのリクエストをそのアクションに送致(dispatch)し、 +* アプリケーションがこのページへのリクエストをそのアクションに送付し、 * 次にそのアクションが "Hello" という言葉をエンドユーザに示すビューを表示します。 このチュートリアルを通じて、次の三つのことを学びます: 1. リクエストに応える [アクション](structure-controllers.md) をどのようにして作るか、 2. レスポンスの内容を構成する [ビュー](structure-views.md) をどのようにして作るか、そして、 -3. アプリケーションはどのようにしてリクエストを [アクション](structure-controllers.md#creating-actions) に送致するか。 +3. アプリケーションはどのようにしてリクエストを [アクション](structure-controllers.md#creating-actions) に送付するか。 アクションを作成する<a name="creating-action"></a> @@ -48,20 +48,20 @@ class SiteController extends Controller ``` 上記のコードで、`say` アクションは `SiteController` クラスの中で `actionSay` という名前のメソッドとして定義されています。 -Yii はコントローラクラスの中でアクションのメソッドとアクションでないメソッドを区別するために、`action` という接頭語を使います。 -`action` という接頭語の後の名前がアクション ID にマップされます。 +Yii はコントローラクラスの中でアクションのメソッドとアクションでないメソッドを区別するために、`action` という接頭辞を使います。 +`action` という接頭辞の後の名前がアクション ID にマップされます。 アクションを命名するについては、Yii がアクション ID をどのように取り扱うかを知っているべきです。 アクション ID は常に小文字で参照されます。 アクション ID が複数の単語を必要とするときは、単語がダッシュ(-)で連結されます (例えば、`create-comment`)。 -アクションメソッドの名前は、アクション ID からダッシュを全て削除し、各単語の先頭の文字を大文字にした結果に `action` という接頭語を付けたものとします。 +アクションメソッドの名前は、アクション ID からダッシュを全て削除し、各単語の先頭の文字を大文字にした結果に `action` という接頭辞を付けたものとします。 例えば、アクション ID `create-comment` に対応するアクションメソッド名は `actionCreateComment` となります。 私たちの例では、このアクションメソッドは `$message` というパラメータを取ります。 そして、このパラメータは `"Hello"` という既定値を取ります (PHP で関数やメソッドの引数について既定値をセットするのと全く同じ方法を使います)。 アプリケーションは、リクエストを受け取って、当該リクエストの処理を `say` アクションに任せると決定した場合、リクエストの中に同じ名前の付いたパラメータがあれば、それをこのパラメータに代入します。 -言い換えれば、もしリクエストに `"GoodBye"` という値の `message` パラメータが入っていれば、アクションの `$message` 変数にその値が割り当てけられます。 +言い換えれば、もしリクエストに `"GoodBye"` という値の `message` パラメータが入っていれば、アクションの `$message` 変数にその値が割り当てられます。 このアクションメソッドの中では、[[yii\web\Controller::render()|render()]] が呼ばれて `say` と言う名前の [ビュー](structure-views.md) ファイルが表示されます。 `message` パラメータも同時にビューに渡され、そこで使用されます。 @@ -72,7 +72,7 @@ Yii はコントローラクラスの中でアクションのメソッドとア� ビューを作成する<a name="creating-view"></a> ---------------- -[ビュー](structure-views.md) は、レスポンスのコンテンツを生成するために書くスクリプトです。 +[ビュー](structure-views.md) は、レスポンスのコンテンツを生成するためにあなたが書くスクリプトです。 「こんにちは」のタスクのためには、アクションメソッドから受け取った `message` パラメータを印字する `say` ビューを作成します: ```php @@ -126,7 +126,7 @@ URL から `message` パラメータを省略すると、"Hello" だけを表示 > Info|情報: アクションと同じく、コントローラもまたアプリケーションの中で一意に定義される ID を持ちます。 コントローラ ID も、アクション ID と同じ命名規則を使います。 - コントローラクラスの名前は、コントローラ ID からダッシュを削除し、各単語の最初の文字を大文字にし、結果として出来る文字列に `Controller` という接尾語を追加したものとします。 + コントローラクラスの名前は、コントローラ ID からダッシュを削除し、各単語の最初の文字を大文字にし、結果として出来る文字列に `Controller` という接尾辞を追加したものとします。 例えば、`post-comment` というコントローラ ID に対応するコントローラクラスの名前は `PostCommentController` です。 diff --git a/docs/guide-ja/start-workflow.md b/docs/guide-ja/start-workflow.md index d01d700..619e4ee 100644 --- a/docs/guide-ja/start-workflow.md +++ b/docs/guide-ja/start-workflow.md @@ -69,7 +69,7 @@ Yii は [モデル・ビュー・コントローラ (MVC)](http://wikipedia.org/ 各アプリケーションは一つのエントリスクリプト `web/index.php` を持ちます。これはアプリケーション中で唯一ウェブからアクセス可能な PHP スクリプトです。 エントリスクリプトは入力されたリクエストを受け取って、[アプリケーション](structure-applications.md) のインスタンスを作成します。 -[アプリケーション](structure-applications.md) は [コンポーネント](concept-components.md) の助力を得てリクエストを解決し、リクエストを MVC 要素に対して送出します。 +[アプリケーション](structure-applications.md) は [コンポーネント](concept-components.md) の助力を得てリクエストを解決し、リクエストを MVC に送付します。 [ウィジェット](structure-widgets.md) は、複雑で動的なユーザインタフェイス要素を構築するために、[ビュー](structure-views.md) の中で使われます。 -- libgit2 0.27.1