3
3
This project is an application skeleton for a typical [ AngularJS] [ angularjs ] web app. You can use it
4
4
to quickly bootstrap your angular webapp projects and dev environment for these projects.
5
5
6
- The seed contains a sample AngularJS application and is preconfigured to install the Angular
6
+ The seed contains a sample AngularJS application and is preconfigured to install the AngularJS
7
7
framework and a bunch of development and testing tools for instant web development gratification.
8
8
9
9
The seed app doesn't do much, just shows how to wire two controllers and views together.
@@ -39,29 +39,29 @@ The `depth=1` tells git to only pull down one commit worth of historical data.
39
39
40
40
### Install Dependencies
41
41
42
- We have two kinds of dependencies in this project: tools and Angular framework code. The tools help
42
+ We have two kinds of dependencies in this project: tools and AngularJS framework code. The tools help
43
43
us manage and test the application.
44
44
45
- * We get the tools we depend upon and the Angular code via ` npm ` , the [ Node package manager] [ npm ] .
45
+ * We get the tools we depend upon and the AngularJS code via ` npm ` , the [ Node package manager] [ npm ] .
46
46
* In order to run the end-to-end tests, you will also need to have the
47
47
[ Java Development Kit (JDK)] [ jdk ] installed on your machine. Check out the section on
48
48
[ end-to-end testing] ( #e2e-testing ) for more info.
49
49
50
- We have preconfigured ` npm ` to automatically copy the downloaded Angular files to ` app/lib ` so we
50
+ We have preconfigured ` npm ` to automatically copy the downloaded AngularJS files to ` app/lib ` so we
51
51
can simply do:
52
52
53
53
```
54
54
npm install
55
55
```
56
56
57
57
Behind the scenes this will also call ` npm run copy-libs ` , which runs a simple JS script that copies
58
- the Angular files and other fronted dependencies. After that, you should find out that you have two
58
+ the AngularJS files and other fronted dependencies. After that, you should find out that you have two
59
59
new directories in your project.
60
60
61
61
* ` node_modules ` - contains the npm packages for the tools we need
62
- * ` app/lib ` - contains the Angular framework files and other frontend dependencies
62
+ * ` app/lib ` - contains the AngularJS framework files and other frontend dependencies
63
63
64
- * Note copying the Angular files from ` node_modules ` to ` app/lib ` makes it easier to serve the files
64
+ * Note copying the AngularJS files from ` node_modules ` to ` app/lib ` makes it easier to serve the files
65
65
by a web server.*
66
66
67
67
### Run the Application
@@ -146,7 +146,7 @@ npm run test-single-run
146
146
147
147
The ` angular-seed ` app comes with end-to-end tests, again written in [ Jasmine] [ jasmine ] . These tests
148
148
are run with the [ Protractor] [ protractor ] End-to-End test runner. It uses native events and has
149
- special features for Angular applications.
149
+ special features for AngularJS applications.
150
150
151
151
* The configuration is found at ` e2e-tests/protractor-conf.js ` .
152
152
* The end-to-end tests are found in ` e2e-tests/scenarios.js ` .
@@ -188,9 +188,9 @@ the [Java Development Kit (JDK)][jdk] to be installed on your local machine. Che
188
188
If JDK is not already installed, you can download it [ here] [ jdk-download ] .
189
189
190
190
191
- ## Updating Angular
191
+ ## Updating AngularJS
192
192
193
- Since the Angular framework library code and tools are acquired through package managers (npm and
193
+ Since the AngularJS framework library code and tools are acquired through package managers (npm and
194
194
bower) you can use these tools to easily update the dependencies. Simply run the preconfigured
195
195
script:
196
196
@@ -202,24 +202,24 @@ This will call `npm update` and `npm run copy-libs`, which in turn will find and
202
202
versions that match the version ranges specified in the ` package.json ` file.
203
203
204
204
205
- ## Loading Angular Asynchronously
205
+ ## Loading AngularJS Asynchronously
206
206
207
207
The ` angular-seed ` project supports loading the framework and application scripts asynchronously.
208
208
The special ` index-async.html ` is designed to support this style of loading. For it to work you must
209
- inject a piece of Angular JavaScript into the HTML page. The project has a predefined script to help
209
+ inject a piece of AngularJS JavaScript into the HTML page. The project has a predefined script to help
210
210
do this:
211
211
212
212
```
213
213
npm run update-index-async
214
214
```
215
215
216
216
This will copy the contents of the ` angular-loader.js ` library file into the ` index-async.html `
217
- page. You can run this every time you update the version of Angular that you are using.
217
+ page. You can run this every time you update the version of AngularJS that you are using.
218
218
219
219
220
220
## Serving the Application Files
221
221
222
- While Angular is client-side-only technology and it is possible to create Angular web apps that
222
+ While AngularJS is client-side-only technology and it is possible to create AngularJS web apps that
223
223
do not require a backend server at all, we recommend serving the project files using a local
224
224
web server during development to avoid issues with security restrictions (sandbox) in browsers. The
225
225
sandbox implementation varies between browsers, but quite often prevents things like cookies, XHR,
@@ -250,10 +250,10 @@ This really depends on how complex your app is and the overall infrastructure of
250
250
the general rule is that all you need in production are the files under the ` app/ ` directory.
251
251
Everything else should be omitted.
252
252
253
- Angular apps are really just a bunch of static HTML, CSS and JavaScript files that need to be hosted
253
+ AngularJS apps are really just a bunch of static HTML, CSS and JavaScript files that need to be hosted
254
254
somewhere they can be accessed by browsers.
255
255
256
- If your Angular app is talking to the backend server via XHR or other means, you need to figure out
256
+ If your AngularJS app is talking to the backend server via XHR or other means, you need to figure out
257
257
what is the best way to host the static files to comply with the same origin policy if applicable.
258
258
Usually this is done by hosting the files by the backend server or through reverse-proxying the
259
259
backend server(s) and web server(s).
0 commit comments