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,15 +39,15 @@ 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
```
@@ -58,9 +58,9 @@ Behind the scenes this will also call `npm run copy-libs`, which copies the Angu
58
58
frontend dependencies. After that, you should find out that you have two new directories in your project.
59
59
60
60
* ` node_modules ` - contains the npm packages for the tools we need
61
- * ` app/lib ` - contains the Angular framework files and other frontend dependencies
61
+ * ` app/lib ` - contains the AngularJS framework files and other frontend dependencies
62
62
63
- * Note copying the Angular files from ` node_modules ` to ` app/lib ` makes it easier to serve the files
63
+ * Note copying the AngularJS files from ` node_modules ` to ` app/lib ` makes it easier to serve the files
64
64
by a web server.*
65
65
66
66
### Run the Application
@@ -145,7 +145,7 @@ npm run test-single-run
145
145
146
146
The ` angular-seed ` app comes with end-to-end tests, again written in [ Jasmine] [ jasmine ] . These tests
147
147
are run with the [ Protractor] [ protractor ] End-to-End test runner. It uses native events and has
148
- special features for Angular applications.
148
+ special features for AngularJS applications.
149
149
150
150
* The configuration is found at ` e2e-tests/protractor-conf.js ` .
151
151
* The end-to-end tests are found in ` e2e-tests/scenarios.js ` .
@@ -187,9 +187,9 @@ the [Java Development Kit (JDK)][jdk] to be installed on your local machine. Che
187
187
If JDK is not already installed, you can download it [ here] [ jdk-download ] .
188
188
189
189
190
- ## Updating Angular
190
+ ## Updating AngularJS
191
191
192
- Since the Angular framework library code and tools are acquired through package managers (npm and
192
+ Since the AngularJS framework library code and tools are acquired through package managers (npm and
193
193
bower) you can use these tools to easily update the dependencies. Simply run the preconfigured
194
194
script:
195
195
@@ -201,24 +201,24 @@ This will call `npm update` and `npm run copy-libs`, which in turn will find and
201
201
versions that match the version ranges specified in the ` package.json ` file.
202
202
203
203
204
- ## Loading Angular Asynchronously
204
+ ## Loading AngularJS Asynchronously
205
205
206
206
The ` angular-seed ` project supports loading the framework and application scripts asynchronously.
207
207
The special ` index-async.html ` is designed to support this style of loading. For it to work you must
208
- inject a piece of Angular JavaScript into the HTML page. The project has a predefined script to help
208
+ inject a piece of AngularJS JavaScript into the HTML page. The project has a predefined script to help
209
209
do this:
210
210
211
211
```
212
212
npm run update-index-async
213
213
```
214
214
215
215
This will copy the contents of the ` angular-loader.js ` library file into the ` index-async.html `
216
- page. You can run this every time you update the version of Angular that you are using.
216
+ page. You can run this every time you update the version of AngularJS that you are using.
217
217
218
218
219
219
## Serving the Application Files
220
220
221
- While Angular is client-side-only technology and it is possible to create Angular web apps that
221
+ While AngularJS is client-side-only technology and it is possible to create AngularJS web apps that
222
222
do not require a backend server at all, we recommend serving the project files using a local
223
223
web server during development to avoid issues with security restrictions (sandbox) in browsers. The
224
224
sandbox implementation varies between browsers, but quite often prevents things like cookies, XHR,
@@ -249,10 +249,10 @@ This really depends on how complex your app is and the overall infrastructure of
249
249
the general rule is that all you need in production are the files under the ` app/ ` directory.
250
250
Everything else should be omitted.
251
251
252
- Angular apps are really just a bunch of static HTML, CSS and JavaScript files that need to be hosted
252
+ AngularJS apps are really just a bunch of static HTML, CSS and JavaScript files that need to be hosted
253
253
somewhere they can be accessed by browsers.
254
254
255
- If your Angular app is talking to the backend server via XHR or other means, you need to figure out
255
+ If your AngularJS app is talking to the backend server via XHR or other means, you need to figure out
256
256
what is the best way to host the static files to comply with the same origin policy if applicable.
257
257
Usually this is done by hosting the files by the backend server or through reverse-proxying the
258
258
backend server(s) and web server(s).
0 commit comments