|
@@ -1,11 +1,10 @@
|
|
|
amber-examples
|
|
|
==============
|
|
|
|
|
|
-Various amber examples
|
|
|
+This project contains various Amber Smalltalk examples. Amber may run in a web browser or as a command line program.
|
|
|
|
|
|
|
|
|
-
|
|
|
-Prerequisites
|
|
|
+Tools needed
|
|
|
=============
|
|
|
|
|
|
1. A web browser with reasonably good support for HTML5 canvas.
|
|
@@ -13,19 +12,22 @@ Prerequisites
|
|
|
3. [nodejs](http://www.nodejs.org/). This will give you the node package manager `npm` as well.
|
|
|
4. A global install of the [`amber`](http://amber-lang.net/) [npm](http://npmjs.org/) package
|
|
|
5. A global install of the [`bower`](http://bower.io/) client side package manager in order to install the dependencies
|
|
|
+6. A global install of the [`gruntjs`](http://gruntjs.com/) task runner which is used as the command line build system
|
|
|
|
|
|
The `amber` and `bower` packages can be installed with the following command (In some cases you have to call `npm` with `sudo npm`):
|
|
|
|
|
|
- npm install --global amber-cli bower
|
|
|
+ npm install --global amber-cli bower grunt-cli
|
|
|
|
|
|
or the same thing, but less typing:
|
|
|
|
|
|
- npm i -g amber-cli bower
|
|
|
+ npm i -g amber-cli bower grunt-cli
|
|
|
+
|
|
|
|
|
|
Reference: http://docs.amber-lang.net/js-glossary.html
|
|
|
|
|
|
-Getting started
|
|
|
-===============
|
|
|
+
|
|
|
+Setting up amber-examples
|
|
|
+==========================
|
|
|
|
|
|
Clone the repository
|
|
|
|
|
@@ -38,7 +40,13 @@ Get dependencies of this project:
|
|
|
npm install
|
|
|
bower install
|
|
|
|
|
|
-Afterwards execute the server:
|
|
|
+
|
|
|
+Amber in the browser
|
|
|
+==========================
|
|
|
+
|
|
|
+Amber runs in the browser and this includes an IDE.
|
|
|
+
|
|
|
+To have access to this start a small web server:
|
|
|
|
|
|
`amber serve`
|
|
|
|
|
@@ -46,24 +54,26 @@ and point your browser to
|
|
|
|
|
|
`http://localhost:4000/`
|
|
|
|
|
|
-Rebuilding examples using Grunt.js (development mode)
|
|
|
-====================================================
|
|
|
|
|
|
-Since Amber 0.10.0 Grunt.js is used as commandline build system.
|
|
|
-To use it with the examples it is first necessary to install all dependencies with
|
|
|
+Amber on the command line
|
|
|
+====================================================
|
|
|
|
|
|
-* install grunt-cli globally if not already present: `npm install -g grunt-cli`
|
|
|
-* `cd amber-examples`
|
|
|
-* `npm install`
|
|
|
|
|
|
-Afterwards the examples can be built/recompiled by running the following command in
|
|
|
-the subdirectory of each example:
|
|
|
+Build or recompile a command line example (e.g. nodejs) by executing
|
|
|
|
|
|
`grunt`
|
|
|
|
|
|
+in the subdirectory.
|
|
|
+
|
|
|
The subdirectories might contain additional README files which might contain additional information.
|
|
|
|
|
|
|
|
|
+Notes
|
|
|
+=====
|
|
|
+
|
|
|
+- Since Amber 0.10.0 Grunt.js is used as commandline build system.
|
|
|
+
|
|
|
+
|
|
|
Status
|
|
|
======
|
|
|
|