Angular

The documentation setup procedures install a lot of files. Most of them can be safely ignored.

在搭建本地开发环境的过程中会安装很多文件。它们大部分都可以被忽略掉。

Application files inside the src/ and e2e/ folders matter most to developers.

对程序员来讲最重要的是在 src/ 和 e2e/ 文件夹之内的应用文件。

Files outside those folders condition the development environment. They rarely change and you may never view or modify them. If you do, this page can help you understand their purpose.

在这两个文件夹之外的文件为开发环境设定条件。这些文件很少会需要变动，你可能永远都不需要阅览或者修改它们。

File 文件	Purpose 用途
`src/app/`	Angular application files go here. 你的 Angular 应用文件。 Ships with the "Hello Angular" sample's `AppComponent`, `AppModule`, a component unit test (`app.component.spec.ts`), and the bootstrap file, `main.ts`. "Hello Angular" 这个例子中有 `AppComponent`、`AppModule`、一个组件单元测试 (`app.component.spec.ts`) 以及引导文件 `main.ts`。 Try the sample application and the unit test as live examples. 在live example中试试范例程序和单元测试
`e2e/`	End-to-end (e2e) tests of the application, written in Jasmine and run by the protractor e2e test runner. 应用的端对端(e2e)测试，用 Jasmine 写成并用 protractor 端对端测试运行器测试。 Initialized with an e2e test for the "Hello Angular" sample. 初始化后，有个“Hello Angular” 的例子的端对端测试。
`node_modules/`	The npm packages installed with the `npm install` command. 用 `npm install` 命令安装的 npm 包。
`.editorconfig .git/ .gitignore .travis.yml`	Tooling configuration files and folders. 配置文件和文件夹的工具。 Ignore them until you have a compelling reason to do otherwise. 除非非常必要，否则可以忽略。
`CHANGELOG.md`	The history of changes to the QuickStart repository. 快速起步库的更新历史。 Delete or ignore. 删除或忽略。
`favicon.ico`	The application icon that appears in the browser tab. 出现在浏览器标签上的应用图标。
`index.html`	The application host page. It loads a few essential scripts in a prescribed order. Then it boots the application, placing the root `AppComponent` in the custom `<my-app>` body tag. 应用的宿主页面。它以特定的顺序加载一些基本脚本。然后它启动应用，将根`AppComponent`放置到自定义`<my-app>`标签里。 The same `index.html` satisfies all documentation application samples. 同一个 `index.html`满足所有文档应用例子。
`karma.conf.js`	Configuration for the karma test runner described in the Testing guide. 在测试指南中提到的 karma 测试运行器的配置。
`karma-test-shim.js`	Script to run karma with SystemJS as described in the Testing guide. 在测试指南中提到的 karma 测试运行器的脚本。
`non-essential-files.txt`	A list of files that you can delete if you want to purge your setup of the original QuickStart Seed testing and git maintainence artifacts. See instructions in the optional Deleting non-essential files section. Do this only in the beginning to avoid accidentally deleting your own tests and git setup! 这个列表中的文件在清理时可以删除，它是原始的“快速起步”种子工程中的测试和git维护文件。步骤参见可选的删除非必要文件部分。只在最初做这件事，以免不小心删除了你自己的测试文件和git配置！
`LICENSE`	The open source MIT license to use this setup code in your application. 应用的搭建代码中用到的开源 MIT 许可证。
`package.json`	Identifies `npm`package dependencies for the project. 为项目指定`npm`依赖包。 Contains command scripts for running the application, running tests, and more. Enter `npm run` for a listing. Read more about them. 包含了一些命令脚本，用来运行应用、运行测试与其他。输入`npm run`来查看命令列表。到这里阅读更多关于它们的说明。
`protractor.config.js`	Configuration for the protractor end-to-end (e2e) test runner. protractor 端对端 (e2e) 测试器运行器的配置。
`README.md`	Instruction for using this git repository in your project. Worth reading before deleting. 项目中使用这个 git 库的说明。在删除前值得阅读。
`styles.css`	Global styles for the application. Initialized with an `<h1>` style for the QuickStart demo. 应用的全局样式。初始化后，有个为《快速起步》演示准备的`<h1>`样式。
`systemjs .config.js`	Tells the SystemJS module loader where to find modules referenced in JavaScript `import` statements. For example: 为 SystemJS 模块加载器指定去哪儿查找在 JavaScript 的`import`语句中引用的模块。例如： import { Component } from '@angular/core; Don't touch this file unless you are fully versed in SystemJS configuration. 除非你完全理解 SystemJS 的配置，不要修改它。
`systemjs .config.extras.js`	Optional extra SystemJS configuration. A way to add SystemJS mappings, such as for appliation barrels, without changing the original `system.config.js`. 可选的额外 SystemJS 配置。是添加 SystemJS 映射的途径，例如在无需修改原始`systemjs.config.js`的情况下为应用映射封装桶。
`tsconfig.json`	Tells the TypeScript compiler how to transpile TypeScript source files into JavaScript files that run in all modern browsers. 为 TypeScript 编译器指定如何将 TypeScript 代码转换为 JavaScript 文件，用来在所有现代浏览器中运行。
`tslint.json`	The `npm` installed TypeScript linter inspects your TypeScript code and complains when you violate one of its rules. 利用`npm`安装的 TypeScript 语法检查器 (linter) 检测 TypeScript 代码并在你违反它的规则时提示你。 This file defines linting rules favored by the Angular style guide and by the authors of the documentation. 该文件定义了 Angular 风格指南与本文档站作者喜爱的语法检查规则。

