How to Build the Axis2 Project's Website

Installing Maven2

The Axis 2.0 website build system solely depends on Maven2. The build has been specifically tested to work with Maven version 2.0.7. To install Maven, download the distributions and follow the instructions in the documentation. Make sure you don't forget to add MAVEN_HOME/bin directory in the path.

Checking out Axis 2.0

Checkout the latest source using your favorite SVN client. If you are a committer, get a commiter check out.

Building the Site

During maven releases site should have been generated on target/site directory and no special action required. Further release process guide describes necessary steps to update Axis2 site with your new modifications.

In case if you want to generate site only you could run mvn site on root project of your local copy.

FAQ

  1. How can I update a document in the site ?
    Get a commiter check out. All the documents are in XHTML format under the modules/documentation/xdocs folder, and you can change only the documents found under this folder. Change the relevant file and run mvn install. New documentation will be available under the target folder.
  2. How can I add a new document?
    Add the new document in the xdocs folder. Change the navigation.xml found under the xdocs folder by adding a link to the newly added document. Re-generate the site.
    Please make sure you have not included any of the illegal characters and your document should be well formed.