How to Write a How To"

From Documentation
Line 40: Line 40:
  
  
<nowiki>http://books.zkoss.org/how tos/components/'''[component name]'''/'''[question/how to title]'''</nowiki>
+
<nowiki>http://books.zkoss.org/how tos/components/</nowiki>'''[component name]'''/'''[question/how to title]'''
  
  
Line 46: Line 46:
  
  
<nowiki>'''http://books.zkoss.org/how tos/components/grid/How do I support huge data in a Grid'''</nowiki>
+
<nowiki>http://books.zkoss.org/how tos/components/grid/How do I support huge data in a Grid</nowiki>
  
 
Now all that is required is to edit and create the page. For details on formatting your page please take a look at the wiki formatting instructions. For more information on ZK wiki specific formatting options, such as for source code snippets please follow the [[How_to_Use_ZK's_Book_Wiki | ZK Book Cheatsheet]].
 
Now all that is required is to edit and create the page. For details on formatting your page please take a look at the wiki formatting instructions. For more information on ZK wiki specific formatting options, such as for source code snippets please follow the [[How_to_Use_ZK's_Book_Wiki | ZK Book Cheatsheet]].

Revision as of 02:23, 20 April 2010

Think of a title

Choose a title for your how-to. It can be anything but should be in the form of a question. For example:

How do I implement the MVC pattern using ZK

On the wiki there is no need to put a ‘?’ at the end.


Pick a category for your How-To

We have made some categories below. Please choose a category which best fits your How-To.

Components Configuration Data binding Framework Integration Look and Feel Installation Performance and Testing Sample applications


Creating the relevant page

Creating the page is an easy task. However it does depend on which category you chose.


If you chose the “Components” category

To create the page when selecting the Components category you are required to sub categorize by the component name. For example if I wanted to use the question:

How do I support huge data in a Grid

And I chose the category “Components” I would then have to sub categorize by component name; In this case “Grid.”

Creating the page then is a simple task, the page URL follows this structure:


http://books.zkoss.org/how tos/components/[component name]/[question/how to title]


In the case of the above question the full page URL would be:


http://books.zkoss.org/how tos/components/grid/How do I support huge data in a Grid

Now all that is required is to edit and create the page. For details on formatting your page please take a look at the wiki formatting instructions. For more information on ZK wiki specific formatting options, such as for source code snippets please follow the ZK Book Cheatsheet.

If you chose any category except for “Components”

If you chose a category other than the component category then creating a page is an easier affair. The following is the URL structure.

http://books.zkoss.org/how tos/[category]/[question/how to title]

Therefore if you want to use the title and:

How do I install ZK into Tomcat

And chose “Installation” as the category name, the subsequent page URL would be:

http://books.zkoss.org/how tos/installation/How do I install ZK into Tomcat

Insert Header and Footer

Template:HowToPageHeader TEXT HERE Template:HowToPageFooter