Merge pull request #6831 from softark/docs-guide-ja-tut-templ

docs/guide-ja/README.md

@@ -169,8 +169,8 @@ RESTful ウェブサービス
 * [メール送信](tutorial-mailing.md)
 * [パフォーマンスチューニング](tutorial-performance-tuning.md)
 * [共有ホスティング環境](tutorial-shared-hosting.md)
-* **翻訳中** [テンプレートエンジン](tutorial-template-engines.md)
-* **翻訳中** [サードパーティのコードを扱う](tutorial-yii-integration.md)
+* [テンプレートエンジン](tutorial-template-engines.md)
+* [サードパーティのコードを扱う](tutorial-yii-integration.md)
 
 
 ウィジェット
@@ -184,8 +184,8 @@ RESTful ウェブサービス
 * Menu: **TBD** link to demo page
 * LinkPager: **TBD** link to demo page
 * LinkSorter: **TBD** link to demo page
-* **翻訳未着手** [Bootstrap ウィジェット](widget-bootstrap.md)
-* **翻訳未着手** [jQuery UI ウィジェット](widget-jui.md)
+* [Bootstrap ウィジェット](widget-bootstrap.md)
+* [jQuery UI ウィジェット](widget-jui.md)
 
 
 ヘルパ

docs/guide-ja/output-formatter.md

