Author: sabob
Date: Sun Jul 26 14:01:27 2009
New Revision: 797929
URL: http://svn.apache.org/viewvc?rev=797929&view=rev
Log:
formatting
Modified:
incubator/click/trunk/click/documentation/docs/faq.html
Modified: incubator/click/trunk/click/documentation/docs/faq.html
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/docs/faq.html?rev=797929&r1=797928&r2=797929&view=diff
==============================================================================
--- incubator/click/trunk/click/documentation/docs/faq.html (original)
+++ incubator/click/trunk/click/documentation/docs/faq.html Sun Jul 26 14:01:27 2009
@@ -20,6 +20,7 @@
-->
<html>
<head>
+ <!-- saved from url=(0014)about:internet -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="Author" content="Malcolm Edgar"/>
<meta name="description" lang="en" content="Apache Click Java web application framework"/>
@@ -30,6 +31,7 @@
<style type="text/css">
dt { margin-top:2em; }
dd { margin:1em; margin-left:2em; }
+ dt a { padding-top: 1em; }
</style>
<script type="text/javascript" src="../syntax-highlighter.js"></script>
</head>
@@ -88,8 +90,9 @@
<dl>
- <a name="getting-help" class="heading"></a>
- <dt><b>1. How to get help?</b></dt>
+ <dt><a name="getting-help"></a>
+ <b>1. How to get help?</b>
+ </dt>
<dd>
OK you have read the documentation and reviewed the
<a href="examples.html">Examples</a> applications, but there is still something
@@ -110,10 +113,11 @@
<li><a href="click-online.html#development-mailing-list">click-development</a>
- for Click framework development discussions</li>
</ul>
</dd>
-
- <a name="commercial-support" class="heading"></a>
- <dt><b>2. What about Commercial Support?</b></dt>
+
+ <dt><a name="commercial-support"></a>
+ <b>2. What about Commercial Support?</b>
+ </dt>
<dd>
If you want commercial support or training for Click, you can obtain this
from
@@ -122,9 +126,10 @@
For more details please email <a href="mailto:medgar@avoka.com">Malcolm Edgar</a>.
</dd>
-
- <a name="tool-support" class="heading"></a>
- <dt><b>3. What development tools are there?</b></dt>
+
+ <dt><a name="tool-support"></a>
+ <b>3. What development tools are there?</b>
+ </dt>
<dd>
Recommended Click development tools include:
<p/>
@@ -168,9 +173,10 @@
</ul>
</dd>
-
- <a name="html-control" class="heading"></a>
- <dt><b>4. How can the GUI designer define the HTML if Click Controls
generates everything?</b></dt>
+
+ <dt><a name="html-control"></a>
+ <b>4. How can the GUI designer define the HTML if Click Controls generates
everything?</b>
+ </dt>
<dd>
In Click there is nothing preventing you from laying out HTML forms by hand.
It just provides the option of doing it automatically for you.
@@ -241,16 +247,18 @@
</dd>
- <a name="customize-look-and-feel" class="heading"></a>
- <dt><b>5. How can I customize a control's look and feel (Stylesheet,
JavaScript and other resources)?</b></dt>
+ <dt><a name="customize-look-and-feel"></a>
+ <b>5. How can I customize a control's look and feel (Stylesheet, JavaScript
and other resources)?</b>
+ </dt>
<dd>
See the section <a href="user-guide/html/ch04s03.html#deploying-custom-resources">auto
deployed files</a>
for details on how to customize and override a control's resources.
</dd>
- <a name="shared-template" class="heading"></a>
- <dt><b>6. How can I have many Pages using the same HTML template?</b></dt>
+ <dt><a name="shared-template"></a>
+ <b>6. How can I have many Pages using the same HTML template?</b>
+ </dt>
<dd>
To do this use the Page templating technique detailed in the
<a href="user-guide/html/ch02s06.html">Page Templating</a> topic.
@@ -268,8 +276,9 @@
- <a name="listener-returns" class="heading"></a>
- <dt><b>7. Why do control listeners methods have to return a boolean
value?</b></dt>
+ <dt><a name="listener-returns"></a>
+ <b>7. Why do control listeners methods have to return a boolean value?</b>
+ </dt>
<dd>
Control listener methods have to return a boolean value to state whether the
Pages controls and methods should continue to be processed. To continue
@@ -292,9 +301,9 @@
</dd>
-
- <a name="exclude-fields" class="heading"></a>
- <dt><b>8. Can you exclude some fields from a Form?</b></dt>
+ <dt><a name="exclude-fields"></a>
+ <b>8. Can you exclude some fields from a Form?</b>
+ </dt>
<dd>
To exclude some fields from being displayed in a shared Form class use the
<a href="click-api/org/apache/click/control/Form.html#removeFields(java.util.List)">Form.removeFields()</a>
@@ -310,9 +319,9 @@
</dd>
-
- <a name="localization" class="heading"></a>
- <dt><b>9. How do you internationalize Pages and Controls?</b></dt>
+ <dt><a name="localization"></a>
+ <b>9. How do you internationalize Pages and Controls?</b>
+ </dt>
<dd>
Click provides good support for application localization and
internationalization (I18N) requirements.
@@ -377,8 +386,9 @@
</dd>
- <a name="utf8-encoding" class="heading"></a>
- <dt><b>10. How do you encode Pages in the UTF-8 character set?</b></dt>
+ <dt><a name="utf8-encoding"></a>
+ <b>10. How do you encode Pages in the UTF-8 character set?</b>
+ </dt>
<dd>
To encode pages in the UTF-8 character set you need to create a
<tt>WEB-INF/velocity.properties</tt> file with the properties:
@@ -404,8 +414,9 @@
</dd>
- <a name="charset" class="heading"></a>
- <dt><b>11. How do you specify the character set which is used in
your application?</b></dt>
+ <dt><a name="charset"></a>
+ <b>11. How do you specify the character set which is used in your application?</b>
+ </dt>
<dd>
You can specify your application character set in <tt>WEB-INF/click.xml</tt>:
@@ -424,10 +435,11 @@
See <a href="#utf8-encoding">the previous topic</a>.
</dd>
-
-
- <a name="multiple-posts" class="heading"></a>
- <dt><b>12. How can you prevent multiple form posts?</b></dt>
+
+
+ <dt><a name="multiple-posts"></a>
+ <b>12. How can you prevent multiple form posts?</b>
+ </dt>
<dd>
You can prevent multiple form posts by using the Post Redirect pattern. With
this pattern once the user has posted a form you redirect to another page.
@@ -480,18 +492,20 @@
</dd>
-
- <a name="html-pages"></a>
- <dt><b>13. How can I use *.html Click pages?</b></dt>
+ <dt><a name="html-pages"></a>
+ <b>13. How can I use *.html Click pages?</b>
+ </dt>
<dd>
- Click does not support *.html files as Click pages. These files are not
- processed by the ClickServlet and are intended for use as static content.
+ Click does not automatically map *.html files as Click pages. These files
+ are not processed by the ClickServlet and are intended for use as static content.
+ <p/>
+ However see the FAQ on <a href="#alternative-extension">alternative extensions</a>.
</dd>
-
- <a name="alternative-extension"></a>
- <dt><b>14. Can Click be mapped to an extension other than *.htm?</b></dt>
+ <dt><a name="alternative-extension"></a>
+ <b>14. Can Click be mapped to an extension other than *.htm?</b>
+ </dt>
<dd>
Currently Click only supports *.htm extension. You cannot create templates
with a different extension for example '.xml'.
@@ -506,9 +520,9 @@
</dd>
-
- <a name="cayenne-integration" class="heading"></a>
- <dt><b>15. What JARs should I use with Click and Cayenne?</b></dt>
+ <dt><a name="cayenne-integration"></a>
+ <b>15. What JARs should I use with Click and Cayenne?</b>
+ </dt>
<dd>
To get Click and Cayenne to work happily with each other you will need to
include the following JAR files in your WEB-INF/lib directory:
@@ -523,9 +537,9 @@
</dd>
-
- <a name="spring-integration" class="heading"></a>
- <dt><b>16. How can you integrate Click into Spring?</b></dt>
+ <dt><a name="spring-integration"></a>
+ <b>16. How can you integrate Click into Spring?</b>
+ </dt>
<dd>
To integrate Spring with Click configure the
<a href="extras-api/org/apache/click/extras/spring/SpringClickServlet.html">SpringClickServlet</a>
@@ -551,9 +565,9 @@
</dd>
-
- <a name="jsp-support" class="heading"></a>
- <dt><b>17. Does Click support JSP?</b></dt>
+ <dt><a name="jsp-support"></a>
+ <b>17. Does Click support JSP?</b>
+ </dt>
<dd>
Click fully supports JSP pages.
<p/>
@@ -591,8 +605,9 @@
</dd>
- <a name="pdf-and-excel-rendering" class="heading"></a>
- <dt><b>18. How can I render PDF and Excel documents?</b></dt>
+ <dt><a name="pdf-and-excel-rendering"></a>
+ <b>18. How can I render PDF and Excel documents?</b>
+ </dt>
<dd>
By making use of the <a href="user-guide/html/ch02s07.html">Direct Rendering</a>
support you can render directly to the servlet response and bypass the page
@@ -675,8 +690,9 @@
</dd>
- <a name="performance" class="heading"></a>
- <dt><b>19. What is the performance of Click?</b></dt>
+ <dt><a name="performance"></a>
+ <b>19. What is the performance of Click?</b>
+ </dt>
<dd>
Click is fast.
<p/>
@@ -717,8 +733,9 @@
</dd>
- <a name="unit-testing"></a>
- <dt><b>20. How do I unit test Click pages?</b></dt>
+ <dt><a name="unit-testing"></a>
+ <b>20. How do I unit test Click pages?</b>
+ </dt>
<dd>
It is generally recommended that you don't write JUnit style automated unit
tests for Click pages as the cost to benefit ratio is quite poor.
@@ -733,8 +750,9 @@
</dd>
- <a name="logging" class="heading"></a>
- <dt><b>21. Why doesn't Click use Commons Logging / Log4J for logging?</b></dt>
+ <dt><a name="logging"></a>
+ <b>21. Why doesn't Click use Commons Logging / Log4J for logging?</b>
+ </dt>
<dd>
Click by default does not use Commons Logging / Log4J to avoid the class
loader and configuration issues which often occur with these framework, and
@@ -743,10 +761,11 @@
Click provides support for configurable <tt>LogService</tt>s and provides
<tt>JdkLogService</tt> and <tt>Log4JLogService</tt> classes in
Click Extras.
</dd>
-
- <a name="why-velocity" class="heading"></a>
- <dt><b>22. Why doesn't Click use FreeMarker instead of Velocity as
the default template engine?</b></dt>
+
+ <dt><a name="why-velocity"></a>
+ <b>22. Why doesn't Click use FreeMarker instead of Velocity as the
default template engine?</b>
+ </dt>
<dd>
FreeMarker is a powerful templating engine which was evaluated along side
Velocity for use in Click. While FreeMarker has many sophisticated
@@ -758,8 +777,9 @@
</dd>
- <a name="why-click" class="heading"></a>
- <dt><b>23. Why develop a new Web Application Framework?</b></dt>
+ <dt><a name="why-click"></a>
+ <b>23. Why develop a new Web Application Framework?</b>
+ </dt>
<dd>
Because the existing frameworks did not meet my needs. Struts doesn't really do much,
while Tapestry is too complicated.
@@ -768,7 +788,6 @@
</dd>
-
</dl>
|