Tapestry is a component based framework for creating sophisticated web applications. It's used with existing application servers, acting as a kind of "super servlet". Tapestry applications are built by configuring and combining components to form pages. You get surprisingly large amounts of robust functionality for startingly small amounts of effort and code!

The JARs were created on @OS_NAME@ @OS_VERSION@ using the @JAVA_VENDOR@ JDK @JAVA_VM_VERSION@ compiler.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

.....................................................

Configuration

Tapestry ships with the the Tapestry Tutorial and the Virtual Library demo applications, which are very easy to configure and run. To run these Tapestry appliations please ensure:

• JDK 1.3 or newer JVM is installed, and the JAVA_HOME environment variable is set.
• Ant 1.5 or newer is installed, and is added to the system PATH.

To run the Tapestry Tutorial and the Virtual Library applications with the JBoss server:

• Download JBoss 3.0.4.
  JBoss is an open-source application server, used to run the database and Enterprise JavaBeans in the Virtual Library.

  This auto-configuration requires JBoss 3.0.4 exactly, not a later release. This only affects these turn-key demos, not deployment of your own Tapestry applications.

• Create the file config/build.properties.
  This file informs Tapestry where JBoss as been installed. The config directory contains a template file. Set jboss.dir to the JBoss installation directory, for example C:/JBoss-3.0.4. Note: Use only forward slashes in this file name.
• Execute the command: ant -emacs configure run-jboss
  This will copy and configure the necessary files in the JBoss installation directory, then run the JBoss server, automatically deploying the Tapestry Tutorial and the Virtual Library demonstration. (The -emacsoption changes the Ant output format to be less verbose).

Congratulations, you can now run the Tapestry Tutorial or the Virtual Library applications.

To run the Tapestry Tutorial application with the Jetty server included in this distribution (this does not involve JBoss):

• Execute the command: ant run-tutorial
  This will run the embedded Jetty server and the Tapestry Tutorial application.

To deploy the Tapestry Tutorial application onto an existing Tomcat server:

• Create the file config/build.properties.
  This file informs Tapestry where Tomcat as been installed. The config directory contains a template file. Set tomcat.dir to the Tomcat installation directory, for example C:/Program Files/Apache Group/Tomcat 4.1. Note: Use only forward slashes in this file name.
• Execute the command: ant deploy-tomcat
  This will deploy the tutorial application into the Tomcat server. If Tomcat is running you should be able to access the Tapestry Tutorial application, otherwise start Tomcat to access the application.

Documentation

	Tapestry API Documentation Full documentation for the Tapestry framework, the contrib framework (which contains additional components and classes), and all the example code.
	Tapestry Component Reference A handy refrence to the built-in Tapestry components, with example specifications, HTML templates and code.
	Tutorial [PDF] The best way to begin learning about the Tapestry framework; this document eases the reader into basic Tapestry concepts. This Tutorial is out of date, and work to replace it is currently taking place.
	Tapestry Developer's Guide [PDF] Exhaustive reference for Tapestry, in extreme detail. This document is out of date, and is being replaced with a new User's Guide.
	Tapestry User's Guide [PDF] Complete reference to the Tapestry framework. This document is currently being constructed.
	Tapestry Contributor's Guide [PDF] A guide for advanced developers who want to contribute code back to the Tapestry framework. Discusses coding conventions, CVS access procedures, documentation standards and the like.
	Tapestry Web Site A local copy of the Tapestry Home Page is available well.

.....................................................

Tapestry is an open source project, hosted by The Jakarta Project and distributed under the terms of the Apache Software License 1.1.