@@ -8,12 +8,12 @@ figure
This is a practical guide to Angular for experienced programmers who
are building client applications in HTML and #{langName}.
这是一个 Angular实战指南。面向的是正在使 用HTML和#{langName}构建客户端应用的有经验的程序员。
这是一份 Angular实战指南。面向的是正在用HTML和#{langName}构建客户端应用的、 有经验的程序员。
We are on a journey together to understand how Angular works and, more importantly,
how to make it work for us. This overview begins the journey.
在这次旅程中，我们将一起理解Angular是如何工作的，以及 —— 更重要的 —— 如何让它为我们工作。此 概览就是本 次旅程的起点。
在这次旅程中，我们将一起理解Angular是如何工作的，以及 —— 更重要的 —— 如何让它为我们工作。本 概览就是这 次旅程的起点。
<br clear="all">
// #enddocregion intro
@@ -26,7 +26,7 @@ figure
The documentation is divided into major thematic sections, each
a collection of chapters devoted to that theme.
本文档被 分成了几个主题区域，每一组中的 章节都是围绕所属 主题的。
本文档分成几大主题区，区里的一组 章节都是围绕那个 主题的。
// #enddocregion how-to-read-1
// #docregion how-to-read-2
- var top="vertical-align:top"
@@ -34,7 +34,9 @@ table(width="100%")
col(width="15%")
col
tr(style=top)
td <b>Tutorial</b> <b>教程</b>
td
p <b>Tutorial</b>
p <b>教程</b>
td
:marked
A step-by-step, immersive approach to learning Angular.
@@ -43,57 +45,67 @@ table(width="100%")
followed by the [*Tour of Heroes* tutorial](../tutorial) that
introduces the major features of Angular in an application context.
一个 按部就班、沉浸式的Angular学习之旅。
一场 按部就班、沉浸式的Angular学习之旅。
从[QuickStart](../quickstart.html)开始，本文档中的每一个章节和范例，都基于一个[*英雄指南* 教程](../tutorial)，
它会在一个假想的应用场景中逐步引出Angular的各个主要特性。
tr(style=top)
td <b>Basics</b> <b>基础</b>
td
p <b>Basics</b>
p <b>基础</b>
td
:marked
The essential ingredients of Angular development.
Angular开发中必不可少的要素。
tr(style=top)
td <b>Developer Guide</b> <b>开发人员指南</b>
td
p <b>Developer Guide</b>
p <b>开发人员指南</b>
td
:marked
In depth analysis of Angular features and development practices.
深入分析Angular的特性和开发实践。
tr(style=top)
td <b>Cookbook</b> <b>菜谱</b>
td
p <b>Cookbook</b>
p <b>烹饪书</b>
td
:marked
Recipes for specific application challenges, mostly code snippets with a minimum of exposition.
解决实际应用中某些特定挑战的食谱，大部分是代码片段，以及 少量的详细阐述。
一组 解决实际应用中某些特定挑战的食谱，大部分是代码片段，也有 少量的详细阐述。
tr(style=top)
td <b>Reference</b> <b>参考</b>
td
p <b>Reference</b>
p <b>参考</b>
td
:marked
Angular-specific reference material, most notably the [API Guide](../api)
with its authoritative details about each member in the Angular libraries.
Angular特有 的参考资料，最受欢迎的[API 指南](../api)，包括Angular库中每一个成员的权威资料。
特定于 Angular的参考资料，最受欢迎的[API 指南](../api)，包括Angular库中每一个成员的详尽、 权威的 资料。
tr(style=top)
td <b>Resources</b> <b>资源</b>
td
p <b>Resources</b>
p <b>资源</b>
td
:marked
Other places to go for help and information.
可用来 获得帮助和 获取消息的其它去处 。
可以 获得帮助、 获取消息的其它地方 。
:marked
# Learning Path
# 学习路径
We don't have to read the guide straight through. Most chapters stand on their own.
我们并不需要从头到尾的 阅读本指南。大部分章节都是独立的。
我们并不需要从头到尾依次 阅读本指南。大部分章节都是独立的。
We recommend a learning path for those new to Angular.
Most of that path runs through the *Basics* section:
我们推荐一个 给Angular新手的 学习路径。
这条 路径的大部分章节 都在 *基础知识* 区。
这里我们只 给Angular新手推荐一个 学习路径。
此 路径上 的大部分文 章都在*基础知识*区。
1. Read the [Architecture Overview](architecture.html) to get the big picture.
@@ -102,21 +114,21 @@ table(width="100%")
1. Try the [QuickStart](../quickstart.html). The QuickStart is the "Hello, World" of Angular 2.
It shows us how to setup the libraries and tools we'll need to write *any* Angular app.
1. 尝 试[QuickStart](../quickstart.html)。QuickStart是Angular 2世界中的“Hello, World”。
它会告诉我们如何安装写 *任何* Angular应用都会用到的那些库和工具。
1. 试用 [QuickStart](../quickstart.html)。QuickStart是Angular 2世界中的“Hello, World”。
它会告诉我们如何安装写*任何*Angular应用时 都会用到的那些库和工具。
1. Take the *Tour of Heroes* [Tutorial](../tutorial) which picks up from where the QuickStart leaves off
and builds a simple data-driven app.
Simple, yes, but with the essential characteristics we'd expect of a professional application:
a sensible project structure, data binding, master/detail, services, dependency injection, navigation, and remote data access.
1. 学习 *英雄指南* [教程](../tutorial) ，它将从QuickStart出发，最终构建出一个简单的“数据驱动”的应用。
确实 简单，但具备了 我们写一个专业应用时所需的一切基本特性：
1. 学习*英雄指南*[教程](../tutorial) ，它将从QuickStart出发，最终构建出一个简单的“数据驱动”的应用。
它虽 简单，但也具有 我们写一个专业应用时所需的一切基本特性：
实用的项目结构、数据绑定、主从视图、服务、依赖注入、导航，以及远程数据访问。
Return to the *Basics* section and continue in the suggested order:
返回 *基础知识* 区，继续按建议的顺序推 进：
返回*基础知识*区，继续按建议的顺序前 进：
1. [Displaying Data](displaying-data.html) explains how to get information on to the screen.
@@ -124,24 +136,24 @@ table(width="100%")
1. [User Input](user-input.html) covers the basics of responding to user behavior.
1. [用户输入](user-input.html)覆盖了响应用户行为的基本原理 。
1. [用户输入](user-input.html)覆盖了响应用户行为的基本方法 。
1. [Forms](forms.html) handle user data entry and validation within the UI.
1. [表单](forms.html)处理用户输入的数据，并且 在UI中进行有效性验证。
1. [表单](forms.html)处理用户输入的数据，并在UI中进行有效性验证。
1. [Dependency Injection](dependency-injection.html) is the way we build large, maintainable applications
from small, single purpose parts.
1. [依赖注入](dependency-injection.html)这种方式，让我们能把小型、单一用途的部件组装成大型可维护的应用。
1. [依赖注入](dependency-injection.html)这种方式，让我们能把小型、单一用途的部件组装成大型、 可维护的应用。
1. [Template Syntax](template-syntax.html) is a comprehensive study of Angular template HTML.
1. [模板语法](template-syntax.html)是对Angular模板HTML的全面研究 。
1. [模板语法](template-syntax.html)是对Angular模板HTML的全面讲解 。
With this foundation, we can read and understand any chapter in the guide.
有了这些基础，我们可以阅读和理解本指南中的任何章节。
有了这些基础，我们就 可以阅读和理解本指南中的任何章节了 。
// #enddocregion how-to-read-2
// #docregion the-rest
:marked
@@ -151,13 +163,13 @@ table(width="100%")
Every chapter includes code snippets that we can reuse in our own applications.
These snippets are excerpts from a sample application that accompanies the chapter.
每个章节中 都包含一些能在我们自己的应用中复用的代码片段。
这些片段节选自该章节 附带的范例应用。
每一章 都包含一些能在我们自己的应用中复用的代码片段。
这些片段节选自那一章 附带的范例应用。
Look for a link to a running version of that sample near the top of each page
such as this [live example](/resources/live-examples/architecture/ts/plnkr.html) from the [Architecture](architecture.html) chapter.
在每页靠近顶部的地方可以看到一个链接，指向这个范例的运 行版本，比如[架构](architecture.html)一章中的[在线例子](/resources/live-examples/architecture/ts/plnkr.html)。
在每页靠近顶部的地方都 可以看到一个链接，指向这个范例的可执 行版本，比如[架构](architecture.html)一章中的[在线例子](/resources/live-examples/architecture/ts/plnkr.html)。
The link launches a browser-based code editor where we can inspect, modify, save, and download the code.
@@ -168,10 +180,10 @@ table(width="100%")
They highlight key points in code rather than explain each step necessary to build the sample.
We can always get the full source by way of the live link.
少量早期的 章节是作为教程来写的，并且 被清晰地 标注出来。
但大部分章节都不是 教程。
少量早期章节是作为教程来写的，并被清晰的 标注出来。
但大部分章节都不在 教程中 。
它们的目的是展示代码中的关键点，而不是解释构建这个范例所需的每一个步骤。
我们总能 从在线例子的链接找到完整的源代码。
我们可以 从在线例子的链接找到完整的源代码。
## References
## 参考资料
@@ -182,25 +194,25 @@ table(width="100%")
The [Glossary](glossary.html) defines terms that Angular developers should know.
[词汇表](glossary.html)定义了Angular开发者所 需要知道的词汇。
[词汇表](glossary.html)定义了Angular开发者需要知道的词汇。
The [API Guide](../api/) is the authority on every public-facing member of the Angular libraries.
[API指南](../api/)是关于Angular库中每一个公开 成员的权威指南。
[API指南](../api/)是关于Angular库中每一个公有 成员的权威指南。
# Feedback
# 提供反馈
We welcome feedback! Leave a comment by clicking the icon in upper right corner of the banner.
我们欢迎 您的反馈！请点击Banner右上角的图标，给我们留言。
我们期待 您的反馈！请点击Banner右上角的图标，给我们留言。
Post *documentation* issues and pull requests on the
[angular.io](https://github.com/angular/angular.io) github repository.
要发 *文档方面* 的问题和 Pull Requests，请来 Github上的[angular.io](https://github.com/angular/angular.io)仓库。
如果是 *文档方面*的问题或 Pull Requests，请到 Github上的[angular.io](https://github.com/angular/angular.io)仓库。
Post issues with *Angular 2 itself* to the [angular](https://github.com/angular/angular) github repository.
要发 *Angular 2本身* 的问题，请来 Github上的[angular](https://github.com/angular/angular)仓库。
如果是 *Angular 2本身*的问题，请到 Github上的[angular](https://github.com/angular/angular)仓库。
// #enddocregion the-rest
Zhicheng Wang