File

文件

Purpose

用途

src/app/

Angular application files go here.

你的 Angular 应用文件。

Ships with the "Hello Angular" sample's AppComponent, AppModule, a component unit test (app.component.spec.ts), and the bootstrap file, main.ts.

"Hello Angular" 这个例子中有 AppComponent、AppModule、一个组件单元测试 (app.component.spec.ts) 以及引导文件 main.ts。

Try the sample application and the unit test as live examples.

在live example中试试范例程序和单元测试

e2e/

End-to-end (e2e) tests of the application, written in Jasmine and run by the protractor e2e test runner.

应用的端对端(e2e)测试，用 Jasmine 写成并用 protractor 端对端测试运行器测试。

Initialized with an e2e test for the "Hello Angular" sample.

初始化后，有个“Hello Angular” 的例子的端对端测试。

node_modules/

The npm packages installed with the npm install command.

用 npm install 命令安装的 npm 包。

.editorconfig

.git/

.gitignore

.travis.yml

Tooling configuration files and folders.

配置文件和文件夹的工具。

Ignore them until you have a compelling reason to do otherwise.

除非非常必要，否则可以忽略。

CHANGELOG.md

The history of changes to the QuickStart repository.

快速起步库的更新历史。

Delete or ignore.

删除或忽略。

favicon.ico

The application icon that appears in the browser tab.

出现在浏览器标签上的应用图标。

index.html

The application host page. It loads a few essential scripts in a prescribed order. Then it boots the application, placing the root AppComponent in the custom <my-app> body tag.

应用的宿主页面。它以特定的顺序加载一些基本脚本。然后它启动应用，将根AppComponent放置到自定义<my-app>标签里。

The same index.html satisfies all documentation application samples.

同一个 index.html满足所有文档应用例子。

karma.conf.js

Configuration for the karma test runner described in the Testing guide.

在测试指南中提到的 karma 测试运行器的配置。

karma-test-shim.js

Script to run karma with SystemJS as described in the Testing guide.

在测试指南中提到的 karma 测试运行器的脚本。

non-essential-files.txt

A list of files that you can delete if you want to purge your setup of the original QuickStart Seed testing and git maintainence artifacts. See instructions in the optional Deleting non-essential files section. Do this only in the beginning to avoid accidentally deleting your own tests and git setup!

这个列表中的文件在清理时可以删除，它是原始的“快速起步”种子工程中的测试和git维护文件。步骤参见可选的删除非必要文件部分。 只在最初做这件事，以免不小心删除了你自己的测试文件和git配置！

LICENSE

The open source MIT license to use this setup code in your application.

应用的搭建代码中用到的开源 MIT 许可证。

package.json

Identifies npmpackage dependencies for the project.

为项目指定npm依赖包。

Contains command scripts for running the application, running tests, and more. Enter npm run for a listing. Read more about them.

包含了一些命令脚本，用来运行应用、运行测试与其他。输入npm run来查看命令列表。到这里阅读更多关于它们的说明。

protractor.config.js

Configuration for the protractor end-to-end (e2e) test runner.

protractor 端对端 (e2e) 测试器运行器的配置。

README.md

Instruction for using this git repository in your project. Worth reading before deleting.

项目中使用这个 git 库的说明。在删除前值得阅读。

styles.css

Global styles for the application. Initialized with an <h1> style for the QuickStart demo.

应用的全局样式。初始化后，有个为《快速起步》演示准备的<h1>样式。

systemjs
.config.js

Tells the SystemJS module loader where to find modules referenced in JavaScript import statements. For example:

为 SystemJS 模块加载器指定去哪儿查找在 JavaScript 的import语句中引用的模块。例如：

import { Component } from '@angular/core;

Don't touch this file unless you are fully versed in SystemJS configuration.

除非你完全理解 SystemJS 的配置，不要修改它。

systemjs
.config.extras.js

Optional extra SystemJS configuration. A way to add SystemJS mappings, such as for appliation barrels, without changing the original system.config.js.

可选的额外 SystemJS 配置。是添加 SystemJS 映射的途径，例如在无需修改原始systemjs.config.js的情况下为应用映射封装桶。

tsconfig.json

Tells the TypeScript compiler how to transpile TypeScript source files into JavaScript files that run in all modern browsers.

为 TypeScript 编译器指定如何将 TypeScript 代码转换为 JavaScript 文件，用来在所有现代浏览器中运行。

tslint.json

The npm installed TypeScript linter inspects your TypeScript code and complains when you violate one of its rules.

利用npm安装的 TypeScript 语法检查器 (linter) 检测 TypeScript 代码并在你违反它的规则时提示你。

This file defines linting rules favored by the Angular style guide and by the authors of the documentation.

该文件定义了 Angular 风格指南与本文档站作者喜爱的语法检查规则。