How To Build Axis2 Project's Website

Installing Maven

The Axis 2.0 website build system solely depends Maven.Specifically the build has been tested to work with Maven version 1.0.1. To install Maven download the distributions and follow the instructions in their documentation. Make sure you don't forget to put MAVEN_HOME/bin directory in the path.

Checking out Axis 2.0

Checkout latest source from here using your favorite svn client. If you are a committer get a commiter check out from here.

Running the build

Target Description
maven clean Deletes the 'target' directory in all projects. Target directory contains the stuff created during build, site, etc.,
maven Build all modules and run the tests in Axis 2.0
maven multiproject:site Create the site for the Master project only
maven war Build the war
maven war-withsamples build the war with the default samples and interop tests
maven dist-src Creates the source distribution
maven dist-bin Creates the binary distribution

FAQ

  1. How can I update a document in the site ?
    Get a commiter check out. All the documents are in html format under the xdocs folder, and you can change only the documents found under this folder. Change the relevant file and run maven "html2xdoc:transform". New documentation will be available under target folder.
  2. How can I add a new document
    Put the new document in xdocs folder. Change the navigation.xml found under the xdocs folder to put a link to the newly added document. Re-generate the site.

 

-- Eran Chinthaka