|
@@ -34,17 +34,34 @@ Some highlights:
|
|
|
- You can inline Javascript code and there are many ways to interact between Amber and Javascript
|
|
|
|
|
|
|
|
|
-Getting Amber
|
|
|
+Prerequisites
|
|
|
-------------
|
|
|
|
|
|
Amber is shipped as a cli tool to create new projects and assist with development tasks in a [npm](http://npmjs.org) package `amber-cli`
|
|
|
and as a library to be used by projects in a [bower](https://github.com/bower/bower) package `amber`.
|
|
|
|
|
|
-Do this [1] to create an Amber project of your own and start working in it:
|
|
|
+For the installation to work, you need to have installed `node`, `npm` and `git` (in Windows, use Git for Windows and select "Run Git from Windows Command Prompt" and "Checkout Windows-style, commit Unix-style" installation options).
|
|
|
+
|
|
|
+For UNIX-based OS (Linux distibutions, FreeBSD, ...) do
|
|
|
+
|
|
|
+ npm config set prefix=~/npm
|
|
|
+ export PATH="$PATH:$HOME/npm/bin"
|
|
|
+
|
|
|
+to have the installation in a local subdirectory in order to avoid the otherwise necessary ``sudo`` installation of Amber. The export line needs to be added to the ~/.profile file as well so that after a new login the path is set.
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+Getting Amber and setting up an initial project
|
|
|
+-----------------------------------------------
|
|
|
+
|
|
|
+Do this to install Amber
|
|
|
|
|
|
# Install the CLI tool `amber-cli` and supporting tools
|
|
|
npm install -g amber-cli bower grunt-cli
|
|
|
|
|
|
+
|
|
|
+Use ``amber init`` to create a project of your own
|
|
|
+
|
|
|
# Initialize your project (directory must be empty)
|
|
|
cd /path/to/myproject
|
|
|
amber init
|
|
@@ -53,12 +70,12 @@ Do this [1] to create an Amber project of your own and start working in it:
|
|
|
bower install amber-compat-es5 --save # be loadable in older browsers
|
|
|
bower install amber-compat-ie8 --save # additional tweaks to load in IE8
|
|
|
|
|
|
+
|
|
|
+Start developing in Amber Smalltalk
|
|
|
+
|
|
|
# Serve amber on localhost:4000
|
|
|
amber serve
|
|
|
|
|
|
-The [Getting started](https://github.com/amber-smalltalk/amber/wiki/Getting-started) page shows more details on ways to obtain Amber and start a project.
|
|
|
-
|
|
|
-[1] For installation to work, you need to install `node`, `npm` and `git` (in Windows, use Git for Windows and select "Run Git from Windows Command Prompt" and "Checkout Windows-style, commit Unix-style" installation options).
|
|
|
|
|
|
|
|
|
Reporting issues
|