This is a very short tutorial on how to install and start using Helma NG.
Helma requires Java 1.5 to run and uses Apache Ant as its build tool.
git clone git://github.com/hns/helma-ng.git
Change to the helma-ng directory you just checked out and run ant it with the "jar" target:
If this worked then you should now have a file called lib/helma.jar.
Once you have built the jar files you should be able to start the Helma NG shell|shell. Just run the helma script in the bin directory without arguments:
This should start a shell session with a
import functions to load any Helma NG modules:
helma> include('helma/file'); helma> var file = new File('README.txt'); helma> file.open(); true helma> file.readln(); Helma NG helma> file.close(); true
To run an actual web application simply pass the main file of the app to the helma command:
This will start the Helma NG demo app on port 8080. Enter the following URL in your browser to access the app:
You can also run an application and the shell at the same time by adding the
--interactive option before the application name:
bin/helma -i apps/demo/main.js
--help options for more information on available options.
To start hacking on your own Helma application, use the admin/create script to create a new app:
bin/helma admin/create [app directory]
If you don't pass the app directory on the command line the script will prompt you for it. Once the application has been created you can start it by running its main.js script: