Sen descrición

Nicolas Petton fb7784acd6 Changed loadJtalk to loadAmber() in presentation/indeX.html %!s(int64=13) %!d(string=hai) anos
bin 9ea73571b6 Made amberc executable. %!s(int64=13) %!d(string=hai) anos
css d720c44bc4 new files %!s(int64=13) %!d(string=hai) anos
examples fb7784acd6 Changed loadJtalk to loadAmber() in presentation/indeX.html %!s(int64=13) %!d(string=hai) anos
ide d3cf306cca Ripped out ide.html from homepage, feel free to clean it or delete it Nicolas. %!s(int64=13) %!d(string=hai) anos
images 9a629b0411 New look and feel for the IDE based on firebug %!s(int64=13) %!d(string=hai) anos
js 81d684d320 Merge remote branch 'upstream/master' %!s(int64=13) %!d(string=hai) anos
scripts dc8e021881 first commit %!s(int64=13) %!d(string=hai) anos
server 1af622cf99 Starting renaming jtalk to amber %!s(int64=13) %!d(string=hai) anos
st 81d684d320 Merge remote branch 'upstream/master' %!s(int64=13) %!d(string=hai) anos
CHANGELOG 82a21206f7 changelog file %!s(int64=13) %!d(string=hai) anos
LICENSE 1af622cf99 Starting renaming jtalk to amber %!s(int64=13) %!d(string=hai) anos
README.md 4880fd28ca More renaming %!s(int64=13) %!d(string=hai) anos
index.html 1af622cf99 Starting renaming jtalk to amber %!s(int64=13) %!d(string=hai) anos

README.md

Amber

By Nicolas Petton petton.nicolas@gmail.com

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.

Overview

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 features an IDE with a Class browser, Workspace, Transcript, a ReferencesBrowser supporting senders/implementors and class references, basic Inspector and even a beginning of a Debugger and a unit TestRunner.
  • Pharo Smalltalk is considered as the reference implementation.
  • Amber includes a canvas to generate HTML, like Seaside
  • Amber can use Javascript libraries and the current IDE is built on jQuery
  • You can inline Javascript code and there are many ways to interact between Amber and Javascript

How to commit changes from the web-based IDE

The Amber class browser is able to commit changes to disk. The "commit category" button will send a PUT request with the JS code of all classes in the selected class category in a file named js/CATEGORY.js and also send the corresponding .st files to the st directory.

The easiest way to enable committing is probably to use the nodejs server or to setup a webdav with Apache.

To start the local server:

./bin/server

then go to http://localhost:4000

The following steps explain how to setup a webdav for Amber with Debian, but the setup on OSX and other Linux distros should be similar.

Install Apache and enable the dav module

apt-get install apache2
a2enmod dav
a2enmod dav_fs

Create a password for the webdav

htpasswd -c /etc/apache2/htpasswd-webdav USERNAME

Setup the webdav for Amber

Add the following lines to the default vhost (in /etc/apache2/sites-available/default):

Alias /amber/ "/path/to/amber/"
    <Directory "/path/to/amber/">
        Options Indexes MultiViews FollowSymLinks
    DirectoryIndex index.html
    AllowOverride None
        Order allow,deny
    allow from all

    Dav on

    AuthType Basic
        AuthName "amber"
        AuthUserFile /etc/apache2/htpasswd-webdav
    <LimitExcept GET OPTIONS>
            Require valid-user
    </LimitExcept>

    </Directory>

Make sure the group www-data has required rights to modify files in the webdav directory.

Restart Apache

/etc/init.d/apache2 restart

License

Amber is released under the MIT license. All contributions made for inclusion are considered to be under MIT.

More infos

More on the project page