nbarbettini · armku · Oct 10, 2017 · Oct 10, 2017 · Oct 10, 2017 · Oct 10, 2017
diff --git a/.nojekyll b/.nojekyll
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,3 +1,19 @@
+# 参与方式
+
+重要的先说：这本 简明 ASP.NET Core 手册 基于 [Creative Commons Attribution](https://creativecommons.org/licenses/by/4.0/)（[创作共用署名4.0](https://creativecommons.org/licenses/by/4.0/deed.zh)）许可证，这意味着，欢迎你按自己的意愿复制、分发、克隆、重排本书中的资料。我仅有的要求就是，你要指出原作者（Nate Barbettini）。当然，中文版请别忘了译者：windsting 和 yuyi。
+
+## 发现错误？
+
+如果你看到错别字或者有问题的代码，欢迎修正它。我们乐于接受 pull request。
+
+如果你不熟悉 Git 或者用不惯它，也没关系。可以在 [登记问题](https://github.com/windsting/little-aspnetcore-book/issues) 页面指出这个错误。请写得尽量详细一些。
+
+## 欢迎建议
+
+如果你有什么建议，欢迎提交一个 [议题](https://github.com/windsting/little-aspnetcore-book/issues) 或者发邮件到 [email protected] 给我。我不一定回复所有来信，但我会尽量都读一下。
+
+---
+
 # How to contribute
 
 First things first: the Little ASP.NET Core Book is licensed under the [Creative Commons Attribution](https://creativecommons.org/licenses/by/4.0/) license, which means you are welcome to copy, redistribute, fork, or remix the material in the book as much as you want. All I ask is that you give credit to the original author (Nate Barbettini).

diff --git a/README.md b/README.md
@@ -1,3 +1,104 @@
+# 简明 ASP.NET Core 手册
+
+*Nate Barbettini 著*
+
+*windsting 、 yuyi 译*
+
+Copyright &copy; 2018. All rights reserved.
+
+以 创作共用署名4.0国际许可证 发布。您可以自由地：共享 — 在任何媒介以任何形式复制、发行本作品，演绎 — 修改、转换或以本作品为基础进行创作，在任何用途下，甚至商业目的。您必须给出适当的署名，提供指向本许可协议的链接。
+
+详情请访问：https://creativecommons.org/licenses/by/4.0/deed.zh
+
+- If you like this project, please consider 
+
+  <a href="https://www.buymeacoffee.com/windstings"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=☕&slug=windstings&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
+
+## 前言
+
+感谢你选择这本 简明 ASP.NET Core 手册！我写这本小书的目的，是帮助 web 编程开发者以及爱好者了解 ASP.NET Core 2.0，一个用于创建 Web应用 和 API 的框架。
+
+这本 简明 ASP.NET Core 手册 的内容组织成了一篇教程。你将从头开始，完整地构建一个应用程序，同时了解以下内容：
+
+* MVC (Model-View-Controller) 模式的基本内容
+* 前端代码（HTML、CSS、JavaScript）怎样与后端代码交互
+* 什么是依赖注入以及它的实用之处
+* 如何进行数据库的读写操作
+* 如何添加 登录、注册功能，以及如何提升安全性
+* 如何部署该应用程序到网络上
+
+别担心，就算对 ASP.NET Core （及以上列表的内容）一无所知，也不妨碍你学下去。
+
+## 开始之前
+
+你将要构建的这个应用，其完整源码位于 GitHub：
+
+https://www.github.com/nbarbettini/little-aspnetcore-todo
+
+如果需要与你自己的代码做对比，可任意下载。
+
+这本书本身也会由于修订和内容的增加而频繁更新。如果你阅读的是 PDF、电子书，或者打印版，请查阅官网([littleasp.net/book](http://www.littleasp.net/book)，中文版为 [windsting.github.io/little-aspnetcore-book/book/](https://windsting.github.io/little-aspnetcore-book/book/))的版本更新。有关版本信息和更新内容，请查阅本书的最后一页。
+
+### 选择你的语言阅读
+
+感谢那些多语言的投稿者，简明 ASP.NET Core 手册 已经被翻译成其它语言：
+
+* [**The Little ASP.NET Core Book**](https://www.recaffeinate.co/book/) (English -- original version)
+
+* [**ASP.NET Core El Kitabı**](https://sahinyanlik.gitbooks.io/kisa-asp-net-core-kitabi/) (Turkish)
+
+## 本书的目标读者
+
+如果你刚开始编程，本书将在“构建最新web应用”方面，使你了解其中的模式和概念。你将以从无到有、循序渐进的方式，学习构建一个 web 应用的方法（以及合理组织各模块的方法）。对于你在编程方面所需的内容，本书不能事无巨细的涵盖，但它可以作为一个起点，引导你了解更高级的内容。
+
+如果你已经在使用诸如 Node、Python、Ruby、Go 或者 Java 之类的后端语言写程序，你会注意到很多熟悉的概念，比如 MVC、视图模板和依赖注入。你将使用 C# 进行编程，但跟你熟知的内容相去不远。
+
+如果你是一个 ASP.NET MVC 开发者，将如鱼得水。 ASP.NET Core 增添了一些新工具，并复用（及简化）了你用过的那些东西。我将在后续章节指出部分差异。
+
+不论你此前在 web 编程方面经验如何，本书都会倾囊相授，足够你借助 ASP.NET Core 创建一个简单但实用的 web 应用。你将学习如何通过前后端代码实现设计目标，如何与数据库交互，如何部署应用到真实环境。
+
+## 什么是 ASP.NET Core？
+
+ASP.NET Core 是一个由微软创建的，用于构建 web 应用、API、微服务 的 web 框架。它使用常见的模式，诸如 MVC（Model-View-Controller）、依赖注入，和一个由中间件构成的请求处理管线。它基于 Apache 2.0 许可证开放源码，就是说，源代码可以自由获取，并且欢迎社区成员以 缺陷修复 和 新功能提交 的方式进行贡献。
+
+ASP.NET Core 运行在微软的 .NET 运行时库上，类似于 Java 的 虚拟机（JVM）或者 Ruby 的解释器。有几种语言（C#，Visual Basic，F#）可以用来编写 ASP.NET Core 程序。C# 是最常见的选择，我在本书中也会采用它。你可以在 Windows、Mac，和 Linux 上构建并运行 ASP.NET Core 应用。
+
+## 又一个 web 框架，需求何在？
+
+现存的 web 框架选项已经很多了：Node/Express、Spring、Ruby on Rails、Django、Laravel 等等，数不胜数。ASP.NET Core 又有什么可取之处呢？
+
+* **速度** ASP.NET Core 很快。因为 .NET Core 是编译运行的，执行速度远高于解释执行的语言，比如 JavaScript 或者 Ruby。ASP.NET Core 也为多线程和异步任务作了专门的优化。与使用 Node.js 写的代码相比，执行速度高出 5-10 倍是很正常的。
+
+* **生态** ASP.NET Core 可能初出茅庐，但 .NET 却已久经考验。在 NuGet（.NET 的包管理系统，类似 npm、Ruby gems，或者 Maven）上有成千上万的软件包。有现成的包可用来完成 JSON 反序列化、数据库连接、PDF生成，或者几乎你能想到的任何需求。
+
+* **安全性** 微软的开发团队很注重安全性，ASP.NET Core 从构建伊始就注重安全。它已经自动处理了净化输入数据和跨域伪造请求(CSRF)，你就不需要操心这些了。你同时还享有 .NET 编译器的静态类型检测的优势，它像个时刻警惕着，还有些强迫症的审校者。这样，在使用一个变量或者某些数据时，那些无意识的错误就插翅难逃了。
+
+## .NET Core 和 .NET 标准
+
+贯穿本书，你将学习有关 ASP.NET Core （web 框架）的知识。我会偶尔提及 .NET 运行时，这个用于运行 .NET 代码的支持库。如果你看着这段已经像天书那么晦涩，直接跳到下一章吧。
+
+你可能还会听说 .NET Core 和 .NET标准，这些命名有些混乱，所以在此做一简短的释疑：
+
+**.NET 标准** 是一个平台无关的接口，它定义了特性和 API。值得指出的是，.NET 标准并不等同于任何实际的代码或者功能，仅仅是 API 的定义。.NET 标准现存多个不同的“版本”或者说级别，反映出提供 API 的数量（或者说 API 所覆盖的广度）。比如 .NET标准2.0 的 API 数量，比 .NET标准1.5 多，后者的 API 又比 .NET标准1.0 多。
+
+**.NET Core** 是可在 Windows、Mac或者Linux上安装的 .NET 运行时库。它在各个操作系统上，使用对应的平台相关代码，实现了定义于 .NET 标准中的 API。这是你将要安装到机器上，用来构建和运行 ASP.NET Core 应用程序的部分。
+
+作为对比，这里要指出， **.NET Framework** 是另一个 .NET标准 的实现，它只能运行在 Windows 上。在 .NET Core 出现并把 .NET 推向 Mac 和 Linux 之前，它是唯一的 .NET 运行时库。 ASP.NET Core 也可以跑在 Windows 专用的 .NET Framework 上，但我不会过多涉及这个主题。
+
+如果你已经被这些命名搞糊涂了，别发愁！咱们马上就要写代码进行实践了。
+
+## ASP.NET 4 开发者注意
+
+如果你从没用过 ASP.NET 以前的版本，直接看下一章去吧！
+
+ASP.NET Core 是对 ASP.NET 彻底的重写，重点关注于：让该框架应用新的开发方法，并最终使其与 System.Web、IIS、和 Windows 解耦。你要是还记得 ASP.NET 4 的 OWIN/Katana 那些内容，你就已经学会一半了： Katana 项目成了 ASP.NET 5，而后者的名字最终被改成了 ASP.NET Core。
+
+作为 Katana 的传承， `Startup` 类成了起始和中心，`Application_Start` 和 `Global.asax` 则不复存在了。整个处理管线由中间件驱动，MVC 和 Web API 不再有区别：控制器可以方便的返回视图、状态码，或者数据。依赖注入功能已经内置了，所以，如果你不想费劲的话，完全可以不用再安装并配置一个服务容器了，比如 StructureMap 或者 Ninject。整个框架已经针对速度和运行时效率进行了优化。
+
+好了，前言就到这儿。开始学习 ASP.NET Core 吧。
+
+---
+
 # The Little ASP.NET Core Book
 
 *by Nate Barbettini*

diff --git a/SUMMARY.md b/SUMMARY.md
@@ -1,35 +1,35 @@
 # Summary
 
-* [Your first application](chapters/your-first-application/README.md)
-    * [Get the SDK](chapters/your-first-application/get-the-sdk.md)
-    * [Hello World in C#](chapters/your-first-application/hello-world-in-csharp.md)
-    * [Create an ASP.NET Core project](chapters/your-first-application/create-aspnetcore-project.md)
-* [MVC basics](chapters/mvc-basics/README.md)
-    * [Create a controller](chapters/mvc-basics/create-controller.md)
-    * [Create models](chapters/mvc-basics/create-models.md)
-    * [Create a view](chapters/mvc-basics/create-view.md)
-    * [Add a service class](chapters/mvc-basics/add-service-class.md)
-    * [Use dependency injection](chapters/mvc-basics/use-dependency-injection.md)
-    * [Finish the controller](chapters/mvc-basics/finish-controller.md)
-    * [Update the layout](chapters/mvc-basics/update-the-layout.md)
-* [Add external packages](chapters/add-external-packages/README.md)
-* [Use a database](chapters/use-a-database/README.md)
-    * [Connect to a database](chapters/use-a-database/connect-to-a-database.md)
-    * [Update the context](chapters/use-a-database/update-context.md)
-    * [Create a migration](chapters/use-a-database/create-migration.md)
-    * [Create a new service class](chapters/use-a-database/create-service-class.md)
-* [Add more features](chapters/add-more-features/README.md)
-    * [Add new to-do items](chapters/add-more-features/add-todo-items.md)
-    * [Complete items with a checkbox](chapters/add-more-features/complete-with-checkbox.md)
-* [Security and identity](chapters/security-and-identity/README.md)
-    * [Require authentication](chapters/security-and-identity/require-authentication.md)
-    * [Using identity in the application](chapters/security-and-identity/using-identity-in-the-application.md)
-    * [Authorization with roles](chapters/security-and-identity/authorization-with-roles.md)
-    * [More resources](chapters/security-and-identity/more-resources.md)
-* [Automated testing](chapters/automated-testing/README.md)
-    * [Unit testing](chapters/automated-testing/unit-testing.md)
-    * [Integration testing](chapters/automated-testing/integration-testing.md)
-* [Deploy the application](chapters/deploy-the-application/README.md)
-    * [Deploy to Azure](chapters/deploy-the-application/deploy-to-azure.md)
-    * [Deploy with Docker](chapters/deploy-the-application/deploy-with-docker.md)
-* [Conclusion](chapters/conclusion/README.md)
+* [你的第一个程序](chapters/your-first-application/README.md)
+    * [获取 SDK](chapters/your-first-application/get-the-sdk.md)
+    * [C# 版的 Hello World](chapters/your-first-application/hello-world-in-csharp.md)
+    * [创建一个 ASP.NET Core 项目](chapters/your-first-application/create-aspnetcore-project.md)
+* [MVC 基础](chapters/mvc-basics/README.md)
+    * [创建控制器](chapters/mvc-basics/create-controller.md)
+    * [创建模型](chapters/mvc-basics/create-models.md)
+    * [创建视图](chapters/mvc-basics/create-view.md)
+    * [添加一个服务类](chapters/mvc-basics/add-service-class.md)
+    * [运用依赖注入](chapters/mvc-basics/use-dependency-injection.md)
+    * [完成控制器](chapters/mvc-basics/finish-controller.md)
+    * [修改布局](chapters/mvc-basics/update-the-layout.md)
+* [添加外来软件包](chapters/add-external-packages/README.md)
+* [运用数据库](chapters/use-a-database/README.md)
+    * [连接数据库](chapters/use-a-database/connect-to-a-database.md)
+    * [修改数据库上下文](chapters/use-a-database/update-context.md)
+    * [创建变更](chapters/use-a-database/create-migration.md)
+    * [创建服务类](chapters/use-a-database/create-service-class.md)
+* [添加新特性](chapters/add-more-features/README.md)
+    * [添加 待办事项 条目](chapters/add-more-features/add-todo-items.md)
+    * [使用复选框标记条目完成](chapters/add-more-features/complete-with-checkbox.md)
+* [安全和身份](chapters/security-and-identity/README.md)
+    * [提示认证](chapters/security-and-identity/require-authentication.md)
+    * [在程序中使用身份](chapters/security-and-identity/using-identity-in-the-application.md)
+    * [按角色进行授权](chapters/security-and-identity/authorization-with-roles.md)
+    * [附加资源](chapters/security-and-identity/more-resources.md)
+* [自动化测试](chapters/automated-testing/README.md)
+    * [单元测试](chapters/automated-testing/unit-testing.md)
+    * [集成测试](chapters/automated-testing/integration-testing.md)
+* [部署程序](chapters/deploy-the-application/README.md)
+    * [部署到 Azure](chapters/deploy-the-application/deploy-to-azure.md)
+    * [使用 Docker 进行部署](chapters/deploy-the-application/deploy-with-docker.md)
+* [结束语](chapters/conclusion/README.md)
diff --git a/book.json b/book.json
@@ -1,17 +1,21 @@
 {
-    "title": "The Little ASP.NET Core Book",
-    "description": "A friendly introduction to building web applications with the ASP.NET Core framework.",
+    "title": "简明 ASP.NET Core 手册",
+    "description": "一个关于“使用 ASP.NET Core 框架的构建 web 应用程序”的入门简介。",
     "author": "Nate Barbettini",
-    "isbn": "978-1-387-75615-5",
+    "language": "zh-hans",
     "pdf": {
+        "fontSize": 13,
         "paperSize": "a5",
-        "fontFamily": "Lato"
+        "fontFamily": "Microsoft YaHei"
     },
-    "plugins": ["expandable-chapters-small", "anchors", "forkmegithub"],
+    "plugins": ["expandable-chapters-small", "disqus", "splitter", "anchors", "copy-code-button", "forkmegithub"],
     "pluginsConfig": {
+        "disqus": {
+            "shortName": "little-aspnetcore-book-cn"
+        },
         "forkmegithub": {
-            "color": "green",
-            "url": "https://github.com/nbarbettini/little-aspnetcore-book"
+            "color": "orange",
+            "url": "https://github.com/windsting/little-aspnetcore-book"
         }
     }
-}
+}
diff --git a/book/CONTRIBUTING.md b/book/CONTRIBUTING.md
@@ -0,0 +1,29 @@
+# 参与方式
+
+重要的先说：这本 简明 ASP.NET Core 手册 基于 [Creative Commons Attribution](https://creativecommons.org/licenses/by/4.0/)（[创作共用署名4.0](https://creativecommons.org/licenses/by/4.0/deed.zh)）许可证，这意味着，欢迎你按自己的意愿复制、分发、克隆、重排本书中的资料。我仅有的要求就是，你要指出原作者（Nate Barbettini）。当然，中文版请别忘了译者：windsting 和 yuyi。
+
+## 发现错误？
+
+如果你看到错别字或者有问题的代码，欢迎修正它。我们乐于接受 pull request。
+
+如果你不熟悉 Git 或者用不惯它，也没关系。可以在 [登记问题](https://github.com/windsting/little-aspnetcore-book/issues) 页面指出这个错误。请写得尽量详细一些。
+
+## 欢迎建议
+
+如果你有什么建议，欢迎提交一个 [议题](https://github.com/windsting/little-aspnetcore-book/issues) 或者发邮件到 [email protected] 给我。我不一定回复所有来信，但我会尽量都读一下。
+
+---
+
+# How to contribute
+
+First things first: the Little ASP.NET Core Book is licensed under the [Creative Commons Attribution](https://creativecommons.org/licenses/by/4.0/) license, which means you are welcome to copy, redistribute, fork, or remix the material in the book as much as you want. All I ask is that you give credit to the original author (Nate Barbettini).
+
+## Notice a problem?
+
+If you see a typo or a code error, feel free to fix it. Pull requests are gladly accepted!
+
+If you're not familiar or comfortable with Git, that's fine. [File an issue](https://github.com/nbarbettini/little-aspnetcore-book/issues) to point out the error. Please be as detailed as possible.
+
+## Suggestions are welcome
+
+If you have a suggestion, feel free to file an [issue](https://github.com/nbarbettini/little-aspnetcore-book/issues) or email me at [email protected]. I can't promise I will be able to respond to every suggestion, but I'll read as many as I can.