translate: quickstart and guide/index

This commit is contained in:
Rex YE 2016-11-27 09:37:30 +00:00
parent d3b8683c3d
commit 1b3f40425d
2 changed files with 40 additions and 2 deletions

View File

@ -113,15 +113,25 @@ table(width="100%")
## Code samples ## Code samples
## 代码例子
Each page includes code snippets from a sample application that accompanies the page. Each page includes code snippets from a sample application that accompanies the page.
You can reuse these snippets in your applications. You can reuse these snippets in your applications.
每章都包含了该章附带例子应用的代码片段。你可以在你的应用中再利用这些代码片段。
Look for a link to a running version of that sample, often near the top of the page, Look for a link to a running version of that sample, often near the top of the page,
such as this <live-example name="architecture"></live-example> from the [Architecture](architecture.html) page. such as this <live-example name="architecture"></live-example> from the [Architecture](architecture.html) page.
<span if-docs="ts"> <span if-docs="ts">
The link launches a browser-based, code editor where you can inspect, modify, save, and download the code. The link launches a browser-based, code editor where you can inspect, modify, save, and download the code.
</span> </span>
查找这些例子在线版本的链接,通常在页面的开头部分附近。
例如[架构](architecture.html)章的<live-example name="architecture">在线例子</live-example>。
<span if-docs="ts">
该链接启动浏览器代码编辑器,你可以查看、修改、保存和下载代码。
</span>
## Reference pages ## Reference pages
## 参考资料 ## 参考资料
@ -157,4 +167,3 @@ table(width="100%")
* Use the <a href="!{_ngRepoURL}" target="_blank" title="angular source on github">Angular Github repository</a> to report issues with **Angular** itself. * Use the <a href="!{_ngRepoURL}" target="_blank" title="angular source on github">Angular Github repository</a> to report issues with **Angular** itself.
- 到<a href="!{_ngRepoURL}" target="_blank" title="angular source on github">Angular Github 库</a>报告与**Angular本身**有关的issues。 - 到<a href="!{_ngRepoURL}" target="_blank" title="angular source on github">Angular Github 库</a>报告与**Angular本身**有关的issues。

View File

@ -4,19 +4,31 @@ block includes
:marked :marked
Angular applications are made of _components_. Angular applications are made of _components_.
Angular应用是由*组件*组成的。
A _component_ is the combination of an HTML template and a component class that controls a portion of the screen. Here is an example of a component that displays a simple string: A _component_ is the combination of an HTML template and a component class that controls a portion of the screen. Here is an example of a component that displays a simple string:
*组件*由HTML模板和组件类组成组件类控制视图。下面是一个显示简单字符串的组件:
+makeExample('app/app.component.ts')(format='.') +makeExample('app/app.component.ts')(format='.')
:marked :marked
You can try this out without installing anything. Open the <live-example>QuickStart example !{_on_Plunkr}</live-example> in another tab You can try this out without installing anything. Open the <live-example>QuickStart example !{_on_Plunkr}</live-example> in another tab
and follow along. and follow along.
无需安装任何东西,你就可以试试它。在另一个浏览器标签页打开并跟随<live-example>Plunkr上的《快速开始》例子</live-example>。
Every component begins with an `@Component` [!{_decorator}](glossary.html#!{_decorator} '"!{_decorator}" explained') Every component begins with an `@Component` [!{_decorator}](glossary.html#!{_decorator} '"!{_decorator}" explained')
<span if-docs="ts">function</span> that <span if-docs="ts">function</span> that
<span if-docs="ts">takes a _metadata_ object. The metadata object</span> describes how the HTML template and component class work together. <span if-docs="ts">takes a _metadata_ object. The metadata object</span> describes how the HTML template and component class work together.
每个组件都以`@Component`[装饰器](glossary.html#!{_decorator} '"!{_decorator}" explained')<span if-docs="ts">函数</span>开始,它<span if-docs="ts">接受一个_元数据_对象参数。该元素对象</span>描述了HTML模板和组件类是如何一起工作的。
The `selector` property tells Angular to display the component inside a custom `<my-app>` tag in the `index.html`. The `selector` property tells Angular to display the component inside a custom `<my-app>` tag in the `index.html`.
`selector`属性告诉 Angular 在`index.html`中的自定义`<my-app>`标签里显示该组件。
+makeExample('index.html','my-app','index.html (inside <body>)')(format='.') +makeExample('index.html','my-app','index.html (inside <body>)')(format='.')
:marked :marked
The `template` property defines a message inside an `<h1>` header. The `template` property defines a message inside an `<h1>` header.
@ -24,22 +36,39 @@ block includes
which is an Angular [interpolation binding](guide/displaying-data.html) expression. which is an Angular [interpolation binding](guide/displaying-data.html) expression.
At runtime, Angular replaces `{{name}}` with the value of the component's `name` property. At runtime, Angular replaces `{{name}}` with the value of the component's `name` property.
`template`属性定义了`<h1>`标题的一条消息。
该消息以“Hello”开始以 Angular [插值绑定](guide/displaying-data.html)表达式`{{name}}`结束。
在运行时Angular 用组件的`name`属性值替换`{{name}}`。
In the example, change the component class's `name` property from `'Angular'` to `'World'` and see what happens. In the example, change the component class's `name` property from `'Angular'` to `'World'` and see what happens.
在本例中,将组件类的`name`属性从`'Angular'`改为`'World'`,看看会发生什么。
Interpolation binding is one of many Angular features you'll discover in this documentation. Interpolation binding is one of many Angular features you'll discover in this documentation.
插值绑定是 Angular 的特征之一。你将在本文档中探索更多 Angular 的特征。
+ifDocsFor('ts') +ifDocsFor('ts')
.callout.is-helpful .callout.is-helpful
header A word about TypeScript header A word about TypeScript
header 关于 TypeScript
p. p.
This example is written in <a href="http://www.typescriptlang.org/" target="_blank" title="TypeScript">TypeScript</a>, a superset of JavaScript. Angular This example is written in <a href="http://www.typescriptlang.org/" target="_blank" title="TypeScript">TypeScript</a>, a superset of JavaScript. Angular
uses TypeScript because its types make it easy to support developer productivity with tooling. You can also write Angular code in JavaScript; <a href="cookbook/ts-to-js.html">this guide</a> explains how. uses TypeScript because its types make it easy to support developer productivity with tooling. You can also write Angular code in JavaScript; <a href="cookbook/ts-to-js.html">this guide</a> explains how.
p.
本例是用 JavaScript 的一个超集 <a href="http://www.typescriptlang.org/" target="_blank" title="TypeScript">TypeScript</a> 编写的。
Angular 使用 TypeScript 是因为它的类型可以帮助工具提高开发者效率。你也可以用 JavaScript 编写 Angular 代码,参见<a href="cookbook/ts-to-js.html">本指南</a>。
.l-sub-section .l-sub-section
:marked :marked
### Next step ### Next step
### 下一步
To learn how to write a real application, your next step is to set up a local development To learn how to write a real application, your next step is to set up a local development
environment and begin exploring with code. The [**Developer Guide**](guide/index.html) environment and begin exploring with code. The [**Developer Guide**](guide/index.html)
shows you how. shows you how.
要学习如何编写应用,你的下一步是构建本地开发环境,并开始一边编程一边探索,参见[**开发者指南**](guide/index.html)。