click-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sa...@apache.org
Subject svn commit: r797929 - /incubator/click/trunk/click/documentation/docs/faq.html
Date Sun, 26 Jul 2009 14:01:27 GMT
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.&nbsp; How to get help?</b></dt>
+  <dt><a name="getting-help"></a>
+      <b>1.&nbsp; 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.&nbsp; What about Commercial Support?</b></dt>
+
+  <dt><a name="commercial-support"></a>
+      <b>2.&nbsp; 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.&nbsp; What development tools are there?</b></dt>
+
+  <dt><a name="tool-support"></a>
+      <b>3.&nbsp; 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.&nbsp; How can the GUI designer define the HTML if Click Controls
generates everything?</b></dt>
+
+  <dt><a name="html-control"></a>
+      <b>4.&nbsp; 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.&nbsp; 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.&nbsp; 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.&nbsp; How can I have many Pages using the same HTML template?</b></dt>
+  <dt><a name="shared-template"></a>
+      <b>6.&nbsp; 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.&nbsp; Why do control listeners methods have to return a boolean
value?</b></dt>
+  <dt><a name="listener-returns"></a>
+      <b>7.&nbsp; 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.&nbsp; Can you exclude some fields from a Form?</b></dt>
+  <dt><a name="exclude-fields"></a>
+      <b>8.&nbsp; 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.&nbsp; How do you internationalize Pages and Controls?</b></dt>
+  <dt><a name="localization"></a>
+      <b>9.&nbsp; 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.&nbsp; How do you encode Pages in the UTF-8 character set?</b></dt>
+  <dt><a name="utf8-encoding"></a>
+      <b>10.&nbsp; 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.&nbsp; How do you specify the character set which is used in
your application?</b></dt>
+  <dt><a name="charset"></a>
+      <b>11.&nbsp; 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.&nbsp; How can you prevent multiple form posts?</b></dt>
+
+
+  <dt><a name="multiple-posts"></a>
+      <b>12.&nbsp; 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.&nbsp; How can I use *.html Click pages?</b></dt>
+  <dt><a name="html-pages"></a>
+      <b>13.&nbsp; 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.&nbsp; Can Click be mapped to an extension other than *.htm?</b></dt>
+  <dt><a name="alternative-extension"></a>
+      <b>14.&nbsp; 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.&nbsp; What JARs should I use with Click and Cayenne?</b></dt>
+  <dt><a name="cayenne-integration"></a>
+      <b>15.&nbsp; 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.&nbsp; How can you integrate Click into Spring?</b></dt>
+  <dt><a name="spring-integration"></a>
+      <b>16.&nbsp; 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.&nbsp; Does Click support JSP?</b></dt>
+  <dt><a name="jsp-support"></a>
+      <b>17.&nbsp; 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.&nbsp; How can I render PDF and Excel documents?</b></dt>
+  <dt><a name="pdf-and-excel-rendering"></a>
+      <b>18.&nbsp; 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.&nbsp; What is the performance of Click?</b></dt>
+  <dt><a name="performance"></a>
+      <b>19.&nbsp; 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.&nbsp; How do I unit test Click pages?</b></dt>
+  <dt><a name="unit-testing"></a>
+      <b>20.&nbsp; 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.&nbsp; Why doesn't Click use Commons Logging / Log4J for logging?</b></dt>
+  <dt><a name="logging"></a>
+      <b>21.&nbsp; 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.&nbsp; Why doesn't Click use FreeMarker instead of Velocity as
the default template engine?</b></dt>
+
+  <dt><a name="why-velocity"></a>
+      <b>22.&nbsp; 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.&nbsp; Why develop a new Web Application Framework?</b></dt>
+  <dt><a name="why-click"></a>
+      <b>23.&nbsp; 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>
 
 



Mime
View raw message