Herbert Vojčík a5aab0ebcf cli: recompile | 9 years ago | |
---|---|---|
external | 9 years ago | |
internal | 9 years ago | |
src | 9 years ago | |
support | 9 years ago | |
.gitignore | 9 years ago | |
.npmignore | 9 years ago | |
.travis.yml | 9 years ago | |
API-CHANGES.txt | 9 years ago | |
CHANGELOG | 9 years ago | |
CONTRIBUTING.md | 9 years ago | |
Gruntfile.js | 9 years ago | |
LICENSE | 11 years ago | |
README.md | 9 years ago | |
bower.json | 9 years ago | |
config-node.js | 9 years ago | |
favicon.ico | 11 years ago | |
local.amd.json | 9 years ago | |
package.json | 9 years ago |
By Nicolas Petton petton.nicolas@gmail.com and Amber contributors
Amber is an implementation of the Smalltalk language that runs on top of the JavaScript runtime. It is designed to make client-side development faster and easier.
\o/ Call for contributors! \o/
The core project of Amber has enough resources, but:
- the Helios IDE (https://github.com/amber-smalltalk/helios), as well as
- examples (https://github.com/amber-smalltalk/amber-examples), and
- documentation (https://github.com/amber-smalltalk/amber-documentation)
would need some of your care.
Thank you very much!
(see CONTRIBUTING.md for further details)
Amber is written in itself, including the parser and compiler. Amber compiles into efficient JavaScript, mapping one-to-one with the equivalent JavaScript. There is no interpretation at runtime.
Some highlights:
Amber is shipped as a cli tool to create new projects and assist with development tasks in a npm package amber-cli
and as a library to be used by projects in a bower package amber
.
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.
Do this to install Amber
# Install the CLI tool `amber-cli` and supporting tools
npm install -g amber-cli
Use amber init
to create a project of your own
# Initialize your project (directory must be empty)
cd /path/to/myproject
amber init
# (optional) Install backward compatibility
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
amber
/ amberc
cli tools here: https://github.com/amber-smalltalk/amber/issues.
Issues related to questions during amber init
and structure of project created should be reported
to https://github.com/amber-smalltalk/grunt-init-amber/issues instead.Please refer to CONTRIBUTING.md for further details.
Please refer to CONTRIBUTING.md for further details. It explains the Amber development setup and how to contribute.
Amber is released under the MIT license. All contributions made for inclusion are considered to be under MIT.
More on the project page