Merge pull request #25 from angular/dart-quickstart

Tweaks to Dart quickstart, Dart resources banner
This commit is contained in:
Kathy Walrath 2015-04-10 09:12:15 -07:00
commit 59391f962a
2 changed files with 30 additions and 25 deletions

View File

@ -14,7 +14,7 @@
"resources": { "resources": {
"icon": "play-circle-fill", "icon": "play-circle-fill",
"title": "Angular Resources", "title": "Angular Resources",
"banner": "Angular 2 is currently in Alpha Preview. For AngularDart 1.X please visit <a href='https://angulardart.org/'>angulardart.org</a>." "banner": "Angular 2 is currently in Alpha Preview. For AngularDart 1.X resources, visit <a href='https://angulardart.org/'>angulardart.org</a>."
}, },
"api": { "api": {

View File

@ -1,8 +1,14 @@
p.
<strong>Angular 2 is currently in Alpha Preview.</strong>
We recommend using
<a href='https://angulardart.org'>Angular for Dart</a>
for production applications.
p. p.
These instructions assume that you already have the Dart SDK These instructions assume that you already have the Dart SDK
and any tools you like to use with Dart. and any tools you like to use with Dart.
If not, go If not, go
<a href="https://www.dartlang.org/tools/download.html">download Dart</a>. <a href="https://www.dartlang.org/downloads/">download Dart</a>.
Then return here. Then return here.
// STEP 1 - Create a project ########################## // STEP 1 - Create a project ##########################
@ -37,19 +43,21 @@ p.
pre.prettyprint.lang-basic pre.prettyprint.lang-basic
code. code.
&gt; pub get &gt; pub get
Resolving dependencies... (7.3s) Resolving dependencies... (2.7s)
+ angular2 2.0.0-alpha.6 + analyzer 0.24.1 (0.25.0-dev.3 available)
+ browser 0.10.0+2 ... more messages ...
+ path 1.3.3 Changed 21 dependencies!
+ stack_trace 1.2.3 Precompiling dependencies...
Changed 4 dependencies! Loading source assets...
Precompiled dart_style.
// PENDING: Create template? Link to pub/pubspec docs? // PENDING: Create template? Link to pub/pubspec docs?
// Is browser really needed? // Is browser really needed?
.alert.is-helpful. .alert.is-helpful.
Depending on your version of Dart, your version numbers (of angular2 Depending on your version of Dart and the latest version of angular2,
and other packages) might be higher than shown above. That's fine. your messages are probably going to be different from what's shown above.
That's fine.
// STEP 2 - Import Angular ########################## // STEP 2 - Import Angular ##########################
@ -228,16 +236,20 @@ p.
You have several options for running your app. You have several options for running your app.
The quickest and easiest, for now, The quickest and easiest, for now,
is to open your project in <b>Dart Editor</b>, is to open your project in <b>Dart Editor</b>,
right-click <code>web/index.html</code>, right-click <b>web/index.html</b>,
and choose <b>Open in Dartium</b>. and choose <b>Open in Dartium</b>.
This starts a web server
and opens your app in an experimental browser that contains the Dart VM.
// TODO: screenshot? embedded app? // TODO: screenshot? embedded app?
p. p.
Another option is to build and serve the app using <code>pub serve</code>, Another option is to build and serve the app using <code>pub serve</code>,
and then run it by visiting http://localhost:8080/index.html in a browser. and then run it by visiting <b>http://localhost:8080</b> in a browser.
The JavaScript generated using this option is large, for now; Generating the JavaScript takes a few seconds when you first visit the page,
it'll be much better soon, when Angular's transformer becomes available. and the generated JavaScript is currently large.
The generated JavaScript will be smaller once
Angular's transformer becomes available.
// [PENDING: Update when transformer is working!] // [PENDING: Update when transformer is working!]
@ -246,14 +258,7 @@ p.
h2#section-transpile Great job! Next step... h2#section-transpile Great job! Next step...
p. p.
To try out the latest Angular 2 APIs, We plan to add a developer guide soon.
first download the <b>Dev channel</b> of Dart from the Until then, check out <a href="resources.html">Angular Resources</a>.
<a href="https://www.dartlang.org/tools/download-archive/">Dart To learn more about Dart, go to
Download Archive</a>. <a href="https://www.dartlang.org">dartlang.org</a>.
p.
Once you have the Dart Dev channel, use <b>pub upgrade</b>
to get the latest version of Angular 2.
// [PENDING: Perhaps point to dartlang.org.]