Shale Blank Archetype
=====================

This directory contains the Shale Blank Archetype for Maven 2.

To use the archetype to create a blank project:

   $ cd ~/projects
   $ mvn archetype:create                                             \
         -DarchetypeGroupId=org.apache.shale                          \
         -DarchetypeArtifactId=shale-archetype-blank                  \
         -DarchetypeVersion=1.0.3-SNAPSHOT                            \
         -DgroupId=com.example                                        \
         -DpackageName=com.example.projectname                        \
         -DartifactId=projectname                                     \
         -DremoteRepositories=http://people.apache.org/repo/m2-snapshot-repository
         
To build your new webapp and install it in your local Maven repository:

   $ cd projectname
   $ mvn install

To start Tomcat and deploy your new webapp:

  Modify pom.xml to provide the path to a local Tomcat 5.x installation:
       <plugin>
         <groupId>org.codehaus.cargo</groupId>
         <artifactId>cargo-maven2-plugin</artifactId>
         ...
               <home>c:/java/apache-tomcat-5.5.17</home>

  $ mvn package cargo:start

   Open a browser and visit http://localhost:8080/projectname

To deploy the app and execute the Selenium functional tests:

  $ mvn package cargo:start -P selenium

   Open a browser and visit http://localhost:8080/projectname/selenium/core/TestRunner.html

   For more information, see: http://shale.apache.org/shale-apps/selenium.html

To build and install the archetype in your local repository:

   $ svn co http://svn.apache.org/repos/asf/shale/maven/trunk/archetypes
   $ cd archetypes/shale-archetype-blank
   $ mvn install

Prerequisites
-------------

   Maven 2 from http://maven.apache.org

Cargo Configuration
-------------------

   The Cargo plugin can be configured to download Apache Tomcat 5.5.17 by
   (in pom.xml) removing the <home> element and uncommenting the 
   <zipUrlInstaller> section.