You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tiles.apache.org by ap...@apache.org on 2007/05/18 15:54:36 UTC
svn commit: r539472 - /tiles/site/src/site/fml/faq.fml
Author: apetrelli
Date: Fri May 18 06:54:36 2007
New Revision: 539472
URL: http://svn.apache.org/viewvc?view=rev&rev=539472
Log:
TILESSHARED-12
Updated FAQs.
Modified:
tiles/site/src/site/fml/faq.fml
Modified: tiles/site/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/tiles/site/src/site/fml/faq.fml?view=diff&rev=539472&r1=539471&r2=539472
==============================================================================
--- tiles/site/src/site/fml/faq.fml (original)
+++ tiles/site/src/site/fml/faq.fml Fri May 18 06:54:36 2007
@@ -25,21 +25,66 @@
// ======================================================================== 78
-->
<faqs title="Tiles 2 FAQ">
- <part id="overview">
- <title>Tiles</title>
+ <part id="generic">
+ <title>Generic questions</title>
+ <faq id="what-is">
+ <question>What is Tiles?</question>
+ <answer>Tiles is a view layer framework for Java EE applications that
+ allows to separate pages into reusable pieces, according to the
+ Composite View design pattern.</answer>
+ </faq>
+ <faq id="creator">
+ <question>Who is the creator of Tiles?</question>
+ <answer>Tiles has been created by Cédric Dumoulin, who had the idea
+ and integrated it into Struts.</answer>
+ </faq>
+ <faq id="name">
+ <question>Why Tiles has this name?</question>
+ <answer>We did not ask Cédric, but I think that he thought about tiling
+ the pages. A tile here, a tile there, and you have your page complete!
+ </answer>
+ </faq>
+ <faq id="learn">
+ <question>Where do I start learning Tiles?</question>
+ <answer>First of all you have to <a href="getting_started.html">get
+ started</a>. Then check out the <a href="tutorial/index.html">Tutorial</a>
+ </answer>
+ </faq>
+ <faq id="support">
+ <question>How do I get support for Tiles?</question>
+ <answer>You can subscribe to the <a href="mail.html">users mailing list</a>
+ and ask your questions there.
+ </answer>
+ </faq>
+ <faq id="team">
+ <question>Who is developing Tiles?</question>
+ <answer>See the <a href="volunteers.html">team page</a>.
+ </answer>
+ </faq>
+ <faq id="helping">
+ <question>How can I help?</question>
+ <answer>
+ Struts website contains a nice <a href="http://struts.apache.org/helping.html">
+ how to help page</a>.
+ </answer>
+ </faq>
+ </part>
+ <part id="compatibility">
+ <title>Struts-Tiles relationship</title>
<faq id="changes">
<question>Is Tiles2 compatible with the version of tiles I've been using with Struts?</question>
<answer>
<p>
- Perhaps, but probaly not. Tiles2 is an ancestor of the original tiles
+ No. Struts-Tiles is an ancestor of Tiles 2
which grew out of the Struts project. This version is a total redesign
which makes the framework easier to embed within frameworks such as
Struts and Shale.
</p>
<p>
If you're a casual user, you'll probably only notice the differences
- in the tag libraries. Many of them have been renamed for clarity sake
- and you can upgrade to Tiles2 by simple doing a global find and replace.
+ in the tag libraries and in Tiles definition files. Many of them have
+ been renamed for clarity sake and you can upgrade to Tiles2
+ by simple doing a global find and replace.
</p>
<p>
If you're integrating Tiles into a framework or using it for more advanced
@@ -51,113 +96,67 @@
</p>
</answer>
</faq>
+ <faq id="migrate">
+ <question>How can I migrate from Struts-Tiles?</question>
+ <answer>We have prepared a <a href="migration/index.html">Migration
+ guide</a>.</answer>
+ </faq>
+ <faq id="why-move">
+ <question>Why should I move from Struts-Tiles to Tiles 2?</question>
+ <answer>Tiles 2 can be used outside of Struts: it has been integrated
+ into Struts 1, Struts 2 and Shale. And Tiles 2 is supported by a
+ passionate team.</answer>
+ </faq>
+ <faq id="why-change">
+ <question>Why did you change everything in Tiles 2?</question>
+ <answer>To improve learning of Tiles. After the refactoring, the APIs,
+ the TLD and the DTD are clearer than before.</answer>
+ </faq>
</part>
- <part id="taglib-faq">
- <title>Tiles 2 Taglib</title>
-
- <faq id="insert">
- <question>What happened to <code>&lt;tiles:insert&gt;</code> tag?
- </question>
- <answer>
- <p>The <code>&lt;tiles:insert&gt;</code> has been split
- into three tags:</p>
- <ul>
- <li><code>&lt;tiles:insertTemplate&gt;</code>, to
- insert a template,</li>
- <li><code>&lt;tiles:insertDefinition&gt;</code>, to
- insert a definition,</li>
- <li><code>&lt;tiles:insertAttribute&gt;</code>, to insert an
- attribute (which itself can be a definition, a template, or a string).</li>
- </ul>
- <p>Notice that the <code>type</code> attribute is not present in
- any of these tags: it was removed because the type is implicit
- in tags themselves.</p>
- </answer>
- </faq>
- <faq id="get">
- <question>What happened to <code>&lt;tiles:get&gt;</code> tag?
- </question>
- <answer>
- <p>The <code>&lt;tiles:get&gt;</code> has been removed,
- along with its class GetTag. Use
- <code>&lt;tiles:insert&gt;</code> instead,
- eventually specifiying <code>ignore="true"</code>, that was
- the default in <code>&lt;tiles:get&gt;</code>.
- </p>
- </answer>
- </faq>
- <faq id="get-attribute-tag">
- <question>What happened to <code>GetAttributeTag</code> class?
- </question>
- <answer>
- <p>The <code>GetAttributeTag</code> class has been renamed to
- <code>GetAsStringTag</code> to conform to conventions on tag
- libraries.
- </p>
- </answer>
- </faq>
- <faq id="name">
- <question>What happened to 'attribute' and 'definition'?</question>
- <answer>
- <p>The 'attribute' and 'definition' tag attributes were removed.
- Use 'name' instead.
- </p>
- </answer>
- </faq>
- <faq id="template">
- <question>What happened to 'page' and 'component'?</question>
- <answer>
- <p>The 'page' and 'component' tag attributes were removed.
- Use 'template' instead.
- </p>
- </answer>
- </faq>
- <faq id="bean">
- <question>What happened to beanName, beanProperty and beanScope?
- </question>
- <answer>
- <p>The 'beanName', 'beanProperty', and 'beanScope' tag attributes
- were removed with no replacement. Use EL instead. For example:
- </p>
- <code>&lt;tiles:put name="foo" value="${foo.bar}"/&gt;</code>
- </answer>
- </faq>
- <faq id="put-add-direct">
- <question>What happened to the 'direct' attribute of PutTag and AddTag?
- </question>
- <answer>
- <p>It has been removed since you can specify the "direct"
- inclusion using <code>type="string"</code></p>
- </answer>
- </faq>
- <faq id="controller">
- <question>What happened to controllerUrl and controllerClass and the
- <code>Controller</code> Java class?
- </question>
- <answer>
- <p>The "controller" concept has been replaced with "preparer",
- to avoid confusion with "controller" as in MVC model.
- <code>Controller</code> class has been renamed to
- <code>ViewPreparer</code>, while the attributes have been
- renamed to "preparerUrl" and "preparerClass".</p>
- </answer>
- </faq>
- <faq id="definition-id">
- <question>What happened to the 'id' attribute of DefinitionTag?
- </question>
- <answer>
- <p>TODO - Did this change to 'name'?</p>
- </answer>
- </faq>
- </part>
- <part id="dtd-faq">
- <title>Tiles 2 DTD</title>
- <faq id="todo">
- <question>What happened to ... ?</question>
- <answer>
- <p>TODO
- </p>
- </answer>
- </faq>
+ <part id="technical">
+ <title>Technical questions</title>
+ <faq id="attribute-not-found">
+ <question>I received an ""Attribute 'name' not found." exception. What's that?</question>
+ <answer>
+ <p>Probably you forgot to fill an attribute of a template, or you
+ are forwarding directly to a template page with at least an attribute.</p>
+ <p>Template with attributes cannot be forwarded alone without filling
+ their attributes. Either <a href="tutorial/basic/pages.html">create a
+ definition</a>, or <a href="turorial/advanced/runtime.html">fill
+ manually the attributes in the attribute context</a>.</p>
+ </answer>
+ </faq>
+ <faq id="no-such-definition">
+ <question>I received a NoSuchDefinitionException, but I am sure that the
+ definition is correct. What happened?</question>
+ <answer>Usually it is a problem in loading definitions. See the startup
+ of your application: you'll probably see an exception stack trace. That
+ is the "real" problem.</answer>
+ </faq>
+ <faq id="nested-definitions">
+ <question>Can I have a "definition in a definition"? How can I do it?</question>
+ <answer>Yes. See <a href="tutorial/advanced/nesting-extending.html">Nesting
+ and extending</a>.</answer>
+ </faq>
+ <faq id="pass-thru">
+ <question>I filled an attribute of a template, but it did not get in an
+ inner template. What happened?</question>
+ <answer>
+ <p>Attributes must be filled in the correct template. In other
+ words, there are no "pass-through" attributes, that you fill in the
+ master template and get filled in the inner ones.</p>
+ <p>In this case, usually you have to create a new definition extending
+ from an existing one, fill the attribute in the correct template and
+ assign the new definition as an attribute to the main template.</p>
+ </answer>
+ </faq>
+ <faq id="refresh">
+ <question>How do I refresh a single tile without changing the other ones?</question>
+ <answer>You are getting confused between frames and tiles. Although frames
+ and tiles can be combined, in general tiles are used in place of frames.
+ In this case the server combines all the tiles into a single web page
+ (without any frames), so you can't refresh just one tile. You have to refresh
+ the whole page.</answer>
+ </faq>
</part>
</faqs>