@@ -53,6 +53,10 @@ echo Yii::$app->formatter->asDate('2014-01-01'); // 出力: 2014/01/01
 > Note|注意: フォーマットの仕方は、PHP とともにコンパイルされた ICU ライブラリのバージョンの違いによって異なる可能性がありますし、[PHP intl 拡張](http://php.net/manual/ja/book.intl.php) がインストールされているか否かという事実によっても異なってきます。
 > 従って、あなたのウェブサイトが全ての環境で同じ出力を表示することを保証するために、全ての環境に PHP intl 拡張をインストールして、ICU ライブラリのバージョンが同じであることを確認する事を推奨します。
 > [PHP 環境を国際化のために設定する](tutorial-i18n.md#setup-environment) も参照してください。
+>
+> もう一つ注意してほしいのは、たとえ intl 拡張がインストールされていても、32-bit システムでは、2038 年以降および 1901 年以前の日付・時刻の書式は、ローカライズされた月と日の名前を提供しない PHP の実装にフォールバックする、ということです。
+> これは 32-bit システムでは intl が 32-bit の UNIX タイムスタンプを内部的に使用するからです。
+> 64-bit のシステムでは、インストールされていれば、全ての場合に intl フォーマッタが使用されます。
 
 
 フォーマッタを構成する <a name="configuring-format"></a>

docs/guide-ja/security-authorization.md

@@ -190,7 +190,9 @@ Yii 縺ｯ莠檎ｨｮ鬘槭讓ｩ髯蝉ｻ倅ｸ弱繝阪繧ｸ繝｣繧呈署萓帙＠縺ｦ縺∪縺吶ゅ☆縺ｪ
 前者は権限付与データを保存するのに PHP スクリプトファイルを使いますが、後者は権限付与データをデータベースに保存します。
 あなたのアプリケーションが非常に動的なロールと許可の管理を必要とするのでなければ、前者を使うことを考慮するのが良いでしょう。
 
-次のコードは、アプリケーションの構成情報で `authManager` を構成する方法を示すものです。
+#### authManager を `PhpManager` で構成する
+
+次のコードは、アプリケーションの構成情報で [[yii\rbac\PhpManager]] クラスを使って `authManager` を構成する方法を示すものです。
 
 ```php
 return [
@@ -204,11 +206,42 @@ return [
 ];
 ```
 
-`authManager` は `\Yii::$app->authManager` によってアクセスすることが出来ます。
+これで `authManager` は `\Yii::$app->authManager` によってアクセスすることが出来るようになります。
 
 > Tip|ヒント: デフォルトでは、[[yii\rbac\PhpManager]] は RBAC データを `@app/rbac/` ディレクトリの下のファイルに保存します。
   権限の階層をオンラインで変更する必要がある場合は、必ず、ウェブサーバのプロセスがこのディレクトリとその中の全てのファイルに対する書き込み権限を有するようにしてください。
 
+#### authManager を `DbManager` で構成する
+
+次のコードは、アプリケーションの構成情報で [[yii\rbac\DbManager]] クラスを使って `authManager` を構成する方法を示すものです。
+
+
+```php
+return [
+    // ...
+    'components' => [
+        'authManager' => [
+            'class' => 'yii\rbac\DbManager',
+        ],
+        // ...
+    ],
+];
+```
+
+`DbManager` は四つのデータベーステーブルを使ってデータを保存します。
+
+- [[yii\rbac\DbManager::$itemTable|itemTable]]: 権限アイテムを保存するためのテーブル。デフォルトは "auth_item"。
+- [[yii\rbac\DbManager::$itemChildTable|itemChildTable]]: 権限アイテムの階層を保存するためのテーブル。デフォルトは "auth_item_child"。
+- [[yii\rbac\DbManager::$assignmentTable|assignmentTable]]: 権限アイテムの割り当てを保存するためのテーブル。デフォルトは "auth_assignment"。
+- [[yii\rbac\DbManager::$ruleTable|ruleTable]]: 規則を保存するためのテーブル。デフォルトは "auth_rule"。
+
+先に進む前にこれらのテーブルをデータベースに作成する必要があります。
+そのためには、`@yii/rbac/migrations` に保存されているマイグレーションを使うことが出来ます。
+
+`yii migrate --migrationPath=@yii/rbac/migrations`
+
+これで `authManager` は `\Yii::$app->authManager` によってアクセスすることが出来るようになります。
+
 
 ### 権限付与データを構築する
 

docs/guide-ja/widget-bootstrap.md

+Bootstrap ウィジェット
+======================
+
+> Note|注意: この節はまだ執筆中です。
+
+Yii は、追加設定なしで、マークアップとコンポーネントのフレームワーク [Bootstrap 3](http://getbootstrap.com/) ("Twitter Bootstrap" としても知られています) をサポートしています。
+Bootstrap は優れた、レスポンシブなフレームワークであり、クライアント側の開発プロセスを大いにスピードアップすることが出来るものです。
+
+Bootstrap のコアは二つの部分によって表されます。
+
+- CSS の基礎。例えば、グリッドのレイアウトシステム、タイポグラフィ、ヘルパクラス、レスポンシブユーティリティなど。
+- そのまま使えるコンポーネント。フォーム、メニュー、ページネーション、モーダルボックス、タブなど。
+
+基礎
+----
+
+Yii は bootstrap の基礎を PHP コードでラップすることをしていません。
+なぜなら、この場合の HTML コードがそれ自体として非常にシンプルだからです。
+bootstrap の基礎を使用することに関する詳細は、[bootstrap ドキュメントウェブサイト](http://getbootstrap.com/css/) で見ることが出来ます。
+それでも、Yii はあなたのページに bootstrap のアセットをインクルードするための便利な方法を提供しています。
+`@app/assets` ディレクトリに配置されている `AppAsset.php` に一行を加えるだけで大丈夫です。
+
+```php
+public $depends = [
+    'yii\web\YiiAsset',
+    'yii\bootstrap\BootstrapAsset', // この行です
+];
+```
+
+Yii のアセットマネージャによって bootstrap を使うと、bootstrap のリソースを最小化したり、必要な場合にはあなた自身のリソースと結合したりすることが出来ます。
+
+Yii ウィジェット
+----------------
+
+複雑な bootstrap コンポーネントのほとんどは Yii ウィジェットでラップされて、より堅牢な構文を与えられ、フレームワークの諸機能と統合されています。
+全てのウィジェットは `\yii\bootstrap` 名前空間に属します。
+
+- [[yii\bootstrap\ActiveForm|ActiveForm]]
+- [[yii\bootstrap\Alert|Alert]]
+- [[yii\bootstrap\Button|Button]]
+- [[yii\bootstrap\ButtonDropdown|ButtonDropdown]]
+- [[yii\bootstrap\ButtonGroup|ButtonGroup]]
+- [[yii\bootstrap\Carousel|Carousel]]
+- [[yii\bootstrap\Collapse|Collapse]]
+- [[yii\bootstrap\Dropdown|Dropdown]]
+- [[yii\bootstrap\Modal|Modal]]
+- [[yii\bootstrap\Nav|Nav]]
+- [[yii\bootstrap\NavBar|NavBar]]
+- [[yii\bootstrap\Progress|Progress]]
+- [[yii\bootstrap\Tabs|Tabs]]
+
+
+Bootstrap の .less ファイルを直接に使用する
+-------------------------------------------
+
+あなたが [Bootstrap CSS をあなたの less ファイルに直接含める](http://getbootstrap.com/getting-started/#customizing) ことを望む場合は、オリジナルの CSS ファイルがロードされないように無効化する必要があるでしょう。
+[[yii\bootstrap\BootstrapAsset|BootstrapAsset]] の `css` プロパティを空に設定することによって、そうすることが出来ます。
+そのためには、`assetManager` [アプリケーションコンポーネント](structure-application-components.md) を以下のように構成します。
+
+```php
+    'assetManager' => [
+        'bundles' => [
+            'yii\bootstrap\BootstrapAsset' => [
+                'css' => [],
+            ]
+        ]
+    ]
+```

docs/guide-ja/widget-jui.md

+jQuery UI ウィジェット
+======================
+
+> Note|注意: この節はまだ執筆中です。
+
+Yii は公式エクステンションによって [jQuery UI](http://api.jqueryui.com/) ライブラリをサポートしています。
+jQuery UI は、jQuery JavaScript ライブラリの上に構築された、一連のユーザインタフェイスインタラクション、イフェクト、ウィジェットおよびテーマです。
+
+インストール
+------------
+
+このエクステンションの推奨されるインストール方法は、[composer](http://getcomposer.org/download/) を使う方法です。
+
+下記を実行します。
+
+```
+php composer.phar require --prefer-dist yiisoft/yii2-jui "*"
+```
+
+または、`composer.json` ファイルの `require` セクションに下記を追加します。
+
+```
+"yiisoft/yii2-jui": "*"
+```
+
+Yii ウィジェット
+----------------
+
+複雑な jQuery UI コンポーネントのほとんどは Yii ウィジェットでラップされて、より堅牢な構文を与えられ、フレームワークの諸機能と統合されています。
+全てのウィジェットは `\yii\jui` 名前空間に属します。
+
+- [[yii\jui\Accordion|Accordion]]
+- [[yii\jui\AutoComplete|AutoComplete]]
+- [[yii\jui\DatePicker|DatePicker]]
+- [[yii\jui\Dialog|Dialog]]
+- [[yii\jui\Draggable|Draggable]]
+- [[yii\jui\Droppable|Droppable]]
+- [[yii\jui\Menu|Menu]]
+- [[yii\jui\ProgressBar|ProgressBar]]
+- [[yii\jui\Resizable|Resizable]]
+- [[yii\jui\Selectable|Selectable]]
+- [[yii\jui\Slider|Slider]]
+- [[yii\jui\SliderInput|SliderInput]]
+- [[yii\jui\Sortable|Sortable]]
+- [[yii\jui\Spinner|Spinner]]
+- [[yii\jui\Tabs|Tabs]]