blob: eaa9ba787f1485c43ba9f8b04b30911c854a93a4 [file] [log] [blame]
~~ $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
~~ Unless required by applicable law or agreed to in writing,
~~ software distributed under the License is distributed on an
~~ KIND, either express or implied. See the License for the
~~ specific language governing permissions and limitations
~~ under the License.
Getting started
To use Tiles in your application you need:
* a Java Runtime Environment following the <<Java SE 5.0>> specifications;
* a servlet container that supports <<Servlet 2.4>> (or above) and <<JSP
2.0>> (or above).
To install Tiles in your web application:
* {{{../download.html}download}} a distribution of Tiles;
* if you downloaded the binary distribution, unpack it;
* copy the <<<tiles-core-VERSION.jar>>>, <<<tiles-api-VERSION.jar>>>,
<<<tiles-servlet-VERSION.jar>>> and <<<tiles-jsp-VERSION.jar>>> files
in the <<<WEB-INF/lib>>> directory of your web application. It is
<<not reccomended>> to put them in a location where they are shared
across the container;
* copy the Tiles dependencies JARs:
** {{{}Jakarta Commons BeanUtils}}
1.8.0 or above;
** {{{}Jakarta Commons Digester}}
2.0 or above;
** {{{}SLF4J}} (API and an implementation) 1.5.8 or above.
You might need "jcl-over-slf4j" too.
These dependencies are present in the <<<lib>>> directory of the binary
* if you need JSP support, copy the <<<tiles-jsp-VERSION.jar>>>
and <<<tiles-template-VERSION.jar>>> in the
<<<WEB-INF/lib>>> directory of your web application;
* if you need to load Tiles definition files using wildcards, copy the
<<<spring-web-VERSION.jar>>>, <<<spring-core-VERSION.jar>>>,
<<<spring-context-VERSION.jar>>>, <<<spring-beans-VERSION.jar>>>,
<<<aopalliance-VERSION.jar>>> files under the <<<WEB-INF/lib>>> directory;
* if you need to load Tiles definition files using wildcards under a
<<portlet environment>>, copy the <<<spring-webmvc-portlet-VERSION.jar>>>,
<<<spring-core-VERSION.jar>>>, <<<spring-context-VERSION.jar>>>,
<<<spring-beans-VERSION.jar>>>, <<<aopalliance-VERSION.jar>>> files under the
<<<WEB-INF/lib>>> directory;
If you are using Tiles for the first time, read the
If you are migrating from Struts-Tiles, see the
{{{migration/index.html}Migration guide}}.
To see Tiles in action, there are two examples:
* The Tiles test web application, included in <<<examples>>> directory of the
binary distribution ({{{download.html}download it}}).
* The Tiles showcase, that shows Tiles features and integration with other
technologies and frameworks (currently only Struts 1).
Currently it is still under development, and you can access it through its
subversion repository: