Building from Source

Prerequisites

1. AtomicWiki requires a recent build of eXist, at least version 1.3. Since 1.3 has not been release yet, you have to check out the sources from SVN trunk.
2. Next, check out AtomicWiki, e.g. using command line tools:

svn checkout http://atomicwiki.googlecode.com/svn/trunk/AtomicWiki AtomicWiki

You should also make sure that the environment variable JAVA_HOME points to the root directory of your Java JDK (the JDK, not the JRE!).

Building

You need to compile eXist first. Switch to the directory into which you checked out eXist. The search functions in AtomicWiki require eXist's Lucene index, so you need to enable it. Edit extensions/indexes/build.properties and change the corresponding property to 'true':

# Lucene integration
include.index.lucene = true

Next, compile eXist by calling build.sh or build.bat once. This should create exist.jar and a few other jars.

Back in AtomicWiki, edit build.properties and change exist.home to point to your eXist installation directory. Leave all other properties unchanged. AtomicWiki will create its own, embedded eXist instance and should thus not interfere with other database installations.

Call build.sh or build.bat in the AtomicWiki directory once.

This will:

• copy necessary jars from the eXist installation into the local directories
• build a few extra Java classes needed by the wiki

Start the Server

Call startup.bat or startup.sh to launch the included web server.

If everything worked correct, you should be able to browse to

http://localhost:8000/

The first time you try to access this page, you will be presented with a setup page. Clicking on "Start Setup" will load the default AtomicWiki site into the db.

Generating a .war Archive

Calling ant with target "war" creates a file atomic.war in the root directory. This can be deployed into an external servlet engine like e.g. tomcat.