| <?xml version="1.0"?> |
| <!-- |
| /* |
| * $Id$ |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| */ |
| --> |
| <document> |
| |
| <properties> |
| <title>Apache Tiles 2</title> |
| </properties> |
| |
| <body> |
| <section name="Building Tiles"> |
| <subsection name="Prerequisites"> |
| <p>For all the next instructions, we assume that you downloaded and |
| installed <a href="http://maven.apache.org/">Maven</a>.</p> |
| <p>To download packages from the source repository, you need to |
| download and install <a href="http://subversion.tigris.org/"> |
| Subversion</a>.</p> |
| <p>If you want to build something including JavaDocs (assemblies, |
| sites and JavaDoc report itself) you need to install |
| <a href="http://www.graphviz.org/">GraphViz</a>, otherwise you will |
| notice missing pictures inside JavaDocs pages.</p> |
| <p>WARNING: Due to some bugs in recent versions of GraphViz, we |
| reccomend to use |
| <a href="http://www.graphviz.org/pub/graphviz/ARCHIVE">GraphViz |
| version 2.8</a>, otherwise you will notice that client HTML maps do |
| not work properly.</p> |
| </subsection> |
| <subsection name="Building main packages"> |
| <p>To build Tiles 2 from source you need to:</p> |
| <ul> |
| <li><p><a href="../download.html">download</a> the source |
| distribution, or checkout the latest version:</p> |
| <p><source>svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/</source></p></li> |
| <li><p>go into the source directory and type:</p> |
| <p><source>mvn package</source></p></li> |
| </ul> |
| <p>You will find the generated JARs under:</p> |
| <ul> |
| <li>{tiles-dir}/tiles-api/target/tiles-api-${version}.jar</li> |
| <li>{tiles-dir}/tiles-core/target/tiles-core-${version}.jar</li> |
| <li>{tiles-dir}/tiles-jsp/target/tiles-jsp-${version}.jar</li> |
| </ul> |
| </subsection> |
| <subsection name="Building Tiles Test webapp"> |
| <p>See <a href="../selenium.html">Selenium testing with Tiles Test |
| webapp</a>.</p> |
| </subsection> |
| <subsection name="Building Tiles Showcase"> |
| <p>To build Tiles Showcase from source you need to:</p> |
| <ul> |
| <li><p><a href="../download.html">download</a> the source |
| distribution, or checkout the latest version:</p> |
| <p><source>svn co http://svn.apache.org/repos/asf/tiles/examples/trunk/tiles-showcase/</source></p></li> |
| <li><p>go into the source directory and type:</p> |
| <p><source>mvn package</source></p></li> |
| </ul> |
| <p>You will find the generated JARs under |
| <code>{tiles-showcase-dir}/target/tiles-showcase-${version}.jar</code>.</p> |
| <p>You can also see the showcase in action by using the Cargo plugin:</p> |
| <source>mvn package cargo:start</source> |
| <p>or</p> |
| <source>mvn package cargo:start -Dcargo.tomcat5x.home=/path/to/tomcat5</source> |
| </subsection> |
| <subsection name="Building distributions"> |
| <p>To build distributions, you need to:</p> |
| <ul> |
| <li><p><a href="../download.html">download</a> the source |
| distribution, or checkout the latest version:</p> |
| <p><source>svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/</source></p></li> |
| <li><p>go into the source directory and type:</p> |
| <p><source>mvn install site</source></p></li> |
| <li><p>go into the <code>{tiles-dir}/assembly</code> directory and |
| type:</p> |
| <p><source>mvn assembly:assembly</source></p></li> |
| </ul> |
| <p>You will find the generated distribution under |
| <code>{tiles-dir}/assembly/target/assembly/out</code>.</p> |
| </subsection> |
| </section> |
| <section name="Building Tiles websites"> |
| <p>There are two Tiles websites: the main website and the framework |
| website.</p> |
| <subsection name="Building main website"> |
| <p>To build the main website:</p> |
| <ul> |
| <li><p>checkout the site from the source repository:</p> |
| <p><source>svn co http://svn.apache.org/repos/asf/tiles/site/</source></p></li> |
| <li><p>go into the site directory and type:</p> |
| <p><source>mvn site</source></p></li> |
| </ul> |
| <p>You will find the generated distribution under |
| <code>{tiles-site-dir}/target/site</code>.</p> |
| </subsection> |
| <subsection name="Building framework website"> |
| <p>To build the framework website:</p> |
| <ul> |
| <li><p><a href="../download.html">download</a> the source |
| distribution, or checkout the latest version:</p> |
| <p><source>svn co http://svn.apache.org/repos/asf/tiles/framework/trunk/</source></p></li> |
| <li><p>go into the source directory and type:</p> |
| <p><source>mvn site</source></p></li> |
| </ul> |
| <p>You will find the generated websites under:</p> |
| <ul> |
| <li>{tiles-dir}/target/site</li> |
| <li>{tiles-dir}/tiles-api/target/site</li> |
| <li>{tiles-dir}/tiles-core/target/site</li> |
| <li>{tiles-dir}/tiles-jsp/target/site</li> |
| </ul> |
| </subsection> |
| </section> |
| </body> |
| |
| </document> |