cedric 02/02/22 05:01:24
Modified: contrib/tiles/web/doc/doc/portal revisions.jsp download.jsp
contrib/tiles/doc installation.xml
Log:
Update Tiles documentation
Revision Changes Path
1.9 +24 -3 jakarta-struts/contrib/tiles/web/doc/doc/portal/revisions.jsp
Index: revisions.jsp
===================================================================
RCS file: /home/cvs/jakarta-struts/contrib/tiles/web/doc/doc/portal/revisions.jsp,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- revisions.jsp 18 Feb 2002 14:48:39 -0000 1.8
+++ revisions.jsp 22 Feb 2002 13:01:24 -0000 1.9
@@ -2,6 +2,25 @@
<tr>
<th bgcolor="aqua"><FONT size=4>History</FONT></th></tr>
<TR>
+ <TD><FONT size=2><STRONG> 22 Feb. 2002</STRONG> </FONT></TD></TR>
+ <TR>
+ <TD>
+ <UL>
+ <LI><FONT size=2>Correct build process preventing examples compilation in
war files </FONT></LI>
+ </UL>
+ </TD>
+ </TR>
+ <TR>
+ <TD><FONT size=2><STRONG> 20 Feb. 2002</STRONG> </FONT></TD></TR>
+ <TR>
+ <TD>
+ <UL>
+ <LI><FONT size=2>New tiles-blank-struts1.x applications</FONT></LI>
+ <LI><FONT size=2>Change distribution (again) : back to the old
fashion</FONT></LI>
+ </UL>
+ </TD>
+ </TR>
+ <TR>
<TD><FONT size=2><STRONG> 18 Feb. 2002</STRONG> </FONT></TD></TR>
<TR>
<TD>
@@ -68,6 +87,8 @@
<LI><FONT size=2>Add Tile Rss Channel (Thanks Ted
Husted)</FONT></LI></UL></TD></TR>
<TR>
- <TD><FONT size=2><STRONG> <A
href="<%=request.getContextPath()%>/doc/portal/revisionsCont.html"><FONT
- size=2><STRONG>more
-...</STRONG></FONT></A></STRONG></FONT></TD></TR></table>
\ No newline at end of file
+ <TD><FONT size=2><STRONG> <A
href="<%=request.getContextPath()%>/doc/portal/revisionsCont.html">
+ <FONT size=2><STRONG>more ...</STRONG></FONT></A></STRONG></FONT>
+ </TD>
+ </TR>
+</table>
\ No newline at end of file
1.9 +28 -74 jakarta-struts/contrib/tiles/web/doc/doc/portal/download.jsp
Index: download.jsp
===================================================================
RCS file: /home/cvs/jakarta-struts/contrib/tiles/web/doc/doc/portal/download.jsp,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- download.jsp 18 Feb 2002 14:48:39 -0000 1.8
+++ download.jsp 22 Feb 2002 13:01:24 -0000 1.9
@@ -6,21 +6,23 @@
<tr>
<td>
<p></p>
- <DIV align=center><STRONG><EM><FONT size=2>Choose between the latest
- stable release, or the development release.</FONT></EM></STRONG></DIV>
- <DIV align=center> </DIV>
- <DIV align=center><FONT size=2><STRONG>Stable </STRONG>release build and
- shipped with Struts 1.0.2</FONT></DIV>
- <div align="center">
- <font size="2"> Latest build : 2002 02 18</font> </div>
- <div align="center">
- <table border="2">
+
+
+ <DIV align=center>
+ <div align="center">
+ <font size="2">Choose between binaries or sources distribution</font> </div>
+ <br>
+ <DIV align=center><FONT size=2>Latest build : 2002 02 20 </FONT></DIV>
+ <DIV align=center>
+
+
+ <table border="2">
<tr>
<td>
<p align="center">
- <font color="#ff0000"><STRONG>Stable
Release<BR></STRONG></font>
- <FONT size=2>build and
shipped <BR>with Struts1.0.x</FONT> </p>
- </td>
+ <font
color="#ff0000"><strong>Development</strong></font>
+ <br>
+ </p></td>
<td>
<p align="center">
<font size="2"><strong>binaries<br></strong>(src
excluded)</font> </p></td>
@@ -35,21 +37,21 @@
<td>
<div align="left">
<a href=
-
"http://www.lifl.fr/~dumoulin/tiles/release1_1/tiles.zip";><strong>
+
"http://www.lifl.fr/~dumoulin/tiles/tiles.zip";><strong>
tiles.zip</strong></a> </div>
<div align="left">
<a href=
-
"http://www.lifl.fr/~dumoulin/tiles/release1_1/tiles.tar.gz";>
+ "http://www.lifl.fr/~dumoulin/tiles/tiles.tar.gz";>
<strong>tiles.tar.gz</strong></a> </div></td>
<td>
<div align="left">
<a href=
-
"http://www.lifl.fr/~dumoulin/tiles/release1_1/tiles-src.zip";>
+ "http://www.lifl.fr/~dumoulin/tiles/tiles-src.zip";>
<font size=
"2"><strong>tiles-src.zip</strong></font></a> </div>
<div align="left">
<a href=
-
"http://www.lifl.fr/~dumoulin/tiles/release1_1/tiles-src.tar.gz";>
+ "http://www.lifl.fr/~dumoulin/tiles/tiles-src.tar.gz";>
<strong><font size=
"2">tiles-src.tar.gz</font></strong></a>
</div></td></tr>
@@ -59,81 +61,33 @@
<font size="2"><strong>Mirror
:</strong></font> </div>
<div align="right">
- <font size="2">(<a href=
-
"http://www.geocities.com";>www.geocities.com</a>)</font> </div></td>
+ <font size="2">(<a
href="http://www.geocities.com/cedricDumoulin/tiles";>
+ www.geocities.com</a>)</font> </div></td>
<td>
<div align="left">
<a href=
-
"http://www.geocities.com/cedricdumoulin/tiles/release1_1/tiles.zip";>
+
"http://www.geocities.com/cedricdumoulin/tiles/tiles.zip";>
<strong>tiles.zip</strong></a> </div>
<div align="left">
<strong><a href=
-
"http://www.geocities.com/cedricdumoulin/tiles/release1_1/tiles.tar.gz";>
+
"http://www.geocities.com/cedricdumoulin/tiles/tiles.tar.gz";>
tiles.tar.gz</a></strong> </div></td>
<td>
<div align="left">
<a href=
-
"http://www.geocities.com/cedricdumoulin/tiles/release1_1/tiles-src.zip";>
+
"http://www.geocities.com/cedricdumoulin/tiles/tiles-src.zip";>
<font size=
"2"><strong>tiles-src.zip</strong></font></a> </div>
<div align="left">
<strong><a href=
-
"http://www.geocities.com/cedricdumoulin/tiles/release1_1/tiles-src.tar.gz";>
+
"http://www.geocities.com/cedricdumoulin/tiles/tiles-src.tar.gz";>
<font size=
"2">components-src.tar.gz</font></a></strong>
- </div></td></tr></table></div>
-
- <DIV align=center> </DIV>
- <DIV align=center>
- <DIV align=center><FONT size=2><STRONG>Development </STRONG>release build
- and shipped with Struts 1.1 dev </FONT></DIV>
- <DIV align=center><FONT size=2>Latest build : 2002 02 18 (with struts 2002 02
10 - 1.1dev)</FONT></DIV>
- <DIV align=center>
-
-
- <table border="2">
- <tr>
- <td>
- <p align="center">
- <font
color="#ff0000"><strong>Development</strong></font>
- <br>
- <FONT size=2>build and
shipped <BR>with Struts1.1dev</FONT>
- </p></td>
- <td>
- <p align="center">
- <font size="2"><strong>binaries<br></strong>(src
excluded)</font> </p></td>
- <td>
- <p align="center">
- <font size="2"><strong>sources</strong></font>
</p></td></tr>
- <tr>
- <td>
- <div align="right">
- <font size="2"><strong>Main site :<br></strong>(<a
href=
-
"http://www.lifl.fr/~dumoulin/tiles";>www.lifl.fr</a>)</font> </div></td>
- <td>
- <div align="left">
- <a href=
-
"http://www.lifl.fr/~dumoulin/tiles/tiles.zip";><strong>
- tiles.zip</strong></a> </div>
- <div align="left">
- <a href=
- "http://www.lifl.fr/~dumoulin/tiles/tiles.tar.gz";>
- <strong>tiles.tar.gz</strong></a> </div></td>
- <td>
- <div align="left">
- <a href=
- "http://www.lifl.fr/~dumoulin/tiles/tiles-src.zip";>
- <font size=
- "2"><strong>tiles-src.zip</strong></font></a> </div>
- <div align="left">
- <a href=
- "http://www.lifl.fr/~dumoulin/tiles/tiles-src.tar.gz";>
- <strong><font size=
- "2">tiles-src.tar.gz</font></strong></a>
-</div></td></tr>
+ </div></td></tr>
</table></DIV>
- <DIV align=center><FONT size=2><FONT size=2><EM><STRONG>Tiles development
- release </STRONG></EM>is also distributed with<STRONG> <EM>Struts 1.1 .
+ <br>
+ <DIV align=center><FONT size=2><FONT size=2>
+ <EM><STRONG>Tiles </STRONG></EM>is also distributed with<STRONG> <EM>Struts
1.1 .
<BR>
</EM></STRONG>You can download it by downloading <A
href="http://jakarta.apache.org/struts";><STRONG><EM>Struts</EM></STRONG></A><STRONG><EM>.</EM></STRONG></FONT></FONT></DIV></DIV></td></tr></table>
1.2 +37 -7 jakarta-struts/contrib/tiles/doc/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/contrib/tiles/doc/installation.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation.xml 18 Feb 2002 15:02:03 -0000 1.1
+++ installation.xml 22 Feb 2002 13:01:24 -0000 1.2
@@ -23,6 +23,16 @@
(<a
href="http://localhost:8080/tiles-doc";>http://localhost:8080/tiles-doc</a> or
<a
href="http://localhost:8080/struts-tiles";>http://localhost:8080/struts-tiles</a> with
tomcat</li>
</ul>
+ <p>Quick start and setting of a new application using Tiles</p>
+ <ul>
+ <li>Take appropriate <code>tiles-blank.war</code> and copy it in your
web server webapps directory</li>
+ <ul>
+ <li><code>tiles-blank.war</code> - Tiles without Struts</li>
+ <li><code>tiles-blank-struts1.1.war</code> - Tiles with
Struts1.1</li>
+ <li><code>tiles-blank-struts1.0.war</code> - Tiles with latest
stable Struts1.0.x</li>
+ </ul>
+ <li>These war files are not distributed with Struts binaries.</li>
+ </ul>
</section>
<section name="Prerequisite Software" href="Prerequisites">
@@ -93,6 +103,7 @@
<li><em>Beanutils</em> (Version 1.0 or later)</li>
<li><em>Collections</em> (Version 1.0 or later)</li>
<li><em>Digester</em> (Version 1.0 or later)</li>
+ <li><em>Logging</em> (Version 1.0 or later)</li>
</ul>
<li><strong>Xalan XSLT Processor</strong> - If you are building Tiles
from
the source distribution, you will need a version of Xalan to perform
@@ -134,6 +145,9 @@
to encounter ClassNotFoundException problems unless <em>all</em> of
your application classes are stored in the shared repository.
</li>
+ <li><strong>lib/struts1.0/tilesForStruts1.0.jar</strong> - Same as
before,
+ but for use with Struts1.0.x.
+ </li>
<li><strong>lib/tiles.tld</strong> - These is the "tag library
descriptor" file that describe the custom tags in the Tiles
tag libraries. It should be copied into the <code>WEB-INF</code>
@@ -148,13 +162,19 @@
any servlet container compatible with Servlet API 2.2 or later.
</li>
<li><strong>webapps/tiles-channel.war</strong> - Examples using a
- custom definition factory.
+ custom definition factory. This example has some b
</li>
<li><strong>webapps/tiles-blank.war</strong>
- A blank application that can be used as a starting point when you
want to develop your own application with Tiles. This blank
application
doesn't contains neither use Struts. If you also want to use Struts,
add
- struts.jar and related tld files
+ struts.jar and related tld files, or choose one of the following
applications.
+ </li>
+ <li><strong>webapps/tiles-blank-struts1.1.war</strong>
+ - A blank application to use with Struts1.1
+ </li>
+ <li><strong>webapps/tiles-blank-struts1.0.war</strong>
+ - A blank application to use with Struts1.0.x
</li>
</ul>
@@ -191,7 +211,10 @@
</init-param>
...
</pre>
- <li>Create a configuration file for definitions. Its name must
match the one
+ <li>If you don't want to use Struts, use
<code>org.apache.struts.tiles.TilesServlet</code>
+ as servlet.
+ </li>
+ <li>Create a configuration file for definitions. Its name must match the
one
provided before in <code>WEB-INF/web.xml</code>. Several comma separated
names can be provided.
</li>
@@ -226,12 +249,19 @@
<li>If you have downloaded a Tiles version build with Struts1.0.x, you
already have it.
</li>
- <li>If you have downloaded a Tiles version build with Struts1.1, locate
- and use tilesForStruts1.0.jar (exactly the same jar file as before, with
- a different name).
+ <li>Consider to use tilesForStruts1.0.jar located in
<code>lib/struts1.0</code>
+ </li>
+ </ul>
+ <p>Note to Struts1.1 users :</p>
+ <ul>
+ <li>You should also initialize a <code>TilesRequestProcessor</code>.
</li>
- <li>tilesForStruts1.0.jar is located in <code>lib/struts1.0</code>
+ <li>To do so, add following lines in your
<code>struts-config.xml</code> file :
</li>
+<pre>
+ <controller processorClass="org.apache.struts.tiles.TilesRequestProcessor">
+ </controller>
+</pre>
</ul>
</section>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
