From f7fca87f14cac2fddbb4aca40f25b45d35c17b6b Mon Sep 17 00:00:00 2001 From: Nobuo Kihara Date: Mon, 1 Dec 2014 21:37:13 +0900 Subject: [PATCH] docs/guide-ja/start-installation.md - updated [ci skip] --- docs/guide-ja/start-installation.md | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) diff --git a/docs/guide-ja/start-installation.md b/docs/guide-ja/start-installation.md index 0b5e4097b9..44e91ba4c2 100644 --- a/docs/guide-ja/start-installation.md +++ b/docs/guide-ja/start-installation.md @@ -4,7 +4,18 @@ Yii をインストールする Yii は二つの方法でインストールできます。[Composer](http://getcomposer.org/) を使う方法とアーカイブファイルをダウンロードする方法です。 前者がお薦めの方法です。と言うのは、一つのコマンドを走らせるだけで、新しい[エクステンション](structure-extensions.md) をインストールしたり、Yii をアップデートしたり出来るからです。 -> Note|注意: Yii 1 とは異なり、Yii 2 の標準的なインストールを実行すると、フレームワークとアプリケーションスケルトンの両方がダウンロードされてインストールされます。 +Yii の標準的なインストールを実行すると、フレームワークとアプリケーションテンプレートの両方がダウンロードされてインストールされます。 +アプリケーションテンプレートは、いくつかの基本的な機能、例えば、ログインやコンタクトフォームなどを実装した、動作する Yii アプリケーションです。 +そのコードは推奨される方式に従って組織されています。 +そのため、アプリケーションテンプレートは、あなたのプロジェクトのための好ましい開始点としての役割を果たしうるものです。 + +この節と後続のいくつかの節においては、いわゆる *ベーシックアプリケーションテンプレート* とともに Yii をインストールする方法、および、このテンプレート上に新しい機能を実装する方法を説明します。 +Yii は [アドバンストアプリケーションテンプレート](tutorial-advanced-app.md) と呼ばれるもう一つのテンプレートも提供しています。 +こちらは、チーム開発環境において多層構造のアプリケーションを開発するときに使用する方が望ましいものです。 + +> Info|情報: ベーシックアプリケーションテンプレートは、ウェブアプリケーションの 90 パーセントを開発するのに適したものです。 + アドバンストアプリケーションテンプレートとの主な違いは、コードがどのように組織されているかという点にあります。 + あなたが Yii は初めてだという場合は、シンプルでありながら十分な機能を持っていることを理由にして、ベーシックアプリケーションテンプレートに留まることを強く推奨します。 Composer によるインストール @@ -34,11 +45,9 @@ Composer がインストールされたら、ウェブからアクセスでき 第二のコマンドは `basic` という名前のディレクトリに Yii をインストールします。 必要なら別のディレクトリ名を選ぶことも出来ます。 -> Note|注意: インストール実行中に Composer が あなたの Github アカウントの認証情報を尋ねてくることがあるかも知れません。 -> これは、Comoser が Github API の転送レート制限にひっかかったためです。 -> Composer は全てのパッケージのための大量の情報を Github から読み出さなければならないので、こうなるのは普通のことです。 -> Github にログインすると API の転送レート制限が緩和され、Composer が仕事を続けることが出来るようになります。 -> 詳細については、[Composer documentation](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens) を参照してください。 +> Note|注意: インストール実行中に Composer が あなたの Github のログイン認証情報を求めることがあるかも知れません。 +> これは、Comoser が依存パッケージの情報を Github から読み出すために十分な転送レートを必要とするためで、普通にあることです。 +> 詳細については、[Composer ドキュメント](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) を追加した次のコマンドを代りに使うことが出来ます。 > @@ -67,7 +76,8 @@ Composer がインストールされたら、ウェブからアクセスでき -------------------------- 上記のインストール方法の説明は Yii のインストールの仕方を示すものですが、それは同時にそのままで動作する基本的なウェブアプリケーションを作成するものでもあります。 -これは小さなプロジェクトを開始するのに良い方法です。あるいは Yii の学習を始めたばかりの場合にもこれで良いでしょう。 +これは、規模の大小に関わらず、ほとんどのプロジェクトを開始するのに良い方法です。 +特に、Yii の学習を始めたばかりの場合には、この方法が適しています。 しかし、他のインストールオプションも利用可能です。