Prerequisites

For all the next instructions, we assume that you downloaded and installed Maven.

To download packages from the source repository, you need to download and install Subversion.

If you want to build something including JavaDocs (assemblies, sites and JavaDoc report itself) you need to install GraphViz, otherwise you will notice missing pictures inside JavaDocs pages.

WARNING: Due to some bugs in recent versions of GraphViz, we reccomend to use GraphViz version 2.8, otherwise you will notice that client HTML maps do not work properly.

Building main packages

To build Tiles 2 from source you need to:

• download the source distribution, or checkout the latest version:

  svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/

• go into the source directory and type:

  mvn package

You will find the generated JARs under:

• {tiles-dir}/tiles-api/target/tiles-api-${version}.jar
• {tiles-dir}/tiles-core/target/tiles-core-${version}.jar
• {tiles-dir}/tiles-jsp/target/tiles-jsp-${version}.jar

Building Tiles Test webapp

See Selenium testing with Tiles Test webapp.

Building Tiles Showcase

To build Tiles Showcase from source you need to:

• download the source distribution, or checkout the latest version:

  svn co http://svn.apache.org/repos/asf/tiles/examples/trunk/tiles-showcase/

• go into the source directory and type:

  mvn package

You will find the generated JARs under {tiles-showcase-dir}/target/tiles-showcase-${version}.jar.

You can also see the showcase in action by using the Cargo plugin:

mvn package cargo:start

or

mvn package cargo:start -Dcargo.tomcat5x.home=/path/to/tomcat5

Building distributions

To build distributions, you need to:

• download the source distribution, or checkout the latest version:

  svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/

• go into the source directory and type:

  mvn install site

• go into the {tiles-dir}/assembly directory and type:

  mvn assembly:assembly

You will find the generated distribution under {tiles-dir}/assembly/target/assembly/out.

Building main website

To build the main website:

• checkout the site from the source repository:

  svn co http://svn.apache.org/repos/asf/tiles/site/

• go into the site directory and type:

  mvn site

You will find the generated distribution under {tiles-site-dir}/target/site.

Building framework website

To build the framework website:

• download the source distribution, or checkout the latest version:

  svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/

• go into the source directory and type:

  mvn site

You will find the generated websites under:

• {tiles-dir}/target/site
• {tiles-dir}/tiles-api/target/site
• {tiles-dir}/tiles-core/target/site
• {tiles-dir}/tiles-jsp/target/site