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<br />
Configuration<br />
Data binding<br />
Framework Integration<br />
Look and Feel<br />
Installation<br />
Performance and Testing<br />
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: <nowiki>http://books.zkoss.org/how tos/components/</nowiki>'''[component name]'''/'''[question/how to title]'''


In the case of the above question the full page URL would be: <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 [[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.

<nowiki>http://books.zkoss.org/how tos</nowiki>/'''[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:

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

=Insert Header and Footer=

<nowiki>{{HowToPageHeader}}</nowiki><br />
TEXT HERE <br />
<nowiki>{{HowToPageFooter}}</nowiki>