You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tiles.apache.org by ap...@apache.org on 2007/03/15 16:04:16 UTC

svn commit: r518650 - in /tiles/site/src/site: site.xml xdoc/dev/building.xml

Author: apetrelli
Date: Thu Mar 15 08:04:15 2007
New Revision: 518650

URL: http://svn.apache.org/viewvc?view=rev&rev=518650
Log:
TILESSHARED-3
Added "building.xml" file that explains how to build the various pieces of Tiles.

Added:
    tiles/site/src/site/xdoc/dev/building.xml   (with props)
Modified:
    tiles/site/src/site/site.xml

Modified: tiles/site/src/site/site.xml
URL: http://svn.apache.org/viewvc/tiles/site/src/site/site.xml?view=diff&rev=518650&r1=518649&r2=518650
==============================================================================
--- tiles/site/src/site/site.xml (original)
+++ tiles/site/src/site/site.xml Thu Mar 15 08:04:15 2007
@@ -76,6 +76,9 @@
 
         <menu name="Developers">
             <item
+                    name="Building"
+                    href="/dev/building.html"/>
+            <item
                     name="Snapshots"
                     href="/dev/snapshots.html"/>
         </menu>

Added: tiles/site/src/site/xdoc/dev/building.xml
URL: http://svn.apache.org/viewvc/tiles/site/src/site/xdoc/dev/building.xml?view=auto&rev=518650
==============================================================================
--- tiles/site/src/site/xdoc/dev/building.xml (added)
+++ tiles/site/src/site/xdoc/dev/building.xml Thu Mar 15 08:04:15 2007
@@ -0,0 +1,134 @@
+<?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>

Propchange: tiles/site/src/site/xdoc/dev/building.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: tiles/site/src/site/xdoc/dev/building.xml
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL