From 5c2bc1b6f67e6a5e5e2d624ac33cb75aea5bd9ad Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 08:11:59 -0800 Subject: [PATCH 01/10] tutorial when back ported --- public/docs/dart/latest/tutorial/index.jade | 12 +++++++++++- public/docs/dart/latest/tutorial/toh-pt1.jade | 13 +++++++++++++ public/docs/dart/latest/tutorial/toh-pt2.jade | 13 +++++++++++++ public/docs/dart/latest/tutorial/toh-pt3.jade | 13 +++++++++++++ public/docs/dart/latest/tutorial/toh-pt4.jade | 13 +++++++++++++ public/docs/dart/latest/tutorial/toh-pt5.jade | 16 +++++++++++++++- public/docs/dart/latest/tutorial/toh-pt6.jade | 13 ++++++++++++- 7 files changed, 90 insertions(+), 3 deletions(-) diff --git a/public/docs/dart/latest/tutorial/index.jade b/public/docs/dart/latest/tutorial/index.jade index d586842a35..3c7ad0cf02 100644 --- a/public/docs/dart/latest/tutorial/index.jade +++ b/public/docs/dart/latest/tutorial/index.jade @@ -1,4 +1,14 @@ -extends ../../../ts/_cache/tutorial/index.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: "Tutorial: Tour of Heroes" +//- description: The Tour of Heroes tutorial takes us through the steps of creating an Angular application in Dart. +//- nextpage: + title: The Hero Editor + url: /angular/tutorial/toh-pt1 +//- --- +//- FilePath: src/angular/tutorial/index.jade +extends /docs/ts/_cache/tutorial/index.jade block includes include ../_util-fns diff --git a/public/docs/dart/latest/tutorial/toh-pt1.jade b/public/docs/dart/latest/tutorial/toh-pt1.jade index 6c2bc21d4f..9d1e494727 100644 --- a/public/docs/dart/latest/tutorial/toh-pt1.jade +++ b/public/docs/dart/latest/tutorial/toh-pt1.jade @@ -1,3 +1,16 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: The Hero Editor +//- description: We build a simple hero editor +//- prevpage: + title: "Tutorial: Tour of Heroes" + url: /angular/tutorial/index +//- nextpage: + title: Master/Detail + url: /angular/tutorial/toh-pt2 +//- --- +//- FilePath: src/angular/tutorial/toh-pt1.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt2.jade b/public/docs/dart/latest/tutorial/toh-pt2.jade index 3d8c21e5c8..e8d64e7e5d 100644 --- a/public/docs/dart/latest/tutorial/toh-pt2.jade +++ b/public/docs/dart/latest/tutorial/toh-pt2.jade @@ -1,3 +1,16 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Master/Detail +//- description: We build a master/detail page with a list of heroes +//- prevpage: + title: The Hero Editor + url: /angular/tutorial/toh-pt1 +//- nextpage: + title: Multiple Components + url: /angular/tutorial/toh-pt3 +//- --- +//- FilePath: src/angular/tutorial/toh-pt2.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt3.jade b/public/docs/dart/latest/tutorial/toh-pt3.jade index 0c629c439f..8d448dbad2 100644 --- a/public/docs/dart/latest/tutorial/toh-pt3.jade +++ b/public/docs/dart/latest/tutorial/toh-pt3.jade @@ -1,3 +1,16 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Multiple Components +//- description: We refactor the master/detail view into separate components +//- prevpage: + title: Master/Detail + url: /angular/tutorial/toh-pt2 +//- nextpage: + title: Services + url: /angular/tutorial/toh-pt4 +//- --- +//- FilePath: src/angular/tutorial/toh-pt3.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt4.jade b/public/docs/dart/latest/tutorial/toh-pt4.jade index e585db6dd2..2d5a60dd84 100644 --- a/public/docs/dart/latest/tutorial/toh-pt4.jade +++ b/public/docs/dart/latest/tutorial/toh-pt4.jade @@ -1,3 +1,16 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Services +//- description: We create a reusable service to manage our hero data calls +//- prevpage: + title: Multiple Components + url: /angular/tutorial/toh-pt3 +//- nextpage: + title: Routing + url: /angular/tutorial/toh-pt5 +//- --- +//- FilePath: src/angular/tutorial/toh-pt4.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt5.jade b/public/docs/dart/latest/tutorial/toh-pt5.jade index 74e1539105..37918b3129 100644 --- a/public/docs/dart/latest/tutorial/toh-pt5.jade +++ b/public/docs/dart/latest/tutorial/toh-pt5.jade @@ -1,6 +1,20 @@ -extends ../../../ts/_cache/tutorial/toh-pt5 +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Routing +//- description: We add the Angular Component Router and learn to navigate among the views +//- prevpage: + title: Services + url: /angular/tutorial/toh-pt4 +//- nextpage: + title: HTTP + url: /angular/tutorial/toh-pt6 +//- --- +//- FilePath: src/angular/tutorial/toh-pt5.jade +extends /docs/ts/_cache/tutorial/toh-pt5 block includes + - var _example = 'toh-5'; include ../_util-fns - var _appRoutingTsVsAppComp = 'AppComponent' - var _RoutesVsAtRouteConfig = '@RouteConfig' diff --git a/public/docs/dart/latest/tutorial/toh-pt6.jade b/public/docs/dart/latest/tutorial/toh-pt6.jade index a8375f11f7..18b3ebad59 100644 --- a/public/docs/dart/latest/tutorial/toh-pt6.jade +++ b/public/docs/dart/latest/tutorial/toh-pt6.jade @@ -1,6 +1,17 @@ -extends ../../../ts/_cache/tutorial/toh-pt6.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: HTTP +//- description: We convert our service and components to use Angular's HTTP service +//- prevpage: + title: Routing + url: /angular/tutorial/toh-pt5 +//- --- +//- FilePath: src/angular/tutorial/toh-pt6.jade +extends /docs/ts/_cache/tutorial/toh-pt6.jade block includes + - var _example = 'toh-6'; include ../_util-fns - var _Http = 'BrowserClient'; - var _Angular_Http = 'Dart BrowserClient' From 689fdce9223568fe2f83f1ed3d9ceaceab9b29c8 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 08:18:03 -0800 Subject: [PATCH 02/10] api when backported --- public/docs/dart/latest/api/_data.json | 3 ++- public/docs/dart/latest/api/index.jade | 8 ++++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/public/docs/dart/latest/api/_data.json b/public/docs/dart/latest/api/_data.json index 6bb33fa9a7..403220eabe 100644 --- a/public/docs/dart/latest/api/_data.json +++ b/public/docs/dart/latest/api/_data.json @@ -1,5 +1,6 @@ { "index" : { - "title" : "API Reference" + "title": "API Reference", + "long-title": "API Reference v2" } } diff --git a/public/docs/dart/latest/api/index.jade b/public/docs/dart/latest/api/index.jade index cdf4db0b3b..19ab58085c 100644 --- a/public/docs/dart/latest/api/index.jade +++ b/public/docs/dart/latest/api/index.jade @@ -1,3 +1,11 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: API Reference +//- long-title: API Reference v2 +//- toc: false +//- --- +//- FilePath: srcindex.jade include ../_util-fns :marked From 5fc3b08dc5980ea21e75b67a83b4db6fe389a97d Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 08:34:48 -0800 Subject: [PATCH 03/10] guide when backported --- public/docs/dart/latest/guide/animations.jade | 10 +++++++++- .../docs/dart/latest/guide/architecture.jade | 17 ++++++++++++++++- .../latest/guide/attribute-directives.jade | 17 ++++++++++++++++- .../dart/latest/guide/component-styles.jade | 17 ++++++++++++++++- .../latest/guide/dependency-injection.jade | 17 ++++++++++++++++- .../dart/latest/guide/displaying-data.jade | 17 ++++++++++++++++- public/docs/dart/latest/guide/forms.jade | 14 ++++++++++++++ .../hierarchical-dependency-injection.jade | 17 ++++++++++++++++- public/docs/dart/latest/guide/index.jade | 13 ++++++++++++- .../dart/latest/guide/learning-angular.jade | 18 +++++++++++++++++- .../dart/latest/guide/lifecycle-hooks.jade | 17 ++++++++++++++++- public/docs/dart/latest/guide/pipes.jade | 17 ++++++++++++++++- public/docs/dart/latest/guide/router.jade | 14 ++++++++++++++ public/docs/dart/latest/guide/security.jade | 16 +++++++++++++++- .../latest/guide/server-communication.jade | 17 ++++++++++++++++- public/docs/dart/latest/guide/setup.jade | 14 ++++++++++++++ .../latest/guide/structural-directives.jade | 14 +++++++++++++- .../dart/latest/guide/template-syntax.jade | 17 ++++++++++++++++- public/docs/dart/latest/guide/testing.jade | 14 +++++++++++++- public/docs/dart/latest/guide/user-input.jade | 14 ++++++++++++++ 20 files changed, 295 insertions(+), 16 deletions(-) diff --git a/public/docs/dart/latest/guide/animations.jade b/public/docs/dart/latest/guide/animations.jade index c743361ac8..e0862bb410 100644 --- a/public/docs/dart/latest/guide/animations.jade +++ b/public/docs/dart/latest/guide/animations.jade @@ -1 +1,9 @@ -include ../../../_includes/_ts-temp +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Animations +//- description: A guide to Angular's animation system. +//- sideNavGroup: advanced +//- --- +//- FilePath: src/angular/guide/animations.jade +include /docs/_includes/_ts-temp diff --git a/public/docs/dart/latest/guide/architecture.jade b/public/docs/dart/latest/guide/architecture.jade index 323f1aff6d..9fa1c9cd26 100644 --- a/public/docs/dart/latest/guide/architecture.jade +++ b/public/docs/dart/latest/guide/architecture.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/architecture.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Architecture Overview +//- description: The basic building blocks of Angular applications +//- sideNavGroup: basic +//- prevpage: + title: Learning Angular + url: /angular/guide/learning-angular +//- nextpage: + title: Displaying Data + url: /angular/guide/displaying-data +//- --- +//- FilePath: src/angular/guide/architecture.jade +extends /docs/ts/_cache/guide/architecture.jade block includes + - var _example = 'architecture'; include ../_util-fns - var _library_module = 'library' - var _at_angular = 'angular2' diff --git a/public/docs/dart/latest/guide/attribute-directives.jade b/public/docs/dart/latest/guide/attribute-directives.jade index eda47d20f5..87f013b383 100644 --- a/public/docs/dart/latest/guide/attribute-directives.jade +++ b/public/docs/dart/latest/guide/attribute-directives.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/attribute-directives.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Attribute Directives +//- description: Attribute directives attach behavior to elements. +//- sideNavGroup: advanced +//- prevpage: + title: Template Syntax + url: /angular/guide/template-syntax +//- nextpage: + title: Component Styles + url: /angular/guide/component-styles +//- --- +//- FilePath: src/angular/guide/attribute-directives.jade +extends /docs/ts/_cache/guide/attribute-directives.jade block includes + - var _example = 'attribute-directives'; include ../_util-fns block highlight-directive-1 diff --git a/public/docs/dart/latest/guide/component-styles.jade b/public/docs/dart/latest/guide/component-styles.jade index bcff4d9c63..9b2e3eef5b 100644 --- a/public/docs/dart/latest/guide/component-styles.jade +++ b/public/docs/dart/latest/guide/component-styles.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/component-styles.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Component Styles +//- description: Learn how to apply CSS styles to components. +//- sideNavGroup: advanced +//- prevpage: + title: Attribute Directives + url: /angular/guide/attribute-directives +//- nextpage: + title: Hierarchical Dependency Injectors + url: /angular/guide/hierarchical-dependency-injection +//- --- +//- FilePath: src/angular/guide/component-styles.jade +extends /docs/ts/_cache/guide/component-styles.jade block includes + - var _example = 'component-styles'; include ../_util-fns //- TODO: consider adding material equivalent to TS Appendices 1 & 2 if relevant. diff --git a/public/docs/dart/latest/guide/dependency-injection.jade b/public/docs/dart/latest/guide/dependency-injection.jade index 4141d981bc..51c6c36cac 100644 --- a/public/docs/dart/latest/guide/dependency-injection.jade +++ b/public/docs/dart/latest/guide/dependency-injection.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/dependency-injection.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Dependency Injection +//- description: Angular's dependency injection system creates and delivers dependent services "just-in-time". +//- sideNavGroup: basic +//- prevpage: + title: Forms + url: /angular/guide/forms +//- nextpage: + title: Template Syntax + url: /angular/guide/template-syntax +//- --- +//- FilePath: src/angular/guide/dependency-injection.jade +extends /docs/ts/_cache/guide/dependency-injection.jade block includes + - var _example = 'dependency-injection'; include ../_util-fns - var _thisDot = ''; diff --git a/public/docs/dart/latest/guide/displaying-data.jade b/public/docs/dart/latest/guide/displaying-data.jade index d3c588076b..939b8f5afd 100644 --- a/public/docs/dart/latest/guide/displaying-data.jade +++ b/public/docs/dart/latest/guide/displaying-data.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/displaying-data.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Displaying Data +//- description: Property binding helps show app data in the UI. +//- sideNavGroup: basic +//- prevpage: + title: Architecture Overview + url: /angular/guide/architecture +//- nextpage: + title: User Input + url: /angular/guide/user-input +//- --- +//- FilePath: src/angular/guide/displaying-data.jade +extends /docs/ts/_cache/guide/displaying-data.jade block includes + - var _example = 'displaying-data'; include ../_util-fns - var _iterableUrl = 'https://api.dartlang.org/stable/dart-core/Iterable-class.html'; - var _boolean = 'boolean'; diff --git a/public/docs/dart/latest/guide/forms.jade b/public/docs/dart/latest/guide/forms.jade index 6e2591fc08..c153440ba4 100644 --- a/public/docs/dart/latest/guide/forms.jade +++ b/public/docs/dart/latest/guide/forms.jade @@ -1,3 +1,17 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Forms +//- description: A form creates a cohesive, effective, and compelling data entry experience. An Angular form coordinates a set of data-bound user controls, tracks changes, validates input, and presents errors. +//- sideNavGroup: basic +//- prevpage: + title: User Input + url: /angular/guide/user-input +//- nextpage: + title: Dependency Injection + url: /angular/guide/dependency-injection +//- --- +//- FilePath: src/angular/guide/forms.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade b/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade index 4214572991..4899bebefc 100644 --- a/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade +++ b/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade @@ -1,4 +1,19 @@ -extends ../../../ts/_cache/guide/hierarchical-dependency-injection.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Hierarchical Dependency Injectors +//- description: Angular's hierarchical dependency injection system supports nested injectors in parallel with the component tree. +//- sideNavGroup: advanced +//- prevpage: + title: Component Styles + url: /angular/guide/component-styles +//- nextpage: + title: HTTP Client + url: /angular/guide/server-communication +//- --- +//- FilePath: src/angular/guide/hierarchical-dependency-injection.jade +extends /docs/ts/_cache/guide/hierarchical-dependency-injection.jade block includes + - var _example = 'hierarchical-dependency-injection'; include ../_util-fns diff --git a/public/docs/dart/latest/guide/index.jade b/public/docs/dart/latest/guide/index.jade index 2b5aff7742..5b44ec0b02 100644 --- a/public/docs/dart/latest/guide/index.jade +++ b/public/docs/dart/latest/guide/index.jade @@ -1,4 +1,15 @@ -extends ../../../ts/_cache/guide/index.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Documentation Overview +//- description: How to read and use this documentation +//- sideNavGroup: basic +//- nextpage: + title: Setup for Development + url: /angular/guide/setup +//- --- +//- FilePath: src/angular/guide/index.jade +extends /docs/ts/_cache/guide/index.jade block includes include ../_util-fns diff --git a/public/docs/dart/latest/guide/learning-angular.jade b/public/docs/dart/latest/guide/learning-angular.jade index 4a5788269f..9046fa4ec9 100644 --- a/public/docs/dart/latest/guide/learning-angular.jade +++ b/public/docs/dart/latest/guide/learning-angular.jade @@ -1,4 +1,20 @@ -extends ../../../ts/_cache/guide/learning-angular.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Learning Angular +//- description: A suggested path through the documentation for Angular newcomers +//- sideNavGroup: basic +//- toc: false +//- prevpage: + title: Setup for Development + url: /angular/guide/setup +//- nextpage: + title: Architecture Overview + url: /angular/guide/architecture +//- --- +//- FilePath: src/angular/guide/learning-angular.jade +extends /docs/ts/_cache/guide/learning-angular.jade block includes + - var _example = 'learning-angular'; include ../_util-fns diff --git a/public/docs/dart/latest/guide/lifecycle-hooks.jade b/public/docs/dart/latest/guide/lifecycle-hooks.jade index d54ce51384..15b39f4866 100644 --- a/public/docs/dart/latest/guide/lifecycle-hooks.jade +++ b/public/docs/dart/latest/guide/lifecycle-hooks.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/lifecycle-hooks.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Lifecycle Hooks +//- description: Angular calls lifecycle hook methods on directives and components as it creates, changes, and destroys them. +//- sideNavGroup: advanced +//- prevpage: + title: HTTP Client + url: /angular/guide/server-communication +//- nextpage: + title: Pipes + url: /angular/guide/pipes +//- --- +//- FilePath: src/angular/guide/lifecycle-hooks.jade +extends /docs/ts/_cache/guide/lifecycle-hooks.jade block includes + - var _example = 'lifecycle-hooks'; include ../_util-fns block other-angular-subsystems diff --git a/public/docs/dart/latest/guide/pipes.jade b/public/docs/dart/latest/guide/pipes.jade index e444a67771..d8e7e40ea0 100644 --- a/public/docs/dart/latest/guide/pipes.jade +++ b/public/docs/dart/latest/guide/pipes.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/pipes.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Pipes +//- description: Pipes transform displayed values within a template. +//- sideNavGroup: advanced +//- prevpage: + title: Lifecycle Hooks + url: /angular/guide/lifecycle-hooks +//- nextpage: + title: Routing & Navigation + url: /angular/guide/router +//- --- +//- FilePath: src/angular/guide/pipes.jade +extends /docs/ts/_cache/guide/pipes.jade block includes + - var _example = 'pipes'; include ../_util-fns block pure-change diff --git a/public/docs/dart/latest/guide/router.jade b/public/docs/dart/latest/guide/router.jade index 578b315727..60e64a38b5 100644 --- a/public/docs/dart/latest/guide/router.jade +++ b/public/docs/dart/latest/guide/router.jade @@ -1,3 +1,17 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Routing & Navigation +//- description: Discover the basics of screen navigation with the Angular Router. +//- sideNavGroup: advanced +//- prevpage: + title: Pipes + url: /angular/guide/pipes +//- nextpage: + title: Security + url: /angular/guide/security +//- --- +//- FilePath: src/angular/guide/router.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/guide/security.jade b/public/docs/dart/latest/guide/security.jade index 4782ba81d3..a69637986d 100644 --- a/public/docs/dart/latest/guide/security.jade +++ b/public/docs/dart/latest/guide/security.jade @@ -1 +1,15 @@ -include ../../../_includes/_ts-temp \ No newline at end of file +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Security +//- description: Developing for content security in Angular applications +//- sideNavGroup: advanced +//- prevpage: + title: Routing & Navigation + url: /angular/guide/router +//- nextpage: + title: Structural Directives + url: /angular/guide/structural-directives +//- --- +//- FilePath: src/angular/guide/security.jade +include /docs/_includes/_ts-temp \ No newline at end of file diff --git a/public/docs/dart/latest/guide/server-communication.jade b/public/docs/dart/latest/guide/server-communication.jade index 57ddee8921..30eeb87461 100644 --- a/public/docs/dart/latest/guide/server-communication.jade +++ b/public/docs/dart/latest/guide/server-communication.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/server-communication.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: HTTP Client +//- description: Use an HTTP Client to talk to a remote server. +//- sideNavGroup: advanced +//- prevpage: + title: Hierarchical Dependency Injectors + url: /angular/guide/hierarchical-dependency-injection +//- nextpage: + title: Lifecycle Hooks + url: /angular/guide/lifecycle-hooks +//- --- +//- FilePath: src/angular/guide/server-communication.jade +extends /docs/ts/_cache/guide/server-communication.jade block includes + - var _example = 'server-communication'; include ../_util-fns - var _Http = 'BrowserClient'; - var _Angular_Http = 'Dart BrowserClient' diff --git a/public/docs/dart/latest/guide/setup.jade b/public/docs/dart/latest/guide/setup.jade index b845550f30..9a1437a1de 100644 --- a/public/docs/dart/latest/guide/setup.jade +++ b/public/docs/dart/latest/guide/setup.jade @@ -1,3 +1,17 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Setup for Development +//- description: How to use Dart tools to create and run Angular apps +//- sideNavGroup: basic +//- prevpage: + title: Documentation Overview + url: /angular/guide/index +//- nextpage: + title: Learning Angular + url: /angular/guide/learning-angular +//- --- +//- FilePath: src/angular/guide/setup.jade include ../_util-fns a#develop-locally diff --git a/public/docs/dart/latest/guide/structural-directives.jade b/public/docs/dart/latest/guide/structural-directives.jade index 2637084cbd..bad6e4c3fd 100644 --- a/public/docs/dart/latest/guide/structural-directives.jade +++ b/public/docs/dart/latest/guide/structural-directives.jade @@ -1,6 +1,18 @@ -extends ../../../ts/_cache/guide/structural-directives.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Structural Directives +//- description: Angular has a powerful template engine that lets us easily manipulate the DOM structure of our elements. +//- sideNavGroup: advanced +//- prevpage: + title: Security + url: /angular/guide/security +//- --- +//- FilePath: src/angular/guide/structural-directives.jade +extends /docs/ts/_cache/guide/structural-directives.jade block includes + - var _example = 'structural-directives'; include ../_util-fns block unless-intro diff --git a/public/docs/dart/latest/guide/template-syntax.jade b/public/docs/dart/latest/guide/template-syntax.jade index fe62bd9084..811c4f3de8 100644 --- a/public/docs/dart/latest/guide/template-syntax.jade +++ b/public/docs/dart/latest/guide/template-syntax.jade @@ -1,6 +1,21 @@ -extends ../../../ts/_cache/guide/template-syntax.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Template Syntax +//- description: Learn how to write templates that display data and consume user events with the help of data binding. +//- sideNavGroup: basic +//- prevpage: + title: Dependency Injection + url: /angular/guide/dependency-injection +//- nextpage: + title: Attribute Directives + url: /angular/guide/attribute-directives +//- --- +//- FilePath: src/angular/guide/template-syntax.jade +extends /docs/ts/_cache/guide/template-syntax.jade block includes + - var _example = 'template-syntax'; include ../_util-fns - var _JavaScript = 'Dart'; - var __chaining_op = ';'; diff --git a/public/docs/dart/latest/guide/testing.jade b/public/docs/dart/latest/guide/testing.jade index c743361ac8..2899a34916 100644 --- a/public/docs/dart/latest/guide/testing.jade +++ b/public/docs/dart/latest/guide/testing.jade @@ -1 +1,13 @@ -include ../../../_includes/_ts-temp +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Testing +//- description: Techniques and practices for testing an Angular app +//- sideNavGroup: advanced +//- --- +//- FilePath: src/angular/guide/testing.jade +//- include /docs/_includes/_ts-temp +:marked + Page under construction — see + [issue #195](https://github.com/dart-lang/site-webdev/issues/195) + for the latest development status. \ No newline at end of file diff --git a/public/docs/dart/latest/guide/user-input.jade b/public/docs/dart/latest/guide/user-input.jade index 10e02bc436..9e99aedd35 100644 --- a/public/docs/dart/latest/guide/user-input.jade +++ b/public/docs/dart/latest/guide/user-input.jade @@ -1,3 +1,17 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: User Input +//- description: User input triggers DOM events. We listen to those events with event bindings that funnel updated values back into our components and models. +//- sideNavGroup: basic +//- prevpage: + title: Displaying Data + url: /angular/guide/displaying-data +//- nextpage: + title: Forms + url: /angular/guide/forms +//- --- +//- FilePath: src/angular/guide/user-input.jade include ../_util-fns :marked From 8625aaec8cb83b37bc22d8f01e0a45ee9bce272b Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 08:55:00 -0800 Subject: [PATCH 04/10] quickstart, cheatsheet and glossary when backported --- public/docs/dart/latest/_data.json | 1 + public/docs/dart/latest/cheatsheet.jade | 8 ++++++++ public/docs/dart/latest/glossary.jade | 10 +++++++++- public/docs/dart/latest/quickstart.jade | 11 ++++++++++- 4 files changed, 28 insertions(+), 2 deletions(-) diff --git a/public/docs/dart/latest/_data.json b/public/docs/dart/latest/_data.json index 68eb4ab948..b935cdc57e 100644 --- a/public/docs/dart/latest/_data.json +++ b/public/docs/dart/latest/_data.json @@ -50,6 +50,7 @@ "cheatsheet": { "title": "Cheat Sheet", + "long-title": "Cheat Sheet v2", "subtitle": "Dart", "reference": false }, diff --git a/public/docs/dart/latest/cheatsheet.jade b/public/docs/dart/latest/cheatsheet.jade index 8bad00b1ca..0201ccbe35 100644 --- a/public/docs/dart/latest/cheatsheet.jade +++ b/public/docs/dart/latest/cheatsheet.jade @@ -1,3 +1,11 @@ +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Cheat Sheet +//- long-title: Cheat Sheet v2 +//- toc: false +//- --- +//- FilePath: src/angular/cheatsheet.jade - var base = current.path[4] ? '.' : './guide'; .l-content-small.docs-content.cheatsheet diff --git a/public/docs/dart/latest/glossary.jade b/public/docs/dart/latest/glossary.jade index dad0d1144d..bf9a0c2216 100644 --- a/public/docs/dart/latest/glossary.jade +++ b/public/docs/dart/latest/glossary.jade @@ -1,6 +1,14 @@ -extends ../../ts/_cache/glossary.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Glossary +//- description: Brief definitions of the most important words in the Angular vocabulary +//- --- +//- FilePath: src/angular/glossary.jade +extends /docs/ts/_cache/glossary.jade block includes + - var _example = 'glossary'; include _util-fns block annotation-defn diff --git a/public/docs/dart/latest/quickstart.jade b/public/docs/dart/latest/quickstart.jade index 5e8d57687e..f0428673ee 100644 --- a/public/docs/dart/latest/quickstart.jade +++ b/public/docs/dart/latest/quickstart.jade @@ -1,5 +1,14 @@ -extends ../../ts/_cache/quickstart.jade +//- --- +//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT +//- layout: angular +//- title: Quickstart +//- description: A quick look at Angular basics +//- toc: false +//- --- +//- FilePath: src/angular/quickstart.jade +extends /docs/ts/_cache/quickstart.jade block includes + - var _example = 'quickstart'; include _util-fns - var _on_Plunkr = ''; From d42f4759a902b63f6ca6a5b7ba649ae1dff56728 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 10:23:28 -0800 Subject: [PATCH 05/10] remove Jekyll front matter from each back ported file --- public/docs/dart/latest/api/index.jade | 8 -------- public/docs/dart/latest/cheatsheet.jade | 8 -------- public/docs/dart/latest/glossary.jade | 7 ------- public/docs/dart/latest/guide/animations.jade | 8 -------- public/docs/dart/latest/guide/architecture.jade | 14 -------------- .../dart/latest/guide/attribute-directives.jade | 14 -------------- .../docs/dart/latest/guide/component-styles.jade | 14 -------------- .../dart/latest/guide/dependency-injection.jade | 14 -------------- .../docs/dart/latest/guide/displaying-data.jade | 14 -------------- public/docs/dart/latest/guide/forms.jade | 14 -------------- .../guide/hierarchical-dependency-injection.jade | 14 -------------- public/docs/dart/latest/guide/index.jade | 11 ----------- .../docs/dart/latest/guide/learning-angular.jade | 15 --------------- .../docs/dart/latest/guide/lifecycle-hooks.jade | 14 -------------- public/docs/dart/latest/guide/pipes.jade | 14 -------------- public/docs/dart/latest/guide/router.jade | 14 -------------- public/docs/dart/latest/guide/security.jade | 14 -------------- .../dart/latest/guide/server-communication.jade | 14 -------------- public/docs/dart/latest/guide/setup.jade | 14 -------------- .../dart/latest/guide/structural-directives.jade | 11 ----------- .../docs/dart/latest/guide/template-syntax.jade | 14 -------------- public/docs/dart/latest/guide/testing.jade | 8 -------- public/docs/dart/latest/guide/user-input.jade | 14 -------------- public/docs/dart/latest/quickstart.jade | 8 -------- public/docs/dart/latest/tutorial/index.jade | 10 ---------- public/docs/dart/latest/tutorial/toh-pt1.jade | 13 ------------- public/docs/dart/latest/tutorial/toh-pt2.jade | 13 ------------- public/docs/dart/latest/tutorial/toh-pt3.jade | 13 ------------- public/docs/dart/latest/tutorial/toh-pt4.jade | 13 ------------- public/docs/dart/latest/tutorial/toh-pt5.jade | 13 ------------- public/docs/dart/latest/tutorial/toh-pt6.jade | 10 ---------- 31 files changed, 379 deletions(-) diff --git a/public/docs/dart/latest/api/index.jade b/public/docs/dart/latest/api/index.jade index 19ab58085c..cdf4db0b3b 100644 --- a/public/docs/dart/latest/api/index.jade +++ b/public/docs/dart/latest/api/index.jade @@ -1,11 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: API Reference -//- long-title: API Reference v2 -//- toc: false -//- --- -//- FilePath: srcindex.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/cheatsheet.jade b/public/docs/dart/latest/cheatsheet.jade index 0201ccbe35..8bad00b1ca 100644 --- a/public/docs/dart/latest/cheatsheet.jade +++ b/public/docs/dart/latest/cheatsheet.jade @@ -1,11 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Cheat Sheet -//- long-title: Cheat Sheet v2 -//- toc: false -//- --- -//- FilePath: src/angular/cheatsheet.jade - var base = current.path[4] ? '.' : './guide'; .l-content-small.docs-content.cheatsheet diff --git a/public/docs/dart/latest/glossary.jade b/public/docs/dart/latest/glossary.jade index bf9a0c2216..e2fc99518a 100644 --- a/public/docs/dart/latest/glossary.jade +++ b/public/docs/dart/latest/glossary.jade @@ -1,10 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Glossary -//- description: Brief definitions of the most important words in the Angular vocabulary -//- --- -//- FilePath: src/angular/glossary.jade extends /docs/ts/_cache/glossary.jade block includes diff --git a/public/docs/dart/latest/guide/animations.jade b/public/docs/dart/latest/guide/animations.jade index e0862bb410..3b647d5616 100644 --- a/public/docs/dart/latest/guide/animations.jade +++ b/public/docs/dart/latest/guide/animations.jade @@ -1,9 +1 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Animations -//- description: A guide to Angular's animation system. -//- sideNavGroup: advanced -//- --- -//- FilePath: src/angular/guide/animations.jade include /docs/_includes/_ts-temp diff --git a/public/docs/dart/latest/guide/architecture.jade b/public/docs/dart/latest/guide/architecture.jade index 9fa1c9cd26..9d40061014 100644 --- a/public/docs/dart/latest/guide/architecture.jade +++ b/public/docs/dart/latest/guide/architecture.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Architecture Overview -//- description: The basic building blocks of Angular applications -//- sideNavGroup: basic -//- prevpage: - title: Learning Angular - url: /angular/guide/learning-angular -//- nextpage: - title: Displaying Data - url: /angular/guide/displaying-data -//- --- -//- FilePath: src/angular/guide/architecture.jade extends /docs/ts/_cache/guide/architecture.jade block includes diff --git a/public/docs/dart/latest/guide/attribute-directives.jade b/public/docs/dart/latest/guide/attribute-directives.jade index 87f013b383..7e3d48a92e 100644 --- a/public/docs/dart/latest/guide/attribute-directives.jade +++ b/public/docs/dart/latest/guide/attribute-directives.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Attribute Directives -//- description: Attribute directives attach behavior to elements. -//- sideNavGroup: advanced -//- prevpage: - title: Template Syntax - url: /angular/guide/template-syntax -//- nextpage: - title: Component Styles - url: /angular/guide/component-styles -//- --- -//- FilePath: src/angular/guide/attribute-directives.jade extends /docs/ts/_cache/guide/attribute-directives.jade block includes diff --git a/public/docs/dart/latest/guide/component-styles.jade b/public/docs/dart/latest/guide/component-styles.jade index 9b2e3eef5b..0980ca0eac 100644 --- a/public/docs/dart/latest/guide/component-styles.jade +++ b/public/docs/dart/latest/guide/component-styles.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Component Styles -//- description: Learn how to apply CSS styles to components. -//- sideNavGroup: advanced -//- prevpage: - title: Attribute Directives - url: /angular/guide/attribute-directives -//- nextpage: - title: Hierarchical Dependency Injectors - url: /angular/guide/hierarchical-dependency-injection -//- --- -//- FilePath: src/angular/guide/component-styles.jade extends /docs/ts/_cache/guide/component-styles.jade block includes diff --git a/public/docs/dart/latest/guide/dependency-injection.jade b/public/docs/dart/latest/guide/dependency-injection.jade index 51c6c36cac..6c679c2919 100644 --- a/public/docs/dart/latest/guide/dependency-injection.jade +++ b/public/docs/dart/latest/guide/dependency-injection.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Dependency Injection -//- description: Angular's dependency injection system creates and delivers dependent services "just-in-time". -//- sideNavGroup: basic -//- prevpage: - title: Forms - url: /angular/guide/forms -//- nextpage: - title: Template Syntax - url: /angular/guide/template-syntax -//- --- -//- FilePath: src/angular/guide/dependency-injection.jade extends /docs/ts/_cache/guide/dependency-injection.jade block includes diff --git a/public/docs/dart/latest/guide/displaying-data.jade b/public/docs/dart/latest/guide/displaying-data.jade index 939b8f5afd..fec5bd5b8b 100644 --- a/public/docs/dart/latest/guide/displaying-data.jade +++ b/public/docs/dart/latest/guide/displaying-data.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Displaying Data -//- description: Property binding helps show app data in the UI. -//- sideNavGroup: basic -//- prevpage: - title: Architecture Overview - url: /angular/guide/architecture -//- nextpage: - title: User Input - url: /angular/guide/user-input -//- --- -//- FilePath: src/angular/guide/displaying-data.jade extends /docs/ts/_cache/guide/displaying-data.jade block includes diff --git a/public/docs/dart/latest/guide/forms.jade b/public/docs/dart/latest/guide/forms.jade index c153440ba4..6e2591fc08 100644 --- a/public/docs/dart/latest/guide/forms.jade +++ b/public/docs/dart/latest/guide/forms.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Forms -//- description: A form creates a cohesive, effective, and compelling data entry experience. An Angular form coordinates a set of data-bound user controls, tracks changes, validates input, and presents errors. -//- sideNavGroup: basic -//- prevpage: - title: User Input - url: /angular/guide/user-input -//- nextpage: - title: Dependency Injection - url: /angular/guide/dependency-injection -//- --- -//- FilePath: src/angular/guide/forms.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade b/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade index 4899bebefc..0940b19d15 100644 --- a/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade +++ b/public/docs/dart/latest/guide/hierarchical-dependency-injection.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Hierarchical Dependency Injectors -//- description: Angular's hierarchical dependency injection system supports nested injectors in parallel with the component tree. -//- sideNavGroup: advanced -//- prevpage: - title: Component Styles - url: /angular/guide/component-styles -//- nextpage: - title: HTTP Client - url: /angular/guide/server-communication -//- --- -//- FilePath: src/angular/guide/hierarchical-dependency-injection.jade extends /docs/ts/_cache/guide/hierarchical-dependency-injection.jade block includes diff --git a/public/docs/dart/latest/guide/index.jade b/public/docs/dart/latest/guide/index.jade index 5b44ec0b02..65e7b2e94e 100644 --- a/public/docs/dart/latest/guide/index.jade +++ b/public/docs/dart/latest/guide/index.jade @@ -1,14 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Documentation Overview -//- description: How to read and use this documentation -//- sideNavGroup: basic -//- nextpage: - title: Setup for Development - url: /angular/guide/setup -//- --- -//- FilePath: src/angular/guide/index.jade extends /docs/ts/_cache/guide/index.jade block includes diff --git a/public/docs/dart/latest/guide/learning-angular.jade b/public/docs/dart/latest/guide/learning-angular.jade index 9046fa4ec9..72b7007742 100644 --- a/public/docs/dart/latest/guide/learning-angular.jade +++ b/public/docs/dart/latest/guide/learning-angular.jade @@ -1,18 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Learning Angular -//- description: A suggested path through the documentation for Angular newcomers -//- sideNavGroup: basic -//- toc: false -//- prevpage: - title: Setup for Development - url: /angular/guide/setup -//- nextpage: - title: Architecture Overview - url: /angular/guide/architecture -//- --- -//- FilePath: src/angular/guide/learning-angular.jade extends /docs/ts/_cache/guide/learning-angular.jade block includes diff --git a/public/docs/dart/latest/guide/lifecycle-hooks.jade b/public/docs/dart/latest/guide/lifecycle-hooks.jade index 15b39f4866..f06c72c3fc 100644 --- a/public/docs/dart/latest/guide/lifecycle-hooks.jade +++ b/public/docs/dart/latest/guide/lifecycle-hooks.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Lifecycle Hooks -//- description: Angular calls lifecycle hook methods on directives and components as it creates, changes, and destroys them. -//- sideNavGroup: advanced -//- prevpage: - title: HTTP Client - url: /angular/guide/server-communication -//- nextpage: - title: Pipes - url: /angular/guide/pipes -//- --- -//- FilePath: src/angular/guide/lifecycle-hooks.jade extends /docs/ts/_cache/guide/lifecycle-hooks.jade block includes diff --git a/public/docs/dart/latest/guide/pipes.jade b/public/docs/dart/latest/guide/pipes.jade index d8e7e40ea0..3bff43c92e 100644 --- a/public/docs/dart/latest/guide/pipes.jade +++ b/public/docs/dart/latest/guide/pipes.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Pipes -//- description: Pipes transform displayed values within a template. -//- sideNavGroup: advanced -//- prevpage: - title: Lifecycle Hooks - url: /angular/guide/lifecycle-hooks -//- nextpage: - title: Routing & Navigation - url: /angular/guide/router -//- --- -//- FilePath: src/angular/guide/pipes.jade extends /docs/ts/_cache/guide/pipes.jade block includes diff --git a/public/docs/dart/latest/guide/router.jade b/public/docs/dart/latest/guide/router.jade index 60e64a38b5..578b315727 100644 --- a/public/docs/dart/latest/guide/router.jade +++ b/public/docs/dart/latest/guide/router.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Routing & Navigation -//- description: Discover the basics of screen navigation with the Angular Router. -//- sideNavGroup: advanced -//- prevpage: - title: Pipes - url: /angular/guide/pipes -//- nextpage: - title: Security - url: /angular/guide/security -//- --- -//- FilePath: src/angular/guide/router.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/guide/security.jade b/public/docs/dart/latest/guide/security.jade index a69637986d..c440e5649f 100644 --- a/public/docs/dart/latest/guide/security.jade +++ b/public/docs/dart/latest/guide/security.jade @@ -1,15 +1 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Security -//- description: Developing for content security in Angular applications -//- sideNavGroup: advanced -//- prevpage: - title: Routing & Navigation - url: /angular/guide/router -//- nextpage: - title: Structural Directives - url: /angular/guide/structural-directives -//- --- -//- FilePath: src/angular/guide/security.jade include /docs/_includes/_ts-temp \ No newline at end of file diff --git a/public/docs/dart/latest/guide/server-communication.jade b/public/docs/dart/latest/guide/server-communication.jade index 30eeb87461..df362caa5a 100644 --- a/public/docs/dart/latest/guide/server-communication.jade +++ b/public/docs/dart/latest/guide/server-communication.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: HTTP Client -//- description: Use an HTTP Client to talk to a remote server. -//- sideNavGroup: advanced -//- prevpage: - title: Hierarchical Dependency Injectors - url: /angular/guide/hierarchical-dependency-injection -//- nextpage: - title: Lifecycle Hooks - url: /angular/guide/lifecycle-hooks -//- --- -//- FilePath: src/angular/guide/server-communication.jade extends /docs/ts/_cache/guide/server-communication.jade block includes diff --git a/public/docs/dart/latest/guide/setup.jade b/public/docs/dart/latest/guide/setup.jade index 9a1437a1de..b845550f30 100644 --- a/public/docs/dart/latest/guide/setup.jade +++ b/public/docs/dart/latest/guide/setup.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Setup for Development -//- description: How to use Dart tools to create and run Angular apps -//- sideNavGroup: basic -//- prevpage: - title: Documentation Overview - url: /angular/guide/index -//- nextpage: - title: Learning Angular - url: /angular/guide/learning-angular -//- --- -//- FilePath: src/angular/guide/setup.jade include ../_util-fns a#develop-locally diff --git a/public/docs/dart/latest/guide/structural-directives.jade b/public/docs/dart/latest/guide/structural-directives.jade index bad6e4c3fd..e3283b8c9c 100644 --- a/public/docs/dart/latest/guide/structural-directives.jade +++ b/public/docs/dart/latest/guide/structural-directives.jade @@ -1,14 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Structural Directives -//- description: Angular has a powerful template engine that lets us easily manipulate the DOM structure of our elements. -//- sideNavGroup: advanced -//- prevpage: - title: Security - url: /angular/guide/security -//- --- -//- FilePath: src/angular/guide/structural-directives.jade extends /docs/ts/_cache/guide/structural-directives.jade block includes diff --git a/public/docs/dart/latest/guide/template-syntax.jade b/public/docs/dart/latest/guide/template-syntax.jade index 811c4f3de8..e45d47eda0 100644 --- a/public/docs/dart/latest/guide/template-syntax.jade +++ b/public/docs/dart/latest/guide/template-syntax.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Template Syntax -//- description: Learn how to write templates that display data and consume user events with the help of data binding. -//- sideNavGroup: basic -//- prevpage: - title: Dependency Injection - url: /angular/guide/dependency-injection -//- nextpage: - title: Attribute Directives - url: /angular/guide/attribute-directives -//- --- -//- FilePath: src/angular/guide/template-syntax.jade extends /docs/ts/_cache/guide/template-syntax.jade block includes diff --git a/public/docs/dart/latest/guide/testing.jade b/public/docs/dart/latest/guide/testing.jade index 2899a34916..5fedc24b49 100644 --- a/public/docs/dart/latest/guide/testing.jade +++ b/public/docs/dart/latest/guide/testing.jade @@ -1,11 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Testing -//- description: Techniques and practices for testing an Angular app -//- sideNavGroup: advanced -//- --- -//- FilePath: src/angular/guide/testing.jade //- include /docs/_includes/_ts-temp :marked Page under construction — see diff --git a/public/docs/dart/latest/guide/user-input.jade b/public/docs/dart/latest/guide/user-input.jade index 9e99aedd35..10e02bc436 100644 --- a/public/docs/dart/latest/guide/user-input.jade +++ b/public/docs/dart/latest/guide/user-input.jade @@ -1,17 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: User Input -//- description: User input triggers DOM events. We listen to those events with event bindings that funnel updated values back into our components and models. -//- sideNavGroup: basic -//- prevpage: - title: Displaying Data - url: /angular/guide/displaying-data -//- nextpage: - title: Forms - url: /angular/guide/forms -//- --- -//- FilePath: src/angular/guide/user-input.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/quickstart.jade b/public/docs/dart/latest/quickstart.jade index f0428673ee..3311e46a95 100644 --- a/public/docs/dart/latest/quickstart.jade +++ b/public/docs/dart/latest/quickstart.jade @@ -1,11 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Quickstart -//- description: A quick look at Angular basics -//- toc: false -//- --- -//- FilePath: src/angular/quickstart.jade extends /docs/ts/_cache/quickstart.jade block includes diff --git a/public/docs/dart/latest/tutorial/index.jade b/public/docs/dart/latest/tutorial/index.jade index 3c7ad0cf02..77ced7dd03 100644 --- a/public/docs/dart/latest/tutorial/index.jade +++ b/public/docs/dart/latest/tutorial/index.jade @@ -1,13 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: "Tutorial: Tour of Heroes" -//- description: The Tour of Heroes tutorial takes us through the steps of creating an Angular application in Dart. -//- nextpage: - title: The Hero Editor - url: /angular/tutorial/toh-pt1 -//- --- -//- FilePath: src/angular/tutorial/index.jade extends /docs/ts/_cache/tutorial/index.jade block includes diff --git a/public/docs/dart/latest/tutorial/toh-pt1.jade b/public/docs/dart/latest/tutorial/toh-pt1.jade index 9d1e494727..6c2bc21d4f 100644 --- a/public/docs/dart/latest/tutorial/toh-pt1.jade +++ b/public/docs/dart/latest/tutorial/toh-pt1.jade @@ -1,16 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: The Hero Editor -//- description: We build a simple hero editor -//- prevpage: - title: "Tutorial: Tour of Heroes" - url: /angular/tutorial/index -//- nextpage: - title: Master/Detail - url: /angular/tutorial/toh-pt2 -//- --- -//- FilePath: src/angular/tutorial/toh-pt1.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt2.jade b/public/docs/dart/latest/tutorial/toh-pt2.jade index e8d64e7e5d..3d8c21e5c8 100644 --- a/public/docs/dart/latest/tutorial/toh-pt2.jade +++ b/public/docs/dart/latest/tutorial/toh-pt2.jade @@ -1,16 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Master/Detail -//- description: We build a master/detail page with a list of heroes -//- prevpage: - title: The Hero Editor - url: /angular/tutorial/toh-pt1 -//- nextpage: - title: Multiple Components - url: /angular/tutorial/toh-pt3 -//- --- -//- FilePath: src/angular/tutorial/toh-pt2.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt3.jade b/public/docs/dart/latest/tutorial/toh-pt3.jade index 8d448dbad2..0c629c439f 100644 --- a/public/docs/dart/latest/tutorial/toh-pt3.jade +++ b/public/docs/dart/latest/tutorial/toh-pt3.jade @@ -1,16 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Multiple Components -//- description: We refactor the master/detail view into separate components -//- prevpage: - title: Master/Detail - url: /angular/tutorial/toh-pt2 -//- nextpage: - title: Services - url: /angular/tutorial/toh-pt4 -//- --- -//- FilePath: src/angular/tutorial/toh-pt3.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt4.jade b/public/docs/dart/latest/tutorial/toh-pt4.jade index 2d5a60dd84..e585db6dd2 100644 --- a/public/docs/dart/latest/tutorial/toh-pt4.jade +++ b/public/docs/dart/latest/tutorial/toh-pt4.jade @@ -1,16 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Services -//- description: We create a reusable service to manage our hero data calls -//- prevpage: - title: Multiple Components - url: /angular/tutorial/toh-pt3 -//- nextpage: - title: Routing - url: /angular/tutorial/toh-pt5 -//- --- -//- FilePath: src/angular/tutorial/toh-pt4.jade include ../_util-fns :marked diff --git a/public/docs/dart/latest/tutorial/toh-pt5.jade b/public/docs/dart/latest/tutorial/toh-pt5.jade index 37918b3129..1f98e71823 100644 --- a/public/docs/dart/latest/tutorial/toh-pt5.jade +++ b/public/docs/dart/latest/tutorial/toh-pt5.jade @@ -1,16 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: Routing -//- description: We add the Angular Component Router and learn to navigate among the views -//- prevpage: - title: Services - url: /angular/tutorial/toh-pt4 -//- nextpage: - title: HTTP - url: /angular/tutorial/toh-pt6 -//- --- -//- FilePath: src/angular/tutorial/toh-pt5.jade extends /docs/ts/_cache/tutorial/toh-pt5 block includes diff --git a/public/docs/dart/latest/tutorial/toh-pt6.jade b/public/docs/dart/latest/tutorial/toh-pt6.jade index 18b3ebad59..94ba2d5ed5 100644 --- a/public/docs/dart/latest/tutorial/toh-pt6.jade +++ b/public/docs/dart/latest/tutorial/toh-pt6.jade @@ -1,13 +1,3 @@ -//- --- -//- WARNING: THIS FILE IS AUTOGENERATED FROM ANGULAR.IO; DO NOT EDIT -//- layout: angular -//- title: HTTP -//- description: We convert our service and components to use Angular's HTTP service -//- prevpage: - title: Routing - url: /angular/tutorial/toh-pt5 -//- --- -//- FilePath: src/angular/tutorial/toh-pt6.jade extends /docs/ts/_cache/tutorial/toh-pt6.jade block includes From 25ad80a3c1ed1670b164cca522c9750bb1180b5a Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 10:57:56 -0800 Subject: [PATCH 06/10] backport Dart _util-fns.jade --- public/docs/dart/latest/_util-fns.jade | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/public/docs/dart/latest/_util-fns.jade b/public/docs/dart/latest/_util-fns.jade index 49d1115ba7..6991283222 100644 --- a/public/docs/dart/latest/_util-fns.jade +++ b/public/docs/dart/latest/_util-fns.jade @@ -1,4 +1,4 @@ -include ../../../_includes/_util-fns +include /_includes/_util-fns //- See the _util-fns file included above for a description of the use of these variables. - var _docsFor = 'dart'; From 860551ca8a6be3d4d81a7baf4a566972658ae242 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 9 Dec 2016 11:02:17 -0800 Subject: [PATCH 07/10] remove docs/dart --- public/docs/dart/latest/_data.json | 84 --- public/docs/dart/latest/_util-fns.jade | 72 -- public/docs/dart/latest/api/_data.json | 6 - public/docs/dart/latest/api/index.jade | 12 - public/docs/dart/latest/cheatsheet.jade | 4 - public/docs/dart/latest/cookbook/_data.json | 72 -- .../cookbook/a1-a2-quick-reference.jade | 1 - .../dart/latest/cookbook/aot-compiler.jade | 1 - .../cookbook/component-communication.jade | 1 - .../cookbook/component-relative-paths.jade | 1 - .../latest/cookbook/dependency-injection.jade | 1 - .../cookbook/dynamic-form-deprecated.jade | 1 - .../dart/latest/cookbook/dynamic-form.jade | 1 - .../dart/latest/cookbook/form-validation.jade | 1 - public/docs/dart/latest/cookbook/i18n.jade | 1 - public/docs/dart/latest/cookbook/index.jade | 1 - .../dart/latest/cookbook/ngmodule-faq.jade | 1 - .../latest/cookbook/set-document-title.jade | 1 - .../docs/dart/latest/cookbook/ts-to-js.jade | 1 - .../latest/cookbook/visual-studio-2015.jade | 1 - public/docs/dart/latest/glossary.jade | 60 -- public/docs/dart/latest/guide/_data.json | 197 ------ public/docs/dart/latest/guide/animations.jade | 1 - .../docs/dart/latest/guide/architecture.jade | 73 -- .../latest/guide/attribute-directives.jade | 10 - .../dart/latest/guide/browser-support.jade | 1 - public/docs/dart/latest/guide/cheatsheet.jade | 1 - .../dart/latest/guide/component-styles.jade | 35 - .../latest/guide/dependency-injection.jade | 157 ----- .../dart/latest/guide/displaying-data.jade | 21 - public/docs/dart/latest/guide/forms.jade | 656 ------------------ public/docs/dart/latest/guide/glossary.jade | 4 - .../hierarchical-dependency-injection.jade | 5 - .../guide/images/create-ng2-project.png | Bin 46968 -> 0 bytes .../guide/images/ng-model-in-action-2.png | Bin 14571 -> 0 bytes public/docs/dart/latest/guide/index.jade | 5 - .../dart/latest/guide/learning-angular.jade | 5 - .../dart/latest/guide/lifecycle-hooks.jade | 19 - public/docs/dart/latest/guide/ngmodule.jade | 1 - .../docs/dart/latest/guide/npm-packages.jade | 8 - public/docs/dart/latest/guide/pipes.jade | 12 - public/docs/dart/latest/guide/router.jade | 6 - public/docs/dart/latest/guide/security.jade | 1 - .../latest/guide/server-communication.jade | 83 --- public/docs/dart/latest/guide/setup.jade | 161 ----- .../latest/guide/structural-directives.jade | 10 - .../docs/dart/latest/guide/style-guide.jade | 1 - .../dart/latest/guide/template-syntax.jade | 119 ---- public/docs/dart/latest/guide/testing.jade | 5 - .../guide/typescript-configuration.jade | 1 - public/docs/dart/latest/guide/upgrade.jade | 1 - public/docs/dart/latest/guide/user-input.jade | 254 ------- public/docs/dart/latest/guide/webpack.jade | 1 - public/docs/dart/latest/help.jade | 43 -- public/docs/dart/latest/index.jade | 7 - public/docs/dart/latest/quickstart.jade | 6 - public/docs/dart/latest/resources.jade | 40 -- public/docs/dart/latest/styleguide.jade | 1 - public/docs/dart/latest/tutorial/_data.json | 38 - public/docs/dart/latest/tutorial/index.jade | 5 - public/docs/dart/latest/tutorial/toh-pt1.jade | 185 ----- public/docs/dart/latest/tutorial/toh-pt2.jade | 302 -------- public/docs/dart/latest/tutorial/toh-pt3.jade | 255 ------- public/docs/dart/latest/tutorial/toh-pt4.jade | 400 ----------- public/docs/dart/latest/tutorial/toh-pt5.jade | 169 ----- public/docs/dart/latest/tutorial/toh-pt6.jade | 192 ----- 66 files changed, 3821 deletions(-) delete mode 100644 public/docs/dart/latest/_data.json delete mode 100644 public/docs/dart/latest/_util-fns.jade delete mode 100644 public/docs/dart/latest/api/_data.json delete mode 100644 public/docs/dart/latest/api/index.jade delete mode 100644 public/docs/dart/latest/cheatsheet.jade delete mode 100644 public/docs/dart/latest/cookbook/_data.json delete mode 100644 public/docs/dart/latest/cookbook/a1-a2-quick-reference.jade delete mode 100644 public/docs/dart/latest/cookbook/aot-compiler.jade delete mode 100644 public/docs/dart/latest/cookbook/component-communication.jade delete mode 100644 public/docs/dart/latest/cookbook/component-relative-paths.jade delete mode 100644 public/docs/dart/latest/cookbook/dependency-injection.jade delete mode 100644 public/docs/dart/latest/cookbook/dynamic-form-deprecated.jade delete mode 100644 public/docs/dart/latest/cookbook/dynamic-form.jade delete mode 100644 public/docs/dart/latest/cookbook/form-validation.jade delete mode 100644 public/docs/dart/latest/cookbook/i18n.jade delete mode 100644 public/docs/dart/latest/cookbook/index.jade delete mode 100644 public/docs/dart/latest/cookbook/ngmodule-faq.jade delete mode 100644 public/docs/dart/latest/cookbook/set-document-title.jade delete mode 100644 public/docs/dart/latest/cookbook/ts-to-js.jade delete mode 100644 public/docs/dart/latest/cookbook/visual-studio-2015.jade delete mode 100644 public/docs/dart/latest/glossary.jade delete mode 100644 public/docs/dart/latest/guide/_data.json delete mode 100644 public/docs/dart/latest/guide/animations.jade delete mode 100644 public/docs/dart/latest/guide/architecture.jade delete mode 100644 public/docs/dart/latest/guide/attribute-directives.jade delete mode 100644 public/docs/dart/latest/guide/browser-support.jade delete mode 100644 public/docs/dart/latest/guide/cheatsheet.jade delete mode 100644 public/docs/dart/latest/guide/component-styles.jade delete mode 100644 public/docs/dart/latest/guide/dependency-injection.jade delete mode 100644 public/docs/dart/latest/guide/displaying-data.jade delete mode 100644 public/docs/dart/latest/guide/forms.jade delete mode 100644 public/docs/dart/latest/guide/glossary.jade delete mode 100644 public/docs/dart/latest/guide/hierarchical-dependency-injection.jade delete mode 100644 public/docs/dart/latest/guide/images/create-ng2-project.png delete mode 100644 public/docs/dart/latest/guide/images/ng-model-in-action-2.png delete mode 100644 public/docs/dart/latest/guide/index.jade delete mode 100644 public/docs/dart/latest/guide/learning-angular.jade delete mode 100644 public/docs/dart/latest/guide/lifecycle-hooks.jade delete mode 100644 public/docs/dart/latest/guide/ngmodule.jade delete mode 100644 public/docs/dart/latest/guide/npm-packages.jade delete mode 100644 public/docs/dart/latest/guide/pipes.jade delete mode 100644 public/docs/dart/latest/guide/router.jade delete mode 100644 public/docs/dart/latest/guide/security.jade delete mode 100644 public/docs/dart/latest/guide/server-communication.jade delete mode 100644 public/docs/dart/latest/guide/setup.jade delete mode 100644 public/docs/dart/latest/guide/structural-directives.jade delete mode 100644 public/docs/dart/latest/guide/style-guide.jade delete mode 100644 public/docs/dart/latest/guide/template-syntax.jade delete mode 100644 public/docs/dart/latest/guide/testing.jade delete mode 100644 public/docs/dart/latest/guide/typescript-configuration.jade delete mode 100644 public/docs/dart/latest/guide/upgrade.jade delete mode 100644 public/docs/dart/latest/guide/user-input.jade delete mode 100644 public/docs/dart/latest/guide/webpack.jade delete mode 100644 public/docs/dart/latest/help.jade delete mode 100644 public/docs/dart/latest/index.jade delete mode 100644 public/docs/dart/latest/quickstart.jade delete mode 100644 public/docs/dart/latest/resources.jade delete mode 100644 public/docs/dart/latest/styleguide.jade delete mode 100644 public/docs/dart/latest/tutorial/_data.json delete mode 100644 public/docs/dart/latest/tutorial/index.jade delete mode 100644 public/docs/dart/latest/tutorial/toh-pt1.jade delete mode 100644 public/docs/dart/latest/tutorial/toh-pt2.jade delete mode 100644 public/docs/dart/latest/tutorial/toh-pt3.jade delete mode 100644 public/docs/dart/latest/tutorial/toh-pt4.jade delete mode 100644 public/docs/dart/latest/tutorial/toh-pt5.jade delete mode 100644 public/docs/dart/latest/tutorial/toh-pt6.jade diff --git a/public/docs/dart/latest/_data.json b/public/docs/dart/latest/_data.json deleted file mode 100644 index b935cdc57e..0000000000 --- a/public/docs/dart/latest/_data.json +++ /dev/null @@ -1,84 +0,0 @@ -{ - "index": { - "icon": "home", - "title": "Angular Docs", - "subtitle": "Dart", - "menuTitle": "Docs Home", - "banner": "AngularDart is 2.2. View the change log to see enhancements, fixes, and breaking changes." - }, - - "cli-quickstart": { - "icon": "query-builder", - "title": "CLI Quickstart", - "subtitle": "TypeScript", - "description": "Use the CLI tool to quickly build Angular applications", - "hide": true - }, - - "quickstart": { - "icon": "query-builder", - "title": "Quickstart", - "subtitle": "Dart", - "banner": "A quick look at Angular basics" - }, - - "tutorial": { - "icon": "list", - "title": "Tutorial", - "subtitle": "Dart" - }, - - "guide": { - "icon": "list", - "title": "Guide", - "subtitle": "Dart" - }, - - "cookbook": { - "icon": "list", - "title": "Cookbook", - "subtitle": "Dart", - "banner": "How to solve common implementation challenges." - }, - - "api/": { - "icon": "book", - "title": "API Reference", - "subtitle": "Dart", - "reference": true - }, - - "cheatsheet": { - "title": "Cheat Sheet", - "long-title": "Cheat Sheet v2", - "subtitle": "Dart", - "reference": false - }, - - "glossary": { - "title": "Glossary", - "subtitle": "Dart", - "intro": "Brief definitions of the most important words in the Angular vocabulary", - "reference": false - }, - - "resources": { - "icon": "play-circle-fill", - "title": "Angular Resources", - "subtitle": "Dart", - "resources": true - }, - - "help": { - "icon": "chat", - "title": "Help & Support", - "subtitle": "From our team & community", - "resources": true - }, - - "styleguide": { - "title": "Docs Style Guide", - "subtitle": "Dart", - "intro": "Design & Layout Patterns For Documentation" - } -} diff --git a/public/docs/dart/latest/_util-fns.jade b/public/docs/dart/latest/_util-fns.jade deleted file mode 100644 index 6991283222..0000000000 --- a/public/docs/dart/latest/_util-fns.jade +++ /dev/null @@ -1,72 +0,0 @@ -include /_includes/_util-fns - -//- See the _util-fns file included above for a description of the use of these variables. -- var _docsFor = 'dart'; -- var _decorator = 'annotation'; -- var _Array = 'List'; -- var _array = 'list'; -- var _a = 'an'; -- var _an = 'a'; -- var _priv = '_'; -- var _Lang = 'Dart'; -- var _Promise = 'Future'; -- var _FutureUrl = 'https://api.dartlang.org/dart_async/Future.html'; -- var _PromiseLinked = '' + _Promise + ''; -- var _Observable = 'Stream'; -- var _liveLink = 'sample repo'; -- var _truthy = 'true'; -- var _falsey = 'false'; -- var _appDir = 'lib'; -- var _indexHtmlDir = 'web'; -- var _mainDir = 'web'; -- var _ngRepoURL = 'https://github.com/dart-lang/angular2'; -//- Don't override this value quite yet: -//- var _ngDocRepoURL = 'https://github.com/dart-lang/site-webdev'; -- var _qsRepo = 'https://github.com/angular-examples/quickstart' -- var _qsRepoZip = _qsRepo + '/archive/master.zip'; - -- var _npm = 'pub'; - -//- NgModule related -- var _AppModuleVsAppComp = 'AppComponent' -- var _appModuleTsVsAppCompTs = 'app/app_component.dart' -- var _appModuleTsVsMainTs = 'web/main.dart' -- var _bootstrapModule = 'bootstrap' -- var _declsVsDirectives = 'directives' -- var _moduleVsComp = 'component' -- var _moduleVsRootComp = 'root component' -- var _platformBrowserDynamicVsBootStrap = 'bootstrap' - -- var adjustTsExamplePathForDart = function(_path) { -- if(!_path) return _path; -- var path = _path.trim(); -- var folder = getFolder(path); -- var extn = getExtn(path); -- // if(extn == 'dart') return path; -- var baseName = getBaseFileName(path) || path; // TODO: have getBaseFileName() return path -- var baseNameNoExt = baseName.substr(0,baseName.length - (extn.length + 1)); -- var inWebFolder = baseNameNoExt.match(/^(main|index)(\.\d)?$/); -- // Adjust the folder path, e.g., ts -> dart -- folder = folder.replace(/(^|\/)ts($|\/)/, '$1dart$2').replace(/(^|\/)app($|\/)/, inWebFolder ? '$1web$2' : '$1lib$2'); -- // Special case not handled above: e.g., index.html -> web/index.html -- if(baseNameNoExt.match(/^(index|styles)(\.\d)?$/) && !folder.match(/web$/)) folder = (folder ? folder + '/' : '') + 'web'; -- // In file name, replace special characters with underscore -- baseNameNoExt = baseNameNoExt.replace(/[\-\.]/g, '_'); -- // Adjust the file extension -- if(extn == 'ts') extn = 'dart'; -- return (folder ? folder + '/' : '') + baseNameNoExt + (extn ? '.' + extn : ''); -- }; - -- var adjustTsExampleTitleForDart = function(_title) { -- if(!_title || !adjustTsExamplePathForDart) return _title; -- var title = _title.trim(); -- // Assume title is a path if it ends with an extension like '.foo', -- // optionally followed by some comment in parentheses. -- var matches = title.match(/(.*\.\w+)($|\s*\([\w ]+\)$)/); -- if(matches && matches.length == 3) { -- // e.g. matches == ['abc.ts (excerpt)', 'abc.ts', ' (excerpt)'] -- var path = adjustTsExamplePathForDart(matches[1]); -- title = path + matches[2]; -- } -- return title; -- } diff --git a/public/docs/dart/latest/api/_data.json b/public/docs/dart/latest/api/_data.json deleted file mode 100644 index 403220eabe..0000000000 --- a/public/docs/dart/latest/api/_data.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "index" : { - "title": "API Reference", - "long-title": "API Reference v2" - } -} diff --git a/public/docs/dart/latest/api/index.jade b/public/docs/dart/latest/api/index.jade deleted file mode 100644 index cdf4db0b3b..0000000000 --- a/public/docs/dart/latest/api/index.jade +++ /dev/null @@ -1,12 +0,0 @@ -include ../_util-fns - -:marked - > **Known issues:** The Angular issue tracker contains - [all known issues][api-issues]; if you notice others, please - [report them][new-issue]. Thanks! - - [new-issue]: !{_ngRepoURL}/issues/new?title=%5BAPI%20docs%5D - [api-issues]: !{_ngRepoURL}/issues -//- ?q=label%3Aapi - -api-list(src="api-list.json" lang="dart") diff --git a/public/docs/dart/latest/cheatsheet.jade b/public/docs/dart/latest/cheatsheet.jade deleted file mode 100644 index 8bad00b1ca..0000000000 --- a/public/docs/dart/latest/cheatsheet.jade +++ /dev/null @@ -1,4 +0,0 @@ -- var base = current.path[4] ? '.' : './guide'; - -.l-content-small.docs-content.cheatsheet - ngio-cheatsheet(src= base + '/cheatsheet.json') diff --git a/public/docs/dart/latest/cookbook/_data.json b/public/docs/dart/latest/cookbook/_data.json deleted file mode 100644 index eb1a46ace4..0000000000 --- a/public/docs/dart/latest/cookbook/_data.json +++ /dev/null @@ -1,72 +0,0 @@ -{ - "index": { - "title": "Cookbook", - "navTitle": "Overview", - "intro": "A collection of recipes for common Angular application scenarios" - }, - - "a1-a2-quick-reference": { - "title": "Angular 1 to 2 Quick Reference", - "navTitle": "Angular 1 to 2 Quick Ref", - "intro": "Learn how Angular 1 concepts and techniques map to Angular 2", - "hide": true - }, - - "ngmodule-faq": { - "title": "Angular Module FAQs", - "intro": "Answers to frequently asked questions about @NgModule", - "hide": true - }, - - "component-communication": { - "title": "Component Interaction", - "intro": "Share information between different directives and components" - }, - - "component-relative-paths": { - "title": "Component-relative Paths", - "intro": "Use relative URLs for component templates and styles.", - "hide": true - }, - - "dependency-injection": { - "title": "Dependency Injection", - "intro": "Techniques for Dependency Injection", - "hide": true - }, - - "dynamic-forms": { - "title": "Dynamic Form", - "intro": "Render dynamic forms with NgFormModel", - "hide": true - }, - - "form-validation": { - "title": "Form Validation", - "intro": "Validate user's form entries", - "hide": true - }, - - "i18n": { - "title": "Internationalization (i18n)", - "intro": "Translate the app's template text into multiple languages", - "hide": true - }, - - "set-document-title": { - "title": "Set the Document Title", - "intro": "Setting the document or window title using the Title service." - }, - - "ts-to-js": { - "title": "TypeScript to JavaScript", - "intro": "Convert Angular TypeScript examples into ES6 and ES5 JavaScript", - "hide": true - }, - - "visual-studio-2015": { - "title": "Visual Studio 2015 QuickStart", - "intro": "Use Visual Studio 2015 with the QuickStart files", - "hide": true - } -} diff --git a/public/docs/dart/latest/cookbook/a1-a2-quick-reference.jade b/public/docs/dart/latest/cookbook/a1-a2-quick-reference.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/a1-a2-quick-reference.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/aot-compiler.jade b/public/docs/dart/latest/cookbook/aot-compiler.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/aot-compiler.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/component-communication.jade b/public/docs/dart/latest/cookbook/component-communication.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/component-communication.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/component-relative-paths.jade b/public/docs/dart/latest/cookbook/component-relative-paths.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/component-relative-paths.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/dependency-injection.jade b/public/docs/dart/latest/cookbook/dependency-injection.jade deleted file mode 100644 index 4782ba81d3..0000000000 --- a/public/docs/dart/latest/cookbook/dependency-injection.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp \ No newline at end of file diff --git a/public/docs/dart/latest/cookbook/dynamic-form-deprecated.jade b/public/docs/dart/latest/cookbook/dynamic-form-deprecated.jade deleted file mode 100644 index 4782ba81d3..0000000000 --- a/public/docs/dart/latest/cookbook/dynamic-form-deprecated.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp \ No newline at end of file diff --git a/public/docs/dart/latest/cookbook/dynamic-form.jade b/public/docs/dart/latest/cookbook/dynamic-form.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/dynamic-form.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/form-validation.jade b/public/docs/dart/latest/cookbook/form-validation.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/form-validation.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/i18n.jade b/public/docs/dart/latest/cookbook/i18n.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/i18n.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/index.jade b/public/docs/dart/latest/cookbook/index.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/index.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/ngmodule-faq.jade b/public/docs/dart/latest/cookbook/ngmodule-faq.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/ngmodule-faq.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/set-document-title.jade b/public/docs/dart/latest/cookbook/set-document-title.jade deleted file mode 100644 index 4782ba81d3..0000000000 --- a/public/docs/dart/latest/cookbook/set-document-title.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp \ No newline at end of file diff --git a/public/docs/dart/latest/cookbook/ts-to-js.jade b/public/docs/dart/latest/cookbook/ts-to-js.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/cookbook/ts-to-js.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/cookbook/visual-studio-2015.jade b/public/docs/dart/latest/cookbook/visual-studio-2015.jade deleted file mode 100644 index 4782ba81d3..0000000000 --- a/public/docs/dart/latest/cookbook/visual-studio-2015.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp \ No newline at end of file diff --git a/public/docs/dart/latest/glossary.jade b/public/docs/dart/latest/glossary.jade deleted file mode 100644 index e2fc99518a..0000000000 --- a/public/docs/dart/latest/glossary.jade +++ /dev/null @@ -1,60 +0,0 @@ -extends /docs/ts/_cache/glossary.jade - -block includes - - var _example = 'glossary'; - include _util-fns - -block annotation-defn - :marked - When unqualified, _annotation_ refers to a Dart [metadata - annotation][metadata] (as opposed to, say, a type annotation). A metadata - annotation begins with the character `@`, followed by either a reference - to a compile-time constant (such as [`Component`](#component)) or a call - to a constant constructor. See the [Dart Language Guide][metadata] for - details. - - The corresponding term in TypeScript and JavaScript is - [_decorator_](https://angular.io/docs/ts/latest/glossary.html#decorator). - - [metadata]: https://www.dartlang.org/guides/language/language-tour#metadata - -block bootstrap-defn-top - :marked - You launch an Angular application by "bootstrapping" it with the - [bootstrap][bootstrap] method. Bootstraping identifies an - application's top level "root" [component](#component), which is - the first component that is loaded for the application, and optionally - registers service [providers](#provider) with the [dependency injection - system](#dependency-injection). - For more information, see the [Setup](!{docsLatest}/guide/setup.html) page. - - [bootstrap]: !{docsLatest}/api/angular2.platform.browser/bootstrap.html - -block decorator-defn - :marked - When used in this guide, these JavaScript terms are taken as synonymous with - [annotation](#annotation). - -block module-defn - //- Taken from the Dart Difference in guide/architecture.jade - :marked - In this guide, the term _module_ refers to a Dart compilation unit, such - as a library, or a package. (If a Dart file has no `library` or `part` - directive, then that file itself is a library and thus a compilation - unit.) For more information about compilation units, see - the chapter on "Libraries and Scripts" in the - [Dart Language Specification](https://www.dartlang.org/docs/spec/). - -block append snake-case-defn - :marked - Library and file names are often spelled in snake_case. Examples include: - `angular_tour_of_heroes` and `app_component.dart`. - -block zone-defn - :marked - Zones are a mechanism for encapsulating and intercepting - a Dart application's asynchronous activity. - - Learn more about zones in this [article][zones]. - - [zones]: https://www.dartlang.org/articles/libraries/zones diff --git a/public/docs/dart/latest/guide/_data.json b/public/docs/dart/latest/guide/_data.json deleted file mode 100644 index 7cec8bd4fb..0000000000 --- a/public/docs/dart/latest/guide/_data.json +++ /dev/null @@ -1,197 +0,0 @@ -{ - "index": { - "title": "Documentation Overview", - "navTitle": "Overview", - "intro": "How to read and use this documentation", - "nextable": true, - "basics": true - }, - - "setup": { - "title": "Setup for Development", - "navTitle": "Setup", - "intro": "How to use Dart tools to create and run Angular apps", - "nextable": true, - "hideNextPage": true, - "basics": true - }, - - "learning-angular": { - "title": "Learning Angular", - "navTitle": "Learning Angular", - "intro": "A suggested path through the documentation for Angular newcomers", - "nextable": true, - "hideNextPage": true, - "basics": true - }, - - "architecture": { - "title": "Architecture Overview", - "navTitle": "Architecture", - "intro": "The basic building blocks of Angular applications", - "nextable": true, - "basics": true - }, - - "displaying-data": { - "title": "Displaying Data", - "intro": "Property binding helps show app data in the UI.", - "nextable": true, - "basics": true - }, - - "user-input": { - "title": "User Input", - "intro": "User input triggers DOM events. We listen to those events with event bindings that funnel updated values back into our components and models.", - "nextable": true, - "basics": true - }, - - "forms": { - "title": "Forms", - "intro": "A form creates a cohesive, effective, and compelling data entry experience. An Angular form coordinates a set of data-bound user controls, tracks changes, validates input, and presents errors.", - "nextable": true, - "basics": true - }, - - "dependency-injection": { - "title": "Dependency Injection", - "intro": "Angular's dependency injection system creates and delivers dependent services \"just-in-time\".", - "nextable": true, - "basics": true - }, - - "template-syntax": { - "title": "Template Syntax", - "intro": "Learn how to write templates that display data and consume user events with the help of data binding.", - "nextable": true, - "basics": true - }, - - "cheatsheet": { - "title": "Cheat Sheet", - "subtitle": "Dart", - "nextable": true, - "basics": true - }, - - "style-guide": { - "hide": true, - "title": "Style Guide", - "intro": "Write Angular with style.", - "basics": true - }, - - "glossary": { - "title": "Glossary", - "intro": "Brief definitions of the most important words in the Angular vocabulary", - "basics": true - }, - - "change-log": { - "hide": true, - "title": "Change Log", - "intro": "An annotated history of recent documentation improvements.", - "basics": true - }, - - "ngmodule": { - "hide": true, - "title": "Angular Modules (NgModule)", - "intro": "Define application modules with @NgModule" - }, - - "animations": { - "hide": true, - "title": "Animations", - "intro": "A guide to Angular's animation system." - }, - - "attribute-directives": { - "title": "Attribute Directives", - "intro": "Attribute directives attach behavior to elements." - }, - - "browser-support": { - "hide": true, - "title": "Browser support", - "intro": "Browser support and polyfills guide." - }, - - "component-styles": { - "title": "Component Styles", - "intro": "Learn how to apply CSS styles to components." - }, - - "hierarchical-dependency-injection": { - "title": "Hierarchical Dependency Injectors", - "navTitle": "Hierarchical Injectors", - "intro": "Angular's hierarchical dependency injection system supports nested injectors in parallel with the component tree." - }, - - "server-communication": { - "title": "HTTP Client", - "intro": "Use an HTTP Client to talk to a remote server." - }, - - "lifecycle-hooks": { - "title": "Lifecycle Hooks", - "intro": "Angular calls lifecycle hook methods on directives and components as it creates, changes, and destroys them." - }, - - "npm-packages": { - "hide": true, - "title": "Npm Packages", - "intro": "Recommended npm packages, and how to specify package dependencies" - }, - - "pipes": { - "title": "Pipes", - "intro": "Pipes transform displayed values within a template." - }, - - "router": { - "title": "Routing & Navigation", - "intro": "Discover the basics of screen navigation with the Angular Router." - }, - - "security": { - "title": "Security", - "intro": "Developing for content security in Angular applications" - }, - - "setup-systemjs-anatomy": { - "hide": true, - "title": "Setup Anatomy", - "intro": "Inside the local development environment for SystemJS" - }, - - "structural-directives": { - "title": "Structural Directives", - "intro": "Angular has a powerful template engine that lets us easily manipulate the DOM structure of our elements." - }, - - "testing": { - "hide": true, - "title": "Testing", - "intro": "Techniques and practices for testing an Angular app" - }, - - "typescript-configuration": { - "hide": true, - "title": "TypeScript Configuration", - "intro": "TypeScript configuration for Angular developers" - }, - - "upgrade": { - "hide": true, - "title": "Upgrading from 1.x", - "intro": "Incrementally upgrade an Angular 1 application to Angular 2." - }, - - "webpack": { - "hide": true, - "title": "Webpack: an introduction", - "intro": "Create Angular applications with a Webpack based tooling" - } -} diff --git a/public/docs/dart/latest/guide/animations.jade b/public/docs/dart/latest/guide/animations.jade deleted file mode 100644 index 3b647d5616..0000000000 --- a/public/docs/dart/latest/guide/animations.jade +++ /dev/null @@ -1 +0,0 @@ -include /docs/_includes/_ts-temp diff --git a/public/docs/dart/latest/guide/architecture.jade b/public/docs/dart/latest/guide/architecture.jade deleted file mode 100644 index 9d40061014..0000000000 --- a/public/docs/dart/latest/guide/architecture.jade +++ /dev/null @@ -1,73 +0,0 @@ -extends /docs/ts/_cache/guide/architecture.jade - -block includes - - var _example = 'architecture'; - include ../_util-fns - - var _library_module = 'library' - - var _at_angular = 'angular2' - -:marked - Angular is a framework to help us build client applications in HTML and - either JavaScript or a language (like Dart or TypeScript) that compiles to JavaScript. - -block angular-parts - :marked - Angular for Dart is published as the `angular2` package, which - (like many other Dart packages) is available via the Pub tool. - -block modules-in-dart - .callout.is-helpful - header Dart difference: Modules are compilation units or packages - :marked - In this guide, the term _module_ refers to a Dart compilation unit, such - as a library, or a package. (If a Dart file has no `library` or `part` - directive, then that file itself is a library and thus a compilation - unit.) For more information about compilation units, see - the chapter on "Libraries and Scripts" in the - [Dart Language Specification](https://www.dartlang.org/docs/spec/). - -block modules-are-optional - //- N/A - -block export-qualifier - .callout.is-helpful - header Dart difference: Public names are exported by default - :marked - Contrary to TypeScript, a Dart library always exports all names and - declarations in its **public** namespace, making explicit `export` - qualifiers unnecessary. - - When we say that a module _exports_ a declaration, we mean that the - declaration is _public_. For more details about name spaces and export - statements, see the section on "Exports" in the - [Dart Language Specification](https://www.dartlang.org/docs/spec/). - -block ts-import - //- N/A - -block angular-library-modules - :marked - Angular ships as a collection of libraries within the - [**angular2**](https://pub.dartlang.org/packages/angular2) package. - -block angular-imports - +makeExcerpt('app/app.component.ts', 'import') - -block ts-decorator - :marked - Annotations often have configuration parameters. - The `@Component` annotation takes parameters to provide the - information Angular needs to create and present the component and its view. - - Here are a few of the possible `@Component` parameters: - -block dart-bool - .callout.is-helpful - header Dart difference: Only true is true - :marked - In Dart, **the only value that is true is the boolean value `true`**; all - other values are false. JavaScript and TypeScript, in contrast, treat values - such as 1 and most non-null objects as true. For this reason, the JavaScript - and TypeScript versions of this app can use just `selectedHero` as the value - of the `*ngIf` expression. The Dart version must use a boolean operator such - as `!=` instead. diff --git a/public/docs/dart/latest/guide/attribute-directives.jade b/public/docs/dart/latest/guide/attribute-directives.jade deleted file mode 100644 index 7e3d48a92e..0000000000 --- a/public/docs/dart/latest/guide/attribute-directives.jade +++ /dev/null @@ -1,10 +0,0 @@ -extends /docs/ts/_cache/guide/attribute-directives.jade - -block includes - - var _example = 'attribute-directives'; - include ../_util-fns - -block highlight-directive-1 - :marked - We begin by importing the Angular `core`. - Then we define the directive metadata by means of the `@Directive` annotation. diff --git a/public/docs/dart/latest/guide/browser-support.jade b/public/docs/dart/latest/guide/browser-support.jade deleted file mode 100644 index c743361ac8..0000000000 --- a/public/docs/dart/latest/guide/browser-support.jade +++ /dev/null @@ -1 +0,0 @@ -include ../../../_includes/_ts-temp diff --git a/public/docs/dart/latest/guide/cheatsheet.jade b/public/docs/dart/latest/guide/cheatsheet.jade deleted file mode 100644 index 51a21522a9..0000000000 --- a/public/docs/dart/latest/guide/cheatsheet.jade +++ /dev/null @@ -1 +0,0 @@ -extends ../cheatsheet diff --git a/public/docs/dart/latest/guide/component-styles.jade b/public/docs/dart/latest/guide/component-styles.jade deleted file mode 100644 index 0980ca0eac..0000000000 --- a/public/docs/dart/latest/guide/component-styles.jade +++ /dev/null @@ -1,35 +0,0 @@ -extends /docs/ts/_cache/guide/component-styles.jade - -block includes - - var _example = 'component-styles'; - include ../_util-fns - -//- TODO: consider adding material equivalent to TS Appendices 1 & 2 if relevant. - -block style-url - :marked - Note that the URLs in `styleUrls` are relative to the component. - -block module-bundlers - //- TODO: determine if an equivalent of the TS material is relevant for Dart. - //- Leaving empty for now. - -block css-import-url - :marked - In *this* case the URL is relative to the CSS file into which we are importing. - .alert.is-important - :marked - URLs are currently not interpreted in this way, see - [issue 8518](https://github.com/angular/angular/issues/8518). - Until this issue is fixed, absolute package-reference style URLs must - be given as is illustrated below. - -block module-id - :marked - Thankfully, this is the default interpretation of relative URLs in - Angular2 for Dart: - - +makeExcerpt('app/quest-summary.component.ts', 'urls', '') - - - diff --git a/public/docs/dart/latest/guide/dependency-injection.jade b/public/docs/dart/latest/guide/dependency-injection.jade deleted file mode 100644 index 6c679c2919..0000000000 --- a/public/docs/dart/latest/guide/dependency-injection.jade +++ /dev/null @@ -1,157 +0,0 @@ -extends /docs/ts/_cache/guide/dependency-injection.jade - -block includes - - var _example = 'dependency-injection'; - include ../_util-fns - - var _thisDot = ''; - -block ctor-syntax - .l-sub-section - :marked - We also leveraged Dart's constructor syntax for declaring parameters and - initializing properties simultaneously. - -block register-provider-ngmodule - :marked - Before we do, let's see an example of provider registration during bootstrapping: - - +makeExcerpt('app/main.1.ts (discouraged)', 'bootstrap-discouraged', '') - - :marked - The injector now knows about our `HeroService`. - An instance of our `HeroService` will be available for injection across our entire application. - - Of course we can't help wondering about that comment telling us not to do it this way. - It *will* work. It's just not a best practice. - The bootstrap provider option is intended for configuring and overriding Angular's own - preregistered services, such as its routing support. - - The preferred approach is to register application providers in application components. - Because the `HeroService` is used within the *Heroes* feature area — - and nowhere else — the ideal place to register it is in the top-level `HeroesComponent`. - -block ngmodule-vs-component - :marked - Look at the `providers` part of the `@Component` annotation. - An instance of the `HeroService` is now available for injection in this `HeroesComponent` - and all of its child components. - - The `HeroesComponent` itself doesn't happen to need the `HeroService`. - But its child `HeroListComponent` does, so we head there next. - -block injectable-not-always-needed-in-ts - //- The [Angular Dart Transformer](https://github.com/dart-lang/angular2/wiki/Transformer) - //- generates static code to replace the use of dart:mirrors. It requires that types be - //- identified as targets for static code generation. Generally this is achieved - //- by marking the class as @Injectable (though there are other mechanisms). - -block always-include-paren - :marked - Always write `@Injectable()`, not just `@Injectable`. - A metadata annotation must be either a reference to a - compile-time constant variable or a call to a constant - constructor such as `Injectable()`. - - If we forget the parentheses, the analyzer will complain: - "Annotation creation must have arguments". If we try to run the - app anyway, it won't work, and the console will say - "expression must be a compile-time constant". - -block real-logger - .l-sub-section - :marked - A real implementation would probably use the - [logging package](https://pub.dartlang.org/packages/logging). - -block provider-shorthand - :marked - This is actually a shorthand expression for a provider registration - that creates a new instance of the - [Provider](../api/angular2.core/Provider-class.html) class: - -block provider-ctor-args - - var _secondParam = 'named parameter, such as useClass' - :marked - We supply two arguments (or more) to the `Provider` constructor. - -block dart-diff-const-metadata - .callout.is-helpful - header Dart difference: Constants in metadata - :marked - In Dart, the value of a metadata annotation must be a compile-time constant. - For that reason, we can't call functions to get values - to use within an annotation. - Instead, we use constant literals or constant constructors. - For example, a TypeScript program will use the - object literal `{ provide: Logger, useClass: BetterLogger }`. - A Dart annotation would instead use the constant value - `const Provider(Logger, useClass: BetterLogger)`. - -block dart-diff-const-metadata-ctor - .callout.is-helpful - header Dart difference: Constants in metadata - :marked - Because Dart annotations must be compile-time constants, - `useValue` is often used with string or list literals. - However, `useValue` works with any constant object. - - To create a class that can provide constant objects, - ensure all its instance variables are `final`, - and give it a `const` constructor. - - Create a constant instance of the class by using `const` instead of `new`. - -// - var stylePattern = { otl: /(useValue.*\))/gm }; -// +makeExample('dependency-injection/dart/lib/providers_component.dart','providers-9','', stylePattern)(format='.') - -block non-class-dep-eg - span string, list, map, or maybe a function. - -block config-obj-maps - | . They can be - | Map - | literals - -block what-should-we-use-as-token - :marked - But what should we use as the token? - While we _could_ use **[Map][]**, we _should not_ because (like - `String`) `Map` is too general. Our app might depend on several maps, each - for a different purpose. - - [Map]: https://api.dartlang.org/stable/dart-core/Map-class.html - - .callout.is-helpful - header Dart difference: Interfaces are valid tokens - :marked - In TypeScript, interfaces don't work as provider tokens. - Dart doesn't have this limitation; - every class implicitly defines an interface, - so interface names are just class names. - `Map` is a *valid* token even though it's the name of an abstract class; - it's just *unsuitable* as a token because it's too general. - -block dart-map-alternative - :marked - As an alternative to using a configuration `Map`, we can define - a custom configuration class: - - +makeExcerpt('lib/app_config.dart (alternative config)','config-alt') - - :marked - Defining a configuration class has a few benefits. One key benefit - is strong static checking: we'll be warned early if we misspell a property - name or assign it a value of the wrong type. - The Dart [cascade notation][cascade] (`..`) provides a convenient means of initializing - a configuration object. - - If we use cascades, the configuration object can't be declared `const` and - we can't use a [value provider](#value-provider). - A solution is to use a [factory provider](#factory-provider). - We illustrate this next. We also show how to provide and inject the - configuration object in our top-level `AppComponent`: - - [cascade]: https://www.dartlang.org/docs/dart-up-and-running/ch02.html#cascade - - +makeExcerpt('lib/app_component.dart','providers') - +makeExcerpt('lib/app_component.dart','ctor') diff --git a/public/docs/dart/latest/guide/displaying-data.jade b/public/docs/dart/latest/guide/displaying-data.jade deleted file mode 100644 index fec5bd5b8b..0000000000 --- a/public/docs/dart/latest/guide/displaying-data.jade +++ /dev/null @@ -1,21 +0,0 @@ -extends /docs/ts/_cache/guide/displaying-data.jade - -block includes - - var _example = 'displaying-data'; - include ../_util-fns - - var _iterableUrl = 'https://api.dartlang.org/stable/dart-core/Iterable-class.html'; - - var _boolean = 'boolean'; - -block hero-class - :marked - We've defined a class with a constructor, two properties (`id` and `name`), - and a `toString()` method. - -block final-code - +makeTabs(`displaying-data/dart/lib/app_component.dart, - displaying-data/dart/lib/hero.dart, - displaying-data/dart/pubspec.yaml, - displaying-data/dart/web/index.html, - displaying-data/dart/web/main.dart`, - ',,,,final', - 'lib/app_component.dart, lib/hero.dart, pubspec.yaml, web/index.html, web/main.dart') diff --git a/public/docs/dart/latest/guide/forms.jade b/public/docs/dart/latest/guide/forms.jade deleted file mode 100644 index 6e2591fc08..0000000000 --- a/public/docs/dart/latest/guide/forms.jade +++ /dev/null @@ -1,656 +0,0 @@ -include ../_util-fns - -:marked - We’ve all used a form to log in, submit a help request, place an order, book a flight, - schedule a meeting, and perform countless other data entry tasks. - Forms are the mainstay of business applications. - - Any seasoned web developer can slap together an HTML form with all the right tags. - It's more challenging to create a cohesive data entry experience that guides the - user efficiently and effectively through the workflow behind the form. - - *That* takes design skills that are, to be frank, well out of scope for this chapter. - - It also takes framework support for - **two-way data binding, change tracking, validation, and error handling** - ... which we shall cover in this chapter on Angular forms. - - We will build a simple form from scratch, one step at a time. Along the way we'll learn: - - - How to build an Angular form with a component and template - - - The `ngModel` two-way data binding syntax for reading and writing values to input controls - - - The `ngControl` directive to track the change state and validity of form controls - - - The special CSS classes that `ngControl` adds to form controls and how to use them to provide strong visual feedback - - - How to display validation errors to users and enable/disable form controls - - - How to share information across controls with template reference variables - - Run the . - -.l-main-section -:marked - ## Template-driven forms - - Many of us will build forms by writing templates in the Angular - template syntax - - with the form-specific directives and techniques described in this chapter. - -.l-sub-section - :marked - That's not the only way to create a form but it's the way we'll cover in this chapter. -:marked - We can build almost any form we need with an Angular template—login forms, contact forms, pretty much any business form. - We can lay out the controls creatively, bind them to data, specify validation rules and display validation errors, - conditionally enable or disable specific controls, trigger built-in visual feedback, and much more. - - It will be pretty easy because Angular handles many of the repetitive, boilerplate tasks we'd - otherwise wrestle with ourselves. - - We'll discuss and learn to build a template-driven form that looks like this: - -figure.image-display - img(src="/resources/images/devguide/forms/hero-form-1.png" width="400px" alt="Clean Form") - -:marked - Here at the *Hero Employment Agency* we use this form to maintain personal information about the - heroes in our stable. Every hero needs a job. It's our company mission to match the right hero with the right crisis! - - Two of the three fields on this form are required. Required fields have a green bar on the left to make them easy to spot. - - If we delete the hero name, the form displays a validation error in an attention-grabbing style: - -figure.image-display - img(src="/resources/images/devguide/forms/hero-form-2.png" width="400px" alt="Invalid, Name Required") - -:marked - Note that the submit button is disabled, and the "required" bar to the left of the input control changed from green to red. - -.l-sub-section - :marked - We'll customize the colors and location of the "required" bar with standard CSS. - -:marked - We'll build this form in small steps: - - 1. Create the `Hero` model class. - 1. Create the component that controls the form. - 1. Create a template with the initial form layout. - 1. Add the **ngModel** directive to each form input control. - 1. Add the **ngControl** directive to each form input control. - 1. Add custom CSS to provide visual feedback. - 1. Show and hide validation error messages. - 1. Handle form submission with **ngSubmit**. - 1. Change the form's display after submission. - -:marked - ## Setup - Create a new project folder (`angular_forms`) and create 3 files: - `pubspec.yaml`, `web/index.html`, and `web/main.dart`. - (These files should be familiar from the - [QuickStart](../quickstart.html).) Put these contents in the files: - -+makeTabs('forms/dart/pubspec.yaml, forms/dart/web/index.html, forms/dart/web/main.dart', ',initial,', 'pubspec.yaml, web/index.html, web/main.dart') - -:marked - So that the code can run, - let's create a stub for the `` component. - - Create a new directory called `lib`. - In it, put a file called `hero_form_component.dart` - with the following code: - -+makeExample('forms/dart/lib/hero_form_component_initial.dart', null, 'lib/hero_form_component.dart') - -:marked - The app should now run, but it won't do anything interesting. - Let's add some data. - - - ## Create the Hero model class - - As users enter form data, we'll capture their changes and update an instance of a model. - We can't lay out the form until we know what the model looks like. - - A model can be as simple as a "property bag" that holds facts about a thing of application importance. - That describes well our `Hero` class with its three required fields (`id`, `name`, `power`) - and one optional field (`alterEgo`). - - In the `lib` directory, add a file called `hero.dart` - with the following code: - -+makeExample('forms/dart/lib/hero.dart', 'all', 'lib/hero.dart') - -:marked - It's an anemic model with few requirements and no behavior. Perfect for our demo. - - The `alterEgo` is optional, so the constructor lets us omit it: note the - `[]` in `[this.alterEgo]`. - - We can create a new hero like this: - -+makeExample('forms/dart/lib/hero.dart', 'newhero')(format=".") - -:marked - -.l-main-section -:marked - ## Create a form component - - An Angular form has two parts: an HTML-based template and a code-based component to handle data and user interactions. - - We begin with the component because it states, in brief, what the Hero editor can do. - - Edit `hero_form_component.dart`, replacing all of its contents - with the following code: - -+makeExample('forms/dart/lib/hero_form_component.dart', null, 'lib/hero_form_component.dart') - -:marked - There’s nothing special about this component, nothing form-specific, - nothing to distinguish it from any component we've written before. - - Understanding this component requires only the Angular concepts covered in previous chapters. - - 1. The code imports a standard set of symbols from the Angular library. - - 1. The `@Component` selector value of "hero-form" means we can drop this form in a parent template with a `` tag. - - 1. The `moduleId` property sets the base for module-relative URLs such as the `templateUrl`. - - 1. The `templateUrl` property points to a separate file for template HTML called `hero_form_component.html`. - - 1. We defined dummy data for `model` and `powers`, as befits a demo. - Down the road, we can inject a data service to get and save real data - or perhaps expose these properties as inputs and outputs - for binding to a - parent component. None of this concerns us now, and these future changes won't affect our form. - - 1. We threw in a `diagnostic` property to return a - string describing our model. - It'll help us see what we're doing during our development; we've left ourselves a cleanup note to discard it later. - - Why isn't the template inline in the component file? - - Inline templates can be nice when they are short, - but most form templates aren't short. Dart files generally aren't the best place to - write (or read) large stretches of HTML, and few editors are much help with files that have a mix of HTML and code. - It's also nice to have short files with a clear and obvious purpose. - - We made a good choice to put the HTML template elsewhere. Let's write it. - - - - - -.l-main-section -:marked - ## Create an initial HTML form template - - Create a new file under `lib` called `hero_form_component.html`, - and put the following template code in it: - -+makeExample('forms/dart/lib/hero_form_component_initial.html', null, 'lib/hero_form_component.html') - -:marked - That is plain old HTML 5. We're presenting two of the `Hero` fields, `name` and `alterEgo`, and - opening them up for user input in input boxes. - - The Name `` control has the HTML5 `required` attribute; - the Alter Ego `` control does not because `alterEgo` is optional. - - We've got a Submit button at the bottom with some classes on it. - - **We are not using Angular yet**. There are no bindings. No extra directives. Just layout. - - - The `container`,`form-group`, `form-control`, and `btn` classes are [Bootstrap](http://getbootstrap.com/) CSS. Purely cosmetic. - We're using Bootstrap to gussy up our form. - Hey, what's a form without a little style! - -.callout.is-important - header Angular forms do not require a style library - :marked - Angular makes no use of the `container`, `form-group`, `form-control`, and `btn` classes or - the styles of any external library. Angular apps can use any CSS library - ... or none at all. - -:marked - Let's add the stylesheet. - - 1. Download the Bootstrap stylesheet from - https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css, - and put it in the `web` directory. - - 2. Edit `web/index.html`, adding a link to `bootstrap.min.css`: - -- var stylePattern = { otl: /(<link rel.*$)/gm }; -+makeExample('forms/dart/web/index.html', 'bootstrap-and-script', 'web/index.html (excerpt)', stylePattern)(format=".") - - [PENDING: runnable now? Remind about pub get? remind them to look in the browser console] - - -.l-main-section -:marked - ## Add powers with ***ngFor** - Our hero must choose one super power from a fixed list of Agency-approved powers. - We maintain that list internally (in `HeroFormComponent`). - - We'll add a `select` to our - form and bind the options to the `powers` list using `ngFor`, - a technique used before in [Displaying Data](./displaying-data.html). - - Add the following HTML *immediately below* the Alter Ego group. -+makeExample('forms/dart/lib/hero_form_component_ngmodel_ngfor.html', 'powers', 'lib/hero_form_component.html (excerpt)')(format=".") - -:marked - This code repeats the `