Merge pull request #3915 from yii2-chinesization/master

docs/guide-zh-CN/README.md

 Yii 2.0 权威指南
 ===============================
 
-本指南依据 [Terms of Yii Documentation](http://www.yiiframework.com/doc/terms/) 发布。
+本教程的发布遵循[ Yii 文档使用许可](http://www.yiiframework.com/doc/terms/).
 
-保留所有权利。
+版权所有
 
 2014 (c) Yii Software LLC.
 
+介绍
+-----
 
-简介
-------------
-
-* [关于 Yii](intro-yii.md)
-* [从 1.1 版本升级](intro-upgrade-from-v1.md)
+* **已定稿** [关于 Yii](intro-yii.md)
+* **已定稿** [从 Yii 1.1 升级](intro-upgrade-from-v1.md)
 
 
 入门
----------------
-
-* [安装 Yii](start-installation.md)
-* [运行应用程序](start-workflow.md)
-* [说一声你好](start-hello.md)
-* [使用表单](start-forms.md)
-* [使用数据库](start-databases.md)
-* [用 Gii 生成代码](start-gii.md)
-* [一路向前](start-looking-head.md)
-
-
-程序结构
----------------------
-
-* [概览](structure-overview.md)
-* [入口脚本](structure-entry-scripts.md)
-* [应用程序](structure-applications.md)
-* [应用程序组件](structure-application-components.md)
-* [控制器](structure-controllers.md)
-* [模型](structure-models.md)
-* [视图](structure-views.md)
-* **TBD** [过滤器](structure-filters.md)
-* **TBD** [挂件](structure-widgets.md)
-* **TBD** [模块](structure-modules.md)
-* [资源](structure-assets.md)
-* **TBD** [扩展](structure-extensions.md)
-
-
-处理请求
------------------
-
-* **TBD** [Bootstrapping](runtime-bootstrapping.md)
-* **TBD** [Routing](runtime-routing.md)
-* **TBD** [Requests](runtime-requests.md)
-* **TBD** [Responses](runtime-responses.md)
-* **TBD** [Sessions and Cookies](runtime-sessions-cookies.md)
-* [URL 解析及生成](runtime-url-handling.md)
-* [处理错误](runtime-handling-errors.md)
-* [日志](runtime-logging.md)
-
+-----
 
-关键概念
-------------
+* **已定稿** [安装 Yii](start-installation.md)
+* **已定稿** [运行应用](start-workflow.md)
+* **已定稿** [第一次问候](start-hello.md)
+* **已定稿** [使用 Forms](start-forms.md)
+* **已定稿** [玩转 Databases](start-databases.md)
+* **已定稿** [用 Gii 生成代码](start-gii.md)
+* **已定稿** [更上一层楼](start-looking-head.md)
 
-* [组件](concept-components.md)
-* [属性](concept-properties.md)
-* [事件](concept-events.md)
-* [行为](concept-behaviors.md)
-* [配置](concept-configurations.md)
-* [别名](concept-aliases.md)
-* [类的自动加载](concept-autoloading.md)
-* [服务定位器](concept-service-locator.md)
-* [依赖注入容器](concept-di-container.md)
+应用结构
+--------
 
+* **已定稿** [结构总览](structure-overview.md)
+* **已定稿** [入口脚本](structure-entry-scripts.md)
+* **已定稿** [应用](structure-applications.md)
+* **已定稿** [应用组件](structure-application-components.md)
+* **已定稿** [控制器（Controller）](structure-controllers.md)
+* **已定稿** [视图（View）](structure-views.md)
+* **已定稿** [模型（Model）](structure-models.md)
+* **待定中** [过滤器](structure-filters.md)
+* **待定中** [小部件（Widget）](structure-widgets.md)
+* **待定中** [模块（Module）](structure-modules.md)
+* **编撰中** [前端资源（Asset）](structure-assets.md)
+* **待定中** [扩展（extensions）](structure-extensions.md)
+
+请求处理
+--------
 
-使用数据库
-----------------------
+* **待定中** [引导（Bootstrapping）](runtime-bootstrapping.md)
+* **待定中** [路由（Routing）](runtime-routing.md)
+* **待定中** [请求（Request）](runtime-requests.md)
+* **待定中** [响应（Response）](runtime-responses.md)
+* **待定中** [Sessions（会话）和 Cookies](runtime-sessions-cookies.md)
+* **已定稿** [URL 解析和生成](runtime-url-handling.md)
+* **编撰中** [错误处理](runtime-handling-errors.md)
+* **编撰中** [日志](runtime-logging.md)
 
-* [Data Access Objects](db-dao.md) - Connecting to a database, basic queries, transactions and schema manipulation
-* [Query Builder](db-query-builder.md) - Querying the database using a simple abstraction layer
-* [Active Record](db-active-record.md) - The active record ORM, retrieving and manipulating records and defining relations
-* [Migrations](db-migrations.md) - Version control your databases in a team development environment
-* **TBD** [Sphinx](db-sphinx.md)
-* **TBD** [Redis](db-redis.md)
-* **TBD** [MongoDB](db-mongodb.md)
-* **TBD** [ElasticSearch](db-elastic-search.md)
+关键概念
+--------
 
+* **已定稿** [组件（Component）](concept-components.md)
+* **已定稿** [属性（Property）](concept-properties.md)
+* **已定稿** [事件（Event）](concept-events.md)
+* **已定稿** [行为（Behavior）](concept-behaviors.md)
+* **已定稿** [配置（Configs）](concept-configurations.md)
+* **已定稿** [类自动加载（Autoloading）](concept-autoloading.md)
+* **已定稿** [别名（Alias）](concept-alias.md)
+* **已定稿** [服务定位器（Service Locator）](concept-service-locator.md)
+* **已定稿** [依赖注入容器（DI Container）](concept-di-container.md)
+
+配合数据库工作
+-------------
 
-获取来自用户的数据
------------------------
+* **编撰中** [数据访问对象（DAO）](db-dao.md) - 数据库连接、基本查询、事务和模式操作
+* **编撰中** [查询生成器（Query Builder）](db-query-builder.md) - 使用简单抽象层查询数据库
+* **编撰中** [活动记录（Active Record）](db-active-record.md) - 活动记录对象关系映射（ORM），检索和操作记录、定义关联关系
+* **编撰中** [数据库迁移（Migration）](db-migrations.md) - 在团体开发中对你的数据库使用版本控制
+* **待定中** [Sphinx](db-sphinx.md)
+* **待定中** [Redis](db-redis.md)
+* **待定中** [MongoDB](db-mongodb.md)
+* **待定中** [ElasticSearch](db-elastic-search.md)
 
-* [创建表单](input-forms.md)
-* [验证输入](input-validation.md)
-* **TBD** [Uploading Files](input-file-upload.md)
-* **TBD** [Getting Data for Multiple Models](input-multiple-models.md)
+接收用户数据
+-----------
 
+* **编撰中** [创建表单](input-forms.md)
+* **已定稿** [输入验证](input-validation.md)
+* **编撰中** [文件上传](input-file-uploading.md)
+* **待定中** [多模型同时输入](input-multiple-models.md)
 
 显示数据
----------------
-
-* **TBD** [Data Formatting](output-formatting.md)
-* **TBD** [Pagination](output-pagination.md)
-* **TBD** [Sorting](output-sorting.md)
-* [Data Providers](output-data-providers.md)
-* [Data Widgets](output-data-widgets.md)
-* [主题](output-theming.md)
+--------
 
+* **待定中** [格式化输出数据](output-formatting.md)
+* **待定中** [分页（Pagination）](output-pagination.md)
+* **待定中** [排序（Sorting）](output-sorting.md)
+* **编撰中** [数据提供器](output-data-providers.md)
+* **编撰中** [数据小部件](output-data-widgets.md)
+* **编撰中** [主题](output-theming.md)
 
 安全
---------
-
-* [验证](security-authentication.md)
-* [授权](security-authorization.md)
-* [使用密码](security-passwords.md)
-* **TBD** [Auth Clients](security-auth-clients.md)
-* **TBD** [Best Practices](security-best-practices.md)
+-----
 
+* **编撰中** [认证（Authentication）](security-authentication.md)
+* **编撰中** [授权（Authorization）](security-authorization.md)
+* **编撰中** [处理密码](security-passwords.md)
+* **待定中** [客户端认证](security-auth-clients.md)
+* **待定中** [安全领域的最佳实践](security-best-practices.md)
 
 缓存
--------
-
-* [概览](caching-overview.md)
-* [数据缓存](caching-data.md)
-* [片段缓存](caching-fragment.md)
-* [页面缓存](caching-page.md)
-* [HTTP 缓存](caching-http.md)
+-----
 
+* **已定稿** [概述](caching-overview.md)
+* **已定稿** [数据缓存](caching-data.md)
+* **已定稿** [片段缓存](caching-fragment.md)
+* **已定稿** [分页缓存](caching-page.md)
+* **已定稿** [HTTP 缓存](caching-http.md)
 
 RESTful Web 服务
---------------------
-
-* [快速入门](rest-quick-start.md)
-* [Resources](rest-resources.md)
-* [Controllers](rest-controllers.md)
-* [Routing](rest-routing.md)
-* [Response Formatting](rest-response-formatting.md)
-* [Authentication](rest-authentication.md)
-* [Rate Limiting](rest-rate-limiting.md)
-* [Versioning](rest-versioning.md)
-* [Error Handling](rest-error-handling.md)
-
+----------------
+
+* **已定稿** [快速入门](rest-quick-start.md)
+* **已定稿** [资源](rest-resources.md)
+* **已定稿** [路由](rest-routing.md)
+* **已定稿** [格式化响应](rest-response-formatting.md)
+* **已定稿** [授权验证](rest-authentication.md)
+* **已定稿** [速率限制](rest-rate-limiting.md)
+* **已定稿** [版本化](rest-versioning.md)
+* **已定稿** [错误处理](rest-error-handling.md)
+* **已定稿** [测试](rest-testing.md)
 
 开发工具
------------------
+--------
 
-* [Debug Toolbar and Debugger](tool-debugger.md)
-* [Generating Code using Gii](tool-gii.md)
-* **TBD** [Generating API Documentation](tool-api-doc.md)
+* **编撰中** [调试工具栏和调试器](tool-debugger.md)
+* **编撰中** [使用 Gii 生成代码](tool-gii.md)
+* **待定中** [生成 API 文档](tool-api-doc.md)
 
 
 测试
--------
-
-* [Overview](test-overview.md)
-* **TBD** [Unit Tests](test-unit.md)
-* **TBD** [Functional Tests](test-functional.md)
-* **TBD** [Acceptance Tests](test-acceptance.md)
-* [Fixtures](test-fixtures.md)
+-----
 
+* **编撰中** [概述](test-overview.md)
+* **待定中** [单元测试](test-unit.md)
+* **待定中** [功能测试](test-functional.md)
+* **待定中** [验收测试](test-acceptance.md)
+* **编撰中** [测试夹具](test-fixtures.md)
 
 扩展 Yii
--------------
-
-* [创建扩展](extend-creating-extensions.md)
-* [定制核心代码](extend-customizing-core.md)
-* [使用第三方库](extend-using-libs.md)
-* **TBD** [Using Yii in 3rd-Party Systems](extend-embedding-in-others.md)
-* **TBD** [Using Yii 1.1 and 2.0 Together](extend-using-v1-v2.md)
-* [使用 Composer](extend-using-composer.md)
-
-
-专题
---------------
-
-* [高级应用程序模板](tutorial-advanced-app.md)
-* [从头开始构建应用程序](tutorial-start-from-scratch.md)
-* [控制台命令](tutorial-console.md)
-* [核心验证器](tutorial-core-validators.md)
-* [国际化](tutorial-i18n.md)
-* [发送邮件](tutorial-mailing.md)
-* [性能调节](tutorial-performance-tuning.md)
-* **TBD** [共享的主机环境](tutorial-shared-hosting.md)
-* [模板引擎](tutorial-template-engines.md)
-
-
-挂件（Widgets)
--------
-
-* GridView: link to demo page
-* ListView: link to demo page
-* DetailView: link to demo page
-* ActiveForm: link to demo page
-* Pjax: link to demo page
-* Menu: link to demo page
-* LinkPager: link to demo page
-* LinkSorter: link to demo page
-* [Bootstrap Widgets](bootstrap-widgets.md)
-* **TBD** [Jquery UI Widgets](jui-widgets.md)
+--------
 
+* **编撰中** [创建扩展](extend-creating-extensions.md)
+* **编撰中** [定制核心代码](extend-customizing-core.md)
+* **编撰中** [使用第三方库](extend-using-libs.md)
+* **待定中** [在第三方系统使用 Yii](extend-embedding-in-others.md)
+* **待定中** [Yii 1.1 和 2.0 共用](extend-using-v1-v2.md)
+* **编撰中** [使用依赖包管理器 Composer](extend-using-composer.md)
 
-助手(Helpers)
--------
 
-* [概览](helper-overview.md)
-* **TBD** [ArrayHelper](helper-array.md)
-* **TBD** [Html](helper-html.md)
-* **TBD** [Url](helper-url.md)
-* **TBD** [Security](helper-security.md)
+高级专题
+--------
 
+* **编撰中** [高级应用模版](tutorial-advanced-app.md)
+* **编撰中** [从头构建自定义模版](tutorial-start-from-scratch.md)
+* **编撰中** [控制台命令](tutorial-console.md)
+* **已定稿** [核心验证器](tutorial-core-validators.md)
+* **编撰中** [国际化](tutorial-i18n.md)
+* **编撰中** [收发邮件](tutorial-mailing.md)
+* **编撰中** [性能优化](tutorial-performance-tuning.md)
+* **待定中** [共享主机环境](tutorial-shared-hosting.md)
+* **编撰中** [模板引擎](tutorial-template-engines.md)
+
+小部件
+------
+
+* 表格视图（GridView）：链接到 demo 页
+* 列表视图（ListView）：链接到 demo 页
+* 详情视图（DetailView）：链接到 demo 页
+* 活动表单（ActiveForm）：链接到 demo 页
+* Pjax：链接到 demo 页
+* 菜单（Menu）：链接到 demo 页
+* LinkPager：链接到 demo 页
+* LinkSorter：链接到 demo 页
+* **编撰中** [Bootstrap 小部件](bootstrap-widgets.md)
+* **编撰中** [Jquery UI 小部件](jui-widgets.md)
+
+助手类
+------
+
+* **编撰中** [概述](helper-overview.md)
+* **待定中** [ArrayHelper](helper-array.md)
+* **待定中** [Html](helper-html.md)
+* **待定中** [Url](helper-url.md)
+* **待定中** [security](helper-security.md)
+
+不在目录内的文件
+----------------
+
+*  [glossary](glossary.md)

docs/guide-zh-CN/start-installation.md

@@ -2,12 +2,12 @@
 ==============
 
 你可以通过两种方式安装 Yii：使用 [Composer](http://getcomposer.org/) 或下载一个存档文件。推荐使用前者，
-这样只需执行一条简单的命令就可以安装新的 [扩展](structure-extensions.md) 或更新 Yii 了。
+这样只需执行一条简单的命令就可以安装新的 [扩展](extend-creating-extensions.md) 或更新 Yii 了。
 
-> Note: 和 Yii 1 版本不同，以标准方式安装 Yii 2 时会同时下载并安装框架本身和一个应用程序骨架。
+> 注意：和 Yii 1 版本不同，以标准方式安装 Yii 2 时会同时下载并安装框架本身和一个应用程序骨架。
 
 
-通过 Composer 安装<a name="installing-via-composer"></a>
+通过 Composer 安装 <a name="installing-via-composer"></a>
 -----------------------
 
 如果还没有安装 Composer，你可以按 [getcomposer.org](https://getcomposer.org/download/) 中的方法安装。
@@ -18,7 +18,7 @@
 
 在 Windows 中，你需要下载并运行 [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe)。
 
-如果遇到了任何问题或者想更深入地学习 Composer，请参考  [Composer 文档](https://getcomposer.org/doc/) 。
+如果遇到了任何问题或者想更深入地学习 Composer，请参考  [Composer 文档（英文）](https://getcomposer.org/doc/)，[Composer 中文](https://github.com/5-say/composer-doc-cn)。
 
 Composer 安装后，切换到一个可通过 Web 访问的目录，执行如下命令即可安装 Yii ：
 
@@ -26,7 +26,7 @@ Composer 安装后，切换到一个可通过 Web 访问的目录，执行如下
 
 如上命令会将 Yii 安装在一个名为 `basic` 的目录中。
 
-> Tip: 如果你想安装 Yii 的最新开发版本，可以使用如下命令，它添加了一个
+> 技巧：如果你想安装 Yii 的最新开发版本，可以使用如下命令，它添加了一个
 > [stability 选项](https://getcomposer.org/doc/04-schema.md#minimum-stability):
 >
 >     composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
@@ -51,9 +51,9 @@ Composer 安装后，切换到一个可通过 Web 访问的目录，执行如下
 但是还可以有其他的安装方式：
 
 * 如果你只想安装核心框架，然后从头开始构建一个应用程序，可以参考
- [从头开始构建应用程序](tutorial-start-from-scratch.md) 一节的介绍。
+[从头构建自定义模版](tutorial-start-from-scratch.md) 一节的介绍。
 * 如果你要开始一个更复杂的项目，更好的地适用于团队开发环境的，你可以考虑安装
- [高级应用程序模板](tutorial-advanced-app.md).
+ [高级应用模版](tutorial-advanced-app.md).
 
 
 验证安装 <a name="verifying-installation"></a>
@@ -81,29 +81,27 @@ http://localhost/basic/web/index.php
   php requirements.php
   ```
 
-你需要配置好 PHP 安装环境，使其符合 Yii 的最小需求。最重要的是需要有 PHP 5.4 以上版本。如果你的应用程序需要用到数据库，
-那还要安装 [PDO PHP 扩展](http://www.php.net/manual/en/pdo.installation.php) 和相应的数据库驱动
-（例如访问 MySQL 数据库所需的 `pdo_mysql` ）。
+你需要配置好 PHP 安装环境，使其符合 Yii 的最小需求。最重要的是需要有 PHP 5.4 以上版本。如果你的应用程序需要用到数据库，那还要安装 [PDO PHP 扩展](http://www.php.net/manual/en/pdo.installation.php) 和相应的数据库驱动（例如访问 MySQL 数据库所需的 `pdo_mysql` ）。
 
 
 配置 Web 服务器 <a name="configuring-web-servers"></a>
 -----------------------
 
-> Info: 如果你现在只是要试用 Yii 而不是要将其部署到生产环境中的服务器上，下面的这一节可以跳过。
+>补充：如果你现在只是要试用 Yii 而不是要将其部署到生产环境中的服务器上，下面的这一节可以跳过。
 
-通过上述方法安装的应用程序在 Windows，Max OS X 或 Linux 中的  [Apache HTTP server](http://httpd.apache.org/)
-或者 [Nginx HTTP server](http://nginx.org/) 上都可以直接运行。
+通过上述方法安装的应用程序在 Windows，Max OS X 或 Linux 中的 [Apache HTTP 服务器](http://httpd.apache.org/)
+或者 [Nginx HTTP 服务器](http://nginx.org/) 上都可以直接运行。
 
 在生产环境的服务器上，你可能会想配置服务器让应用程序可以通过 URL `http://www.example.com/index.php` 访问而不是通过
-`http://www.example.com/basic/web/index.php` 。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。
-可能你还会想隐藏掉 URL 中的 `index.php` ， [URL Parsing and Generation](runtime-url-handling.md) 一章中有介绍。.
+`http://www.example.com/basic/web/index.php`。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。
+可能你还会想隐藏掉 URL 中的 `index.php`，[URL 解析和生成](runtime-url-handling.md) 一章中有介绍。
 在这一节中，你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。
 
-> Info: 将 `basic/web` 设置为文档根目录，可以防止终端用户访问 `basic/web` 相邻目录中的私有应用程序代码和敏感数据文件。
+>补充：将 `basic/web` 设置为文档根目录，可以防止终端用户访问 `basic/web` 相邻目录中的私有应用程序代码和敏感数据文件。
 禁止对其他目录的访问是一个切实可行的安全改进。
 
-> Info: 如果你的应用程序将来要运行在共享的主机环境中，没有权限修改它的 Web 服务器配置，你依然可以调整应用程序的结构
-提升安全性。详情请参考 [共享的主机环境](tutorial-shared-hosting.md) 一章。
+>补充：如果你的应用程序将来要运行在共享的主机环境中，没有权限修改它的 Web 服务器配置，你依然可以调整应用程序的结构
+提升安全性。详情请参考 [共享主机环境](tutorial-shared-hosting.md) 一章。
 
 
 ### 推荐使用的 Apache 配置 <a name="recommended-apache-configuration"></a>