Getting Started

The easiest way to get started with Jelly is to try out the tutorials. Before you try out any of the tutorials, you may need to install Maven-1.1 first. For more details on how to install Maven please refer to the Maven documentation

Here's a brief overview of what you need to do.

  • Download a binary distribution of Maven.
  • Set the environment variable MAVEN_HOME to point to where you installed Maven
  • Change your PATH environment variable so that it points to MAVEN_HOME/bin
  • Get a source distribution of Jelly. The easiest way to do this is (until we have nightly builds working) is to grab a CVS checkout. Jelly currently resides in the jelly directory inside jakarta-commons. There are instructions on performing CVS checkouts here

To verify that your Maven installation is working, change directory into your jelly directory which should contain a project.xml file required by Maven. Then type

maven jar

This should download all the required jars required to build and run the core jelly, compile all the code and build and run the unit test cases.


Your next task is to choose the tag-libraries you are interested to and to build them. For all of them, you can build using maven jar.

Beware that some tag-libraries have dependencies that cannot be distributed by the maven repository distribution for license reasons. The tag-libraries email, , and are known to require such. Please browse to their dependency-list in order to download the named jars, rename-them, and put them at the appropriate place in the maven repository. (you could also delete these directories)

Once all dependencies are honoured, you can also build it all using maven dist, however, maven may become out of resources; changing the environment variable MAVEN_OPTS (e.g. to -Xmx768m...) might help.

Once you've got this far, it might be time to try out one of the tutorials