translate: setup-systemjs-anatomy.jade.

This commit is contained in:
rexebin 2016-11-27 20:04:21 +00:00
parent b01dc2c2f0
commit 1b38b5b200

View File

@ -5,28 +5,48 @@ block includes
The documentation [setup](setup.html) procedures install a _lot_ of files, The documentation [setup](setup.html) procedures install a _lot_ of files,
Most of them can be safely ignored. Most of them can be safely ignored.
在[搭建](setup.html)本地开发环境的过程中会安装*很多*文件。它们大部分都可以被忽略掉。
Application files _inside the_ **`app/`** and **`e2e/`** folders matter most to developers. Application files _inside the_ **`app/`** and **`e2e/`** folders matter most to developers.
对程序员来讲最重要的是在 *`app/`* 和 *`e2e/`* 文件夹*之内*的应用文件。
Files _outside_ those folders condition the development environment. Files _outside_ those folders condition the development environment.
They rarely change and you may never view or modify them. They rarely change and you may never view or modify them.
If you do, this page can help you understand their purpose. If you do, this page can help you understand their purpose.
在这两个文件夹*之外*的文件为开发环境设定条件。
这些文件很少会需要变动,你可能永远都不需要阅览或者修改它们。
style td, th {vertical-align: top} style td, th {vertical-align: top}
table(width="100%") table(width="100%")
col(width="10%") col(width="10%")
col(width="90%") col(width="90%")
tr tr
th File th
th Purpose :marked
File
文件
th
:marked
Purpose
用途
tr tr
td <code>app/...</code> td <code>app/...</code>
td td
:marked :marked
Your Angular application files. Your Angular application files.
你的 Angular 应用文件。
Ships with the "Hello Angular" sample's Ships with the "Hello Angular" sample's
`AppComponent`, `AppModule`, a component unit test (`app.component.spec.ts`), and `AppComponent`, `AppModule`, a component unit test (`app.component.spec.ts`), and
the bootstrap file, `main.ts`. the bootstrap file, `main.ts`.
"Hello Angular" 这个例子中有 `AppComponent`、`AppModule`、 一个组件单元测试 (`app.component.spec.ts`) 以及引导文件 `main.ts`。
tr tr
td <code>e2e/...</code> td <code>e2e/...</code>
td td
@ -36,12 +56,20 @@ table(width="100%")
<a href="http://www.protractortest.org/" target="_blank" title="Protractor: end-to-end testing for Angular">protractor</a> <a href="http://www.protractortest.org/" target="_blank" title="Protractor: end-to-end testing for Angular">protractor</a>
e2e test runner. e2e test runner.
应用的*端对端*(e2e)测试,用 Jasmine 写成并用 <a href="http://www.protractortest.org/" target="_blank" title="Protractor:Angular 的端对端测试">protractor</a> 端对端测试运行器测试。
Initialized with an e2e test for the "Hello Angular" sample. Initialized with an e2e test for the "Hello Angular" sample.
初始化后,有个"Hello Angular" 的例子的端对端测试。
tr tr
td <code>node_modules/...</code> td <code>node_modules/...</code>
td td
:marked :marked
The _npm_ packages installed with the `npm install` command. The _npm_ packages installed with the `npm install` command.
用 `npm install` 命令安装的 *npm* 包。
tr tr
td td
code. code.
@ -52,18 +80,33 @@ table(width="100%")
td td
:marked :marked
Tooling configuration files and folders. Tooling configuration files and folders.
配置文件和文件夹的工具。
Ignore them until you have a compelling reason to do otherwise. Ignore them until you have a compelling reason to do otherwise.
除非非常必要,否则可以忽略。
tr tr
td <code>CHANGELOG.md</code> td <code>CHANGELOG.md</code>
td td
:marked :marked
The history of changes to the _QuickStart_ repository. The history of changes to the _QuickStart_ repository.
*快速起步*库的更新历史。
Delete or ignore. Delete or ignore.
删除或忽略。
tr tr
td <code>favicon.ico</code> td <code>favicon.ico</code>
td td
:marked :marked
The application icon that appears in the browser tab. The application icon that appears in the browser tab.
出现在浏览器标签上的应用图标。
tr tr
td <code>index.html</code> td <code>index.html</code>
td td
@ -73,34 +116,57 @@ table(width="100%")
Then it boots the application, placing the root `AppComponent` Then it boots the application, placing the root `AppComponent`
in the custom `<my-app>` body tag. in the custom `<my-app>` body tag.
应用的宿主页面。
它以特定的顺序加载一些基本脚本。
然后它启动应用,将根`AppComponent`放置到自定义`<my-app>`标签里。
The same `index.html` satisfies all documentation application samples. The same `index.html` satisfies all documentation application samples.
同一个 `index.html`满足所有文档应用例子。
tr tr
td <code>karma.conf.js</code> td <code>karma.conf.js</code>
td td
:marked :marked
Configuration for the <a href="https://karma-runner.github.io/1.0/index.html" target="_blank" title="Karma unit test runner">karma</a> Configuration for the <a href="https://karma-runner.github.io/1.0/index.html" target="_blank" title="Karma unit test runner">karma</a>
test runner described in the [Testing](testing.html) guide. test runner described in the [Testing](testing.html) guide.
在[测试](testing.html)指南中提到的 <a href="https://karma-runner.github.io/1.0/index.html" target="_blank" title="Karma测试运行器">karma</a> 测试运行器的配置。
tr tr
td <code>karma-test-shim.js</code> td <code>karma-test-shim.js</code>
td td
:marked :marked
Script to run <a href="https://karma-runner.github.io/1.0/index.html" target="_blank" title="Karma unit test runner">karma</a> Script to run <a href="https://karma-runner.github.io/1.0/index.html" target="_blank" title="Karma unit test runner">karma</a>
with SystemJS as described in the [Testing](testing.html) guide. with SystemJS as described in the [Testing](testing.html) guide.
在[测试](testing.html)指南中提到的 <a href="https://karma-runner.github.io/1.0/index.html" target="_blank" title="Karma测试运行器">karma</a> 测试运行器的脚本。
tr tr
td <code>LICENSE</code> td <code>LICENSE</code>
td td
:marked :marked
The open source MIT license to use this setup code in your application. The open source MIT license to use this setup code in your application.
应用的搭建代码中用到的开源 MIT 许可证。
tr tr
td <code>package.json</code> td <code>package.json</code>
td td
:marked :marked
Identifies `npm `package dependencies for the project. Identifies `npm `package dependencies for the project.
为项目指定`npm`依赖包。
Contains command scripts for running the application, Contains command scripts for running the application,
running tests, and more. Enter `npm run` for a listing. running tests, and more. Enter `npm run` for a listing.
<a href="https://github.com/angular/quickstart/blob/master/README.md#npm-scripts" <a href="https://github.com/angular/quickstart/blob/master/README.md#npm-scripts"
target="_blank" title="npm scripts for Angular documentation samples">Read more</a> about them. target="_blank" title="npm scripts for Angular documentation samples">Read more</a> about them.
包含了一些命令脚本,用来运行应用、运行测试与其他。输入`npm run`来查看命令列表。
到<a href="https://github.com/angular/quickstart/blob/master/README.md#npm-scripts"
target="_blank" title="Angular 文档例子的 npm 脚本">这里</a>阅读更多关于它们的说明。
tr tr
td <code>protractor.config.js</code> td <code>protractor.config.js</code>
td td
@ -108,28 +174,40 @@ table(width="100%")
Configuration for the Configuration for the
<a href="http://www.protractortest.org/" target="_blank" title="Protractor: end-to-end testing for Angular">protractor</a> <a href="http://www.protractortest.org/" target="_blank" title="Protractor: end-to-end testing for Angular">protractor</a>
_end-to-end_ (e2e) test runner. _end-to-end_ (e2e) test runner.
<a href="http://www.protractortest.org/" target="_blank" title="Protractor: Angular 的端对端测试">protractor</a> *端对端* (e2e) 测试器运行器的配置。
tr tr
td <code>README.md</code> td <code>README.md</code>
td td
:marked :marked
Instruction for using this git repository in your project. Instruction for using this git repository in your project.
Worth reading before deleting. Worth reading before deleting.
项目中使用这个 git 库的说明。
在删除前值得阅读。
tr tr
td <code>styles.css</code> td <code>styles.css</code>
td td
:marked :marked
Global styles for the application. Initialized with an `<h1>` style for the QuickStart demo. Global styles for the application. Initialized with an `<h1>` style for the QuickStart demo.
应用的全局样式。初始化后,有个为《快速起步》演示准备的`<h1>`样式。
tr tr
td <code>systemjs<br>.config.js</code> td <code>systemjs<br>.config.js</code>
td td
:marked :marked
Tells the **SystemJS** module loader where to find modules Tells the **SystemJS** module loader where to find modules
referenced in JavaScript `import` statements such as referenced in JavaScript `import` statements such as
为 **SystemJS** 模块加载器指定去哪儿查找在 JavaScript 的`import`语句中引用的模块。
code-example(language="ts"). code-example(language="ts").
import { Component } from '@angular/core; import { Component } from '@angular/core;
:marked :marked
Don't touch this file unless you are fully versed in SystemJS configuration. Don't touch this file unless you are fully versed in SystemJS configuration.
除非你完全理解 SystemJS 的配置,不要修改它。
tr tr
td <code>systemjs<br>.config.extras.js</code> td <code>systemjs<br>.config.extras.js</code>
td td
@ -137,18 +215,29 @@ table(width="100%")
Optional extra SystemJS configuration. Optional extra SystemJS configuration.
A way to add SystemJS mappings, such as for appliation _barrels_, A way to add SystemJS mappings, such as for appliation _barrels_,
without changing the original `system.config.js`. without changing the original `system.config.js`.
可选的额外 SystemJS 配置。
是添加 SystemJS 映射的途径,例如在无需修改原始`systemjs.config.js`的情况下为应用映射*封装桶*。
tr tr
td <code>tsconfig.json</code> td <code>tsconfig.json</code>
td td
:marked :marked
Tells the TypeScript compiler how to transpile TypeScript source files Tells the TypeScript compiler how to transpile TypeScript source files
into JavaScript files that run in all modern browsers. into JavaScript files that run in all modern browsers.
为 TypeScript 编译器指定如何将 TypeScript 代码转换为 JavaScript 文件,用来在所有现代浏览器中运行。
tr tr
td <code>tslint.json</code> td <code>tslint.json</code>
td td
:marked :marked
The `npm` installed TypeScript linter inspects your TypeScript code The `npm` installed TypeScript linter inspects your TypeScript code
and complains when you violate one of its rules. and complains when you violate one of its rules.
利用`npm`安装的 TypeScript 语法检查器 (linter) 检测 TypeScript 代码并在你违反它的规则时提示你。
This file defines linting rules favored by the This file defines linting rules favored by the
[Angular style guide](style-guide.html) and by the authors of the documentation. [Angular style guide](style-guide.html) and by the authors of the documentation.
该文件定义了 [Angular 风格指南](style-guide.html)与本文档站作者喜爱的语法检查规则。