This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/asf-staging by this push:
new bfe5f6220 Updates stage by Jenkins
bfe5f6220 is described below
commit bfe5f6220baefc4c79580abc9194907aba220e92
Author: jenkins <bui...@apache.org>
AuthorDate: Sat Feb 3 16:17:13 2024 +0000
Updates stage by Jenkins
---
content/plugins/tiles/index.html | 138 ++++++++++++++++++---------------------
1 file changed, 63 insertions(+), 75 deletions(-)
diff --git a/content/plugins/tiles/index.html b/content/plugins/tiles/index.html
index 29508682b..c7fe6cd11 100644
--- a/content/plugins/tiles/index.html
+++ b/content/plugins/tiles/index.html
@@ -155,7 +155,6 @@
<ul id="markdown-toc">
<li><a href="#features" id="markdown-toc-features">Features</a></li>
<li><a href="#usage" id="markdown-toc-usage">Usage</a> <ul>
- <li><a href="#accessing-struts-attributes"
id="markdown-toc-accessing-struts-attributes">Accessing Struts
attributes</a></li>
<li><a href="#i18n" id="markdown-toc-i18n">I18N</a></li>
</ul>
</li>
@@ -182,103 +181,92 @@ look and feel. It can be used for both page decorating
and componentization.</p>
<ol>
<li>Include the struts-tiles-plugin as a dependency in your web application.
If you are using maven2, the dependency
- configuration will be similar to:</li>
+ configuration will be similar to:
+ ```xml</li>
</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><dependency></span>
- <span class="nt"><groupId></span>org.apache.struts<span
class="nt"></groupId></span>
- <span class="nt"><artifactId></span>struts2-tiles-plugin<span
class="nt"></artifactId></span>
- <span class="nt"><version></span>${version.tiles}<span
class="nt"></version></span>
- <span class="nt"></dependency></span>
-</code></pre></div></div>
-<ol>
- <li>Register the Tiles listener. This listener will typically either be the
standard tiles listener <code class="language-plaintext
highlighter-rouge">org.apache.tiles.listener.TilesListener</code>
- or the Struts2 replacement <code class="language-plaintext
highlighter-rouge">org.apache.struts2.tiles.TilesListener</code>. The latter
provides tighter integration with
- Struts features such as freemarker integration.</li>
-</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><listener></span>
- <span
class="nt"><listener-class></span>org.apache.struts2.tiles.StrutsTilesListener<span
class="nt"></listener-class></span>
- <span class="nt"></listener></span>
+<dependency>
+ <groupId>org.apache.struts</groupId>
+ <artifactId>struts2-tiles-plugin</artifactId>
+ <version>${version.tiles}</version>
+ </dependency>
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
+2. Register the Tiles listener. This listener will typically either be the
standard tiles listener `org.apache.tiles.listener.TilesListener`
+ or the Struts2 replacement `org.apache.struts2.tiles.TilesListener`. The
latter provides tighter integration with
+ Struts features such as freemarker integration.
+ ```xml
+ <listener>
+
<listener-class>org.apache.struts2.tiles.StrutsTilesListener</listener-class>
+ </listener>
</code></pre></div></div>
<ol>
<li>All package definitions, which require tiles support, must either extend
the <code class="language-plaintext highlighter-rouge">tiles-default</code>
package or must register
- the <strong>Tiles Result</strong> type definition.</li>
-</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><result-types></span>
- <span class="nt"><result-type</span> <span class="na">name=</span><span
class="s">"tiles"</span> <span class="na">class=</span><span
class="s">"org.apache.struts2.views.tiles.TilesResult"</span><span
class="nt">/></span>
- <span class="nt"></result-types></span>
-</code></pre></div></div>
-
-<ol>
- <li>Configure your actions to utilize a tiles definition:</li>
+ the <strong>Tiles Result</strong> type definition.
+ ```xml</li>
</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nt"><action</span> <span
class="na">name=</span><span class="s">"sample"</span> <span
class="na">class=</span><span
class="s">"org.apache.struts2.tiles.example.SampleAction"</span> <span
class="nt">></span>
- <span class="nt"><result</span> <span class="na">name=</span><span
class="s">"success"</span> <span class="na">type=</span><span
class="s">"tiles"</span><span class="nt">></span>tilesWorks<span
class="nt"></result></span>
- <span class="nt"></action></span>
+<result-types>
+ <result-type name="tiles"
class="org.apache.struts2.views.tiles.TilesResult" />
+ </result-types>
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
+4. Configure your actions to utilize a tiles definition:
+ ```xml
+ <action name="sample"
class="org.apache.struts2.tiles.example.SampleAction" >
+ <result name="success" type="tiles">tilesWorks</result>
+ </action>
</code></pre></div></div>
<ol>
- <li>Instead of xml configuration you can use annotations</li>
-</ol>
-
-<div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nd">@Result</span><span
class="o">(</span><span class="n">name</span> <span class="o">=</span> <span
class="s">"success"</span><span class="o">,</span> <span
class="n">type</span><span class="o">=</span><span
class="s">"tiles"</span><span class="o">)</span>
+ <li>Instead of xml configuration you can use annotations
+ <div class="language-java highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="nd">@Result</span><span
class="o">(</span><span class="n">name</span> <span class="o">=</span> <span
class="s">"success"</span><span class="o">,</span> <span
class="n">type</span><span class="o">=</span><span
class="s">"tiles"</span><span class="o">)</span>
<span class="nd">@TilesDefinition</span><span class="o">(</span><span
class="n">extend</span> <span class="o">=</span> <span
class="s">"fooLayout"</span><span class="o">,</span> <span
class="n">putAttributes</span> <span class="o">=</span> <span class="o">{</span>
- <span class="nd">@TilesPutAttribute</span><span class="o">(</span><span
class="n">name</span> <span class="o">=</span> <span
class="s">"header"</span><span class="o">,</span> <span class="n">value</span>
<span class="o">=</span> <span
class="s">"/WEB-INF/tiles/header.jsp"</span><span class="o">),</span>
- <span class="nd">@TilesPutAttribute</span><span class="o">(</span><span
class="n">name</span> <span class="o">=</span> <span
class="s">"body"</span><span class="o">,</span> <span class="n">value</span>
<span class="o">=</span> <span class="s">"/WEB-INF/tiles/body.ftl"</span><span
class="o">)</span>
+ <span class="nd">@TilesPutAttribute</span><span class="o">(</span><span
class="n">name</span> <span class="o">=</span> <span
class="s">"header"</span><span class="o">,</span> <span class="n">value</span>
<span class="o">=</span> <span
class="s">"/WEB-INF/tiles/header.jsp"</span><span class="o">),</span>
+ <span class="nd">@TilesPutAttribute</span><span class="o">(</span><span
class="n">name</span> <span class="o">=</span> <span
class="s">"body"</span><span class="o">,</span> <span class="n">value</span>
<span class="o">=</span> <span class="s">"/WEB-INF/tiles/body.ftl"</span><span
class="o">)</span>
<span class="o">})</span>
<span class="kd">public</span> <span class="kd">class</span> <span
class="nc">FooAction</span> <span class="kd">extends</span> <span
class="nc">ActionSupport</span> <span class="o">{</span>
-</code></pre></div></div>
-
-<ol>
- <li>You have to define Tiles Definitions in a <code
class="language-plaintext highlighter-rouge">tiles.xml</code> file. That can be
placed in <code class="language-plaintext highlighter-rouge">resources</code>
or in <code class="language-plaintext highlighter-rouge">WEB-INF</code>.</li>
+</code></pre></div> </div>
+ </li>
+ <li>You have to define Tiles Definitions in a <code
class="language-plaintext highlighter-rouge">tiles.xml</code> file. That can be
placed in <code class="language-plaintext highlighter-rouge">resources</code>
or in <code class="language-plaintext highlighter-rouge">WEB-INF</code>.
+ ```xml
+ <!DOCTYPE tiles-definitions PUBLIC
+ “-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN”
+ “http://tiles.apache.org/dtds/tiles-config_3_0.dtd”></li>
</ol>
-
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code> <span class="cp"><!DOCTYPE tiles-definitions PUBLIC
- "-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
- "http://tiles.apache.org/dtds/tiles-config_3_0.dtd"></span>
- <span class="nt"><tiles-definitions></span>
+<tiles-definitions>
- <span class="nt"><definition</span> <span
class="na">name=</span><span class="s">"fooLayout"</span> <span
class="na">template=</span><span
class="s">"/WEB-INF/tiles/layout.jsp"</span><span class="nt">></span>
- <span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"title"</span> <span
class="na">value=</span><span class="s">"Tiles Sample"</span><span
class="nt">/></span>
- <span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"header"</span> <span
class="na">value=</span><span class="s">".header"</span><span
class="nt">/></span>
- <span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"body"</span> <span
class="na">value=</span><span class="s">".bodyp"</span><span
class="nt">/></span>
- <span class="nt"></definition></span>
+ <definition name="fooLayout" template="/WEB-INF/tiles/layout.jsp">
+ <put-attribute name="title" value="Tiles Sample" />
+ <put-attribute name="header" value=".header" />
+ <put-attribute name="body" value=".bodyp" />
+ </definition>
- <span class="nt"><definition</span> <span
class="na">name=</span><span class="s">"tilesWorks"</span> <span
class="na">extends=</span><span class="s">"fooLayout"</span><span
class="nt">></span>
- <span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"header"</span> <span
class="na">value=</span><span class="s">"/WEB-INF/tiles/header.jsp"</span><span
class="nt">/></span>
- <span class="nt"><put-attribute</span> <span
class="na">name=</span><span class="s">"body"</span> <span
class="na">value=</span><span class="s">"/WEB-INF/tiles/body.jsp"</span><span
class="nt">/></span>
- <span class="nt"></definition></span>
+ <definition name="tilesWorks" extends="fooLayout">
+ <put-attribute name="header" value="/WEB-INF/tiles/header.jsp" />
+ <put-attribute name="body" value="/WEB-INF/tiles/body.jsp" />
+ </definition>
- <span class="nt"></tiles-definitions></span>
-</code></pre></div></div>
-
-<p>As from Struts 2.3.28, the plugin automatically loads all Tiles definitions
matching the following pattern <code class="language-plaintext
highlighter-rouge">tiles*.xml</code> -
-you don’t have to specify them via <code class="language-plaintext
highlighter-rouge">org.apache.tiles.definition.DefinitionsFactory.DEFINITIONS_CONFIG</code>
in <code class="language-plaintext highlighter-rouge">web.xml</code>,
+ </tiles-definitions>
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre
class="highlight"><code>
+As from Struts 2.3.28, the plugin automatically loads all Tiles definitions
matching the following pattern `tiles*.xml` -
+you don't have to specify them via
`org.apache.tiles.definition.DefinitionsFactory.DEFINITIONS_CONFIG` in
`web.xml`,
but you can use this option if your application is going to work in restricted
servlet environment e.g., Google AppEngine.
-In such case, definitions will be read from the provided init-param.</p>
+In such case, definitions will be read from the provided init-param.
-<blockquote>
- <p>Note: When using a Tomcat WAR versoning mechanism which uses <code
class="language-plaintext highlighter-rouge">##</code> you must specify all the
tiles definition directly using
-the <code class="language-plaintext highlighter-rouge">init-param</code>, in
other case it won’t be loaded. It’s due to limitation of <code
class="language-plaintext highlighter-rouge">URL</code> class.</p>
-</blockquote>
+> Note: When using a Tomcat WAR versoning mechanism which uses `##` you
must specify all the tiles definition directly
+> using the `init-param`, in other case it won't be loaded. It's due to
limitation of `URL` class.
-<h3 id="accessing-struts-attributes">Accessing Struts attributes</h3>
+### Accessing Struts attributes
-<p>As from Struts version 2.5.3 it’s possible accessing defined values on a
<code class="language-plaintext highlighter-rouge">ValueStack</code> using
<code class="language-plaintext highlighter-rouge">S2</code> prefix when
defining
-an expression in tiles definition, e.g.:</p>
+As from Struts version 2.5.3 it's possible accessing defined values on a
`ValueStack` using `S2` prefix when defining
+an expression in tiles definition, e.g.:
-<div class="language-xml highlighter-rouge"><div class="highlight"><pre
class="highlight"><code><span class="nt"><definition</span> <span
class="na">name=</span><span class="s">"home"</span> <span
class="na">extends=</span><span class="s">"logged-in"</span><span
class="nt">></span>
- <span class="nt"><put-attribute</span> <span class="na">name=</span><span
class="s">"title"</span> <span class="na">expression=</span><span
class="s">"S2:actionProperty"</span><span class="nt">/></span>
- <span class="nt"><put-attribute</span> <span class="na">name=</span><span
class="s">"body"</span> <span class="na">value=</span><span
class="s">"/WEB-INF/tiles/home.jsp"</span><span class="nt">/></span>
-<span class="nt"></definition></span>
+```xml
+<definition name="home" extends="logged-in">
+ <put-attribute name="title" expression="S2:actionProperty"/>
+ <put-attribute name="body" value="/WEB-INF/tiles/home.jsp"/>
+</definition>
</code></pre></div></div>
-<p>In such case Tiles will delegate evaluation of the expression to Struts and
<code class="language-plaintext highlighter-rouge">ValueStack</code> will be
examined to evaluate
-the expression.</p>
+<p>In such case Tiles will delegate evaluation of the expression to Struts and
<code class="language-plaintext highlighter-rouge">ValueStack</code> will be
examined.</p>
<h3 id="i18n">I18N</h3>
