How to Write a How To
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
{{HowToPageHeader}}
TEXT HERE
{{HowToPageFooter}}