You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by rl...@apache.org on 2004/01/31 00:10:28 UTC
cvs commit: jakarta-struts/src/share/org/apache/struts/tiles package.html
rleland 2004/01/30 15:10:28
Modified: src/share/org/apache/struts/tiles package.html
Log:
Use "a; instead of " in <pre> and other --text-- sections.
Revision Changes Path
1.11 +46 -46 jakarta-struts/src/share/org/apache/struts/tiles/package.html
Index: package.html
===================================================================
RCS file: /home/cvs/jakarta-struts/src/share/org/apache/struts/tiles/package.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- package.html 26 Jul 2003 06:09:33 -0000 1.10
+++ package.html 30 Jan 2004 23:10:28 -0000 1.11
@@ -16,7 +16,7 @@
<p><img src="doc-files/image001.gif" height="169" width="145" alt="doc-files/image001"></p>
<p>Each Tiles (header, menu, body, ...) is a JSP page and can itself be build
by assembling other Tiles.</p>
-<p>Using Tiles can be compared as using Java methods: You need to define the Tiles (the method body), and then you can "call" this body anywhere you want, passing it some parameters. In Tiles, parameters are called "attributes" in order to avoid confusion with the request parameters.</p>
+<p>Using Tiles can be compared as using Java methods: You need to define the Tiles (the method body), and then you can "call" this body anywhere you want, passing it some parameters. In Tiles, parameters are called "attributes" in order to avoid confusion with the request parameters.</p>
<p>The Tiles body can be a simple JSP page, a Struts action or any URI pointing
to a resource inside the current web site.</p>
<p>Inserting the body, or calling it, is done with the tag <tiles:insert
@@ -26,10 +26,10 @@
<p>Tiles bodies are used to create layouts, reusable parts, ... Tiles insertions
are used to insert Tiles. The same Tiles can be reused several times in
the same site, or even in the same page.</p>
-<p>Insertion of a Tiles body can be associated to a logical name in what Tiles calls a "definition". A definition contains a logical name, a page used as body and some attribute values. The definition declaration doesn't insert the associated Tiles body. It just associates it with the name. A definition name can be used anywhere insertion of a Tiles body can occur. The associated Tiles body is then inserted with associated attributes.</p>
+<p>Insertion of a Tiles body can be associated to a logical name in what Tiles calls a "definition". A definition contains a logical name, a page used as body and some attribute values. The definition declaration doesn't insert the associated Tiles body. It just associates it with the name. A definition name can be used anywhere insertion of a Tiles body can occur. The associated Tiles body is then inserted with associated attributes.</p>
<p>The definition declarations can be done in JSP pages or in one or more
centralized files. A definition can extend another one, overload some attributes,
- add new attributes ... This allows the declaration of a "master" definition
+ add new attributes ... This allows the declaration of a "master" definition
declaring the common layout, header, menu and footer. All other definitions
extend this master layout thereby making it possible to change the entire
site look & feel simply by changing the master definition. </p>
@@ -38,20 +38,20 @@
<h2>Simple Examples</h2>
<div class="subsection1">
<h3>Insert a JSP page</h3>
- <pre><tiles:insert <strong>page</strong>="/layouts/commonLayout.jsp" flush="true" />
+ <pre><tiles:insert <strong>page</strong>="/layouts/commonLayout.jsp" flush="true" />
</pre>
<p>This example inserts the specified page in place of the tag. The page attribute is any valid URL pointing to a resource inside the current site.</p>
</div>
<div class="subsection1">
-<a name="doc.InsertPageWithAttributes">
+<a name="doc.InsertPageWithAttributes"></a>
<h3>Insert a Tiles passing some attributes</h3>
<pre>
-<tiles:insert page="/layouts/classicLayout.jsp" flush="true">
- <tiles:put name="title" value="Page Title" />
- <tiles:put name="header" value="/common/header.jsp" />
- <tiles:put name="footer" value="/common/footer.jsp" />
- <tiles:put name="menu" value="/common/menu.jsp" />
- <tiles:put name="body" value="/tiles/mainBody.jsp" />
+<tiles:insert page="/layouts/classicLayout.jsp" flush=&quot;true">
+ <tiles:put name="title" value="Page Title" />
+ <tiles:put name="header" value="/common/header.jsp" />
+ <tiles:put name="footer" value="/common/footer.jsp" />
+ <tiles:put name="menu" value="/common/menu.jsp" />
+ <tiles:put name="body" value="/tiles/mainBody.jsp" />
</tiles:insert>
</pre>
<p>This example inserts the specified page, passing it the attributes. Attributes
@@ -61,16 +61,16 @@
<div class="subsection1">
<h3>Retrieve an attribute value as String</h3>
<pre>
-<tiles:getAsString name="title" />
+<tiles:getAsString name="title" />
</pre>
-<p>This example retrieves the value of the attribute "title" and prints it as a String in the current output stream. The method toString() is applied on the attribute value, allowing to pass any kind of object as value.</p>
+<p>This example retrieves the value of the attribute "title" and prints it as a String in the current output stream. The method toString() is applied on the attribute value, allowing to pass any kind of object as value.</p>
</div>
<div class="subsection1">
<h3>Insert Tiles referenced by an attribute</h3>
<pre>
<tiles:insert attribute='menu' />
</pre>
- <p>This inserts the Tiles referenced by the attribute "menu" value. The
+ <p>This inserts the Tiles referenced by the attribute "menu" value. The
specified attribute value is first retrieved from current Tiles's context,
and then the value is used as a page target to insert.</p>
</div>
@@ -79,29 +79,29 @@
<p>This example is a layout assembling a page in the classic header-footer-menu-body
fashion.</p>
<pre>
-<%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %>
+<%@ taglib uri="/WEB-INF/struts-tiles.tld" prefix="tiles" %>
<HTML>
<HEAD>
- <link rel="stylesheet" href="<%=request.getContextPath()%>/layouts/stylesheet.css"
- type="text/css"/>
- <title><tiles:getAsString name="title"/></title>
+ <link rel="stylesheet" href="<%=request.getContextPath()%>/layouts/stylesheet.css"
+ type="text/css"/>
+ <title><tiles:getAsString name="title"/></title>
</HEAD>
<body>
-<table border="0" width="100%" cellspacing="5">
+<table border="0" width="100%" cellspacing="5">
<tr>
- <td colspan="2"><tiles:insert attribute="header" /></td>
+ <td colspan="2"><tiles:insert attribute="header" /></td>
</tr>
<tr>
- <td width="140" valign="top">
+ <td width="140" valign="top">
<tiles:insert attribute='menu' />
</td>
- <td valign="top" align="left">
+ <td valign="top" align="left">
<tiles:insert attribute='body' />
</td>
</tr>
<tr>
- <td colspan="2">
- <tiles:insert attribute="footer" />
+ <td colspan="2">
+ <tiles:insert attribute="footer" />
</td>
</tr>
</table>
@@ -109,8 +109,8 @@
</html>
</pre>
<p>The layout is declared in a JSP page (ex: /layouts/classicLayout.jsp).
- It can be used in conjunction with the tag described in "<a href="#doc.InsertPageWithAttributes">Insert
- a page passing some attributes</a>". </p>
+ It can be used in conjunction with the tag described in "<a href="#doc.InsertPageWithAttributes">Insert
+ a page passing some attributes</a>". </p>
</div>
</div>
<div class="section">
@@ -127,7 +127,7 @@
the body.</p>
<p>Definitions can be declared in a JSP page, or in one or more centralized
files. To enable the definitions from centralized files, you need to initialize
- the "definitions factory" which will parse the definitions from the files
+ the "definitions factory&&quot; which will parse the definitions from the files
and provide them to the Tiles framework.</p>
<div class="subsection1">
<h3>Enabling Definition Factory</h3>
@@ -144,13 +144,13 @@
are optional and can be omitted. The plug-in should be declared in each
struts-config file:</p>
<pre>
- <plug-in className="org.apache.struts.tiles.TilesPlugin" >
- <set-property property="definitions-config"
- value="/WEB-INF/tiles-defs.xml,
+ <plug-in className=&&quot;org.apache.struts.tiles.TilesPlugin&&quot; >
+ <set-property property=&&quot;definitions-config&&quot;
+ value=&&quot;/WEB-INF/tiles-defs.xml,
/WEB-INF/tiles-tests-defs.xml,/WEB-INF/tiles-tutorial-defs.xml,
- /WEB-INF/tiles-examples-defs.xml" />
- <set-property property="moduleAware" value="true" />
- <set-property property="definitions-parser-validate" value="true" />
+ /WEB-INF/tiles-examples-defs.xml&&quot; />
+ <set-property property=&&quot;moduleAware&&quot; value=&&quot;true&&quot; />
+ <set-property property=&&quot;definitions-parser-validate&&quot; value=&&quot;true&&quot; />
</plug-in>
</pre>
<ul>
@@ -191,8 +191,8 @@
<ul>
<li>Specify The classname of the TilesUtil implementation to use. The specified class should
be a subclass of TilesUtilStrutsImpl. This option disable the moduleAware option.
- <br>Specifying "TilesUtilStrutsImpl" is equivalent to moduleAware = false.</br>
- <br>Specifying "TilesUtilStrutsModuleImpl" is equivalent to moduleAware = true.</br>
+ <br>Specifying &&quot;TilesUtilStrutsImpl&&quot; is equivalent to moduleAware = false.</br>
+ <br>Specifying &&quot;TilesUtilStrutsModuleImpl&&quot; is equivalent to moduleAware = true.</br>
This option is taken into account only once, when it is first encountered. To avoid problems,
it is advice to specify the same values in all TilesPlugin declaration.
</li>
@@ -272,8 +272,8 @@
<p>Following is a simple example:</p>
<pre>
<!DOCTYPE tiles-definitions PUBLIC
- "-//Apache Software Foundation//DTD Tiles Configuration//EN"
- "http://jakarta.apache.org/struts/dtds/tiles-config_1_1.dtd">
+ &&quot;-//Apache Software Foundation//DTD Tiles Configuration//EN&&quot;
+ &&quot;http://jakarta.apache.org/struts/dtds/tiles-config_1_1.dtd&&quot;>
<!-- Definitions for Tiles documentation -->
<tiles-definitions>
@@ -283,12 +283,12 @@
<!-- ========================================================== -->
<!-- Main page layout used as a root for other page definitions -->
- <definition name="site.mainLayout" path="/layouts/classicLayout.jsp">
- <put name="title" value="Tiles Blank Site" />
- <put name="header" value="/tiles/common/header.jsp" />
- <put name="menu" value="site.menu.bar" />
- <put name="footer" value="/tiles/common/footer.jsp" />
- <put name="body" value="/tiles/body.jsp" />
+ <definition name=&&quot;site.mainLayout&&quot; path=&&quot;/layouts/classicLayout.jsp&&quot;>
+ <put name=&&quot;title&&quot; value=&&quot;Tiles Blank Site&&quot; />
+ <put name=&&quot;header&&quot; value=&&quot;/tiles/common/header.jsp&&quot; />
+ <put name=&&quot;menu&&quot; value=&&quot;site.menu.bar&&quot; />
+ <put name=&&quot;footer&&quot; value=&&quot;/tiles/common/footer.jsp&&quot; />
+ <put name=&&quot;body&&quot; value=&&quot;/tiles/body.jsp&&quot; />
</definition>
<!-- ========================================================== -->
@@ -300,9 +300,9 @@
properties (here header, menu, footer, layout)
-->
- <definition name="site.index.page" extends="site.mainLayout" >
- <put name="title" value="Tiles Blank Site Index" />
- <put name="body" value="/tiles/body.jsp" />
+ <definition name=&&quot;site.index.page&&quot; extends=&&quot;site.mainLayout&&quot; >
+ <put name=&&quot;title&&quot; value=&&quot;Tiles Blank Site Index&&quot; />
+ <put name=&&quot;body&&quot; value=&&quot;/tiles/body.jsp&&quot; />
</definition>
</tiles-definition>
---------------------------------------------------------------------
To unsubscribe, e-mail: struts-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: struts-dev-help@jakarta.apache.org