填寫這份《一分鐘調查》,幫我們(開發組)做得更好!去填寫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.