填写这份《一分钟调查》,帮我们(开发组)做得更好!去填写Home

Angular 文档简介

Introduction to the Angular Docs

Angular 是一个应用设计框架与开发平台,用于创建高效、复杂、精致的单页面应用。

Angular is an application design framework and development platform for creating efficient and sophisticated single-page apps.

这份 Angular 文档会帮助你学习和使用 Angular 框架与开发平台,从你的第一个应用开始,一直到优化复杂的企业级单页面应用。 这些教程和指南中都包含可下载的范例,以加速你的学习。

These Angular docs help you learn and use the Angular framework and development platform, from your first application to optimizing complex single-page apps for enterprises. Tutorials and guides include downloadable examples to accelerate your projects.

基本假设

Assumptions

本文档假设你已经熟悉了 HTMLCSSJavaScript 和来自 最新标准 的一些知识,比如 模块。 下列代码范例都是用最新版本的 TypeScript 写的。 大多数 Angular 代码都只能用最新的 JavaScript 编写,它会用 类型 实现依赖注入,还会用装饰器来提供元数据。

These docs assume that you are already familiar with HTML, CSS, JavaScript, and some of the tools from the latest standards, such as classes and modules. The code samples are written using TypeScript. Most Angular code can be written with just the latest JavaScript, using types for dependency injection, and using decorators for metadata.

私有化部署本文档(译者)

有些企业内部的防火墙比较严格,如果无法打开 https://angular.cn,你可以在企业内部进行私有化部署。步骤如下:

本文档的预编译版本位于 Github 上,如果你想进行私有化部署,请把它 Clone 下来,在 nginx 等服务器上按照静态网站的形式做部署即可,除此之外不需要任何服务端环境。

以 Nginx 为例,你需要在 nginx 上做如下改动:

server { root /path/to/ng-docs.github.io/; location / { try_files $uri $uri.html $uri/ /index.html; } }
      
      server {
    root /path/to/ng-docs.github.io/;
    location / {
        try_files $uri $uri.html $uri/ /index.html;
    }
}
    

注意其中的 $uri.html,这是本文档相对于常规 Angular 应用的主要差别,因为本文档进行了预先渲染(Prerender),这项工作可以让你在不需要 Node 服务器的情况下获得等同于服务端渲染的体验改善。

反馈

Feedback

你也可以和我们一起做贡献!

You can sit with us!

我们希望听到你的声音!欢迎报告问题或为文档的未来提交建议

We want to hear from you. Report problems or submit suggestions for future docs.

请到 Github 上的仓库中创建 Pull Requests 来为 Angular 文档做出贡献。 贡献者指南将会帮助你更好的为社区做贡献。

Contribute to Angular docs by creating pull requests on the Angular Github repository. See Contributing to Angular for information about submission guidelines.

我们的社区提倡相互尊重、相互支持。 参见社区行为规范

Our community values respectful, supportive communication. Please consult and adhere to the Code of Conduct.