Building Alice

You will need the following projects installed to build this project:

  1. Java development kit www.javasoft.com
  2. Apache projectANT. This allows you to build the code.
  3. Tomcat servelet container from jakarta . This only for building the JSP source code and used only to precompile. It is not required if you don't want to precompile.

Next, download the source code from sourceforge. This project's SourceForge.net CVS repository can be checked out through anonymous (pserver) CVS with the following instruction set. The module you wish to check out must be specified as the modulename, which is 'jhome'. When prompted for a password for anonymous, simply press the Enter key.


cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/jhome login
 
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/jhome co modulename

Read additional information here.

Compile this project simply by going to the top level directory of the source, where the build.xml file is located. If you want to set up pre-compiling of JSP pages in Tomcat for the Alice web application then edit build.properties file and set the tomcat.home value to the location of the tomcat installation. If ANT has been installed properly then simply type the command:

ant

The default task being run is 'all'. This will build the entire project and create distributions. Once the build is complete, a 'dist' directory will have been created. It is here that the executable alice.jar file will be along with the aliceweb.war file or deployment into Tomcat application server.

Project building

Recently the Maven project has been incorporated to allow quick publishing of the documents you see on this site. The 'jhome' top level directory has a file called 'project.xml'. This file is used by Maven for site generation. Maven is " a Java project management and project comprehension tool.". Read more about Maven.

To build the documentation for this project, first download Maven and install it according to its documentation. After the installation and setup type the following command from the directory where "project.xml" is located.

maven site:generate

All documentation will be created and placed in 'dist/target' directory.