Categories description

It is possible to add descriptions to categories. This can be specified in XML files with the "categories" root. Each "category" element allows to specify its description, which will be presented in the categories list.

Rules for categories

• You can have as many files for categories description as you want
• You don't need to specify categories descriptions file. If there is no description for a category^[1]
  Because the category only appears in articles
  , the description of the category in the html page for the category will be empty
• If there is a description for a category but no article belongs to this category, the category will not be present^[2]
  There willl be no categories without any article associated with it

Setting a main article for a category

It is possible to set the main aticle for the category by setting thee mainArticle property. For example:

   <categories>
      <category id="general" desc="General informations" mainArticle="article1"/>     
   </categories>

We will have the following html content for the category:

Defining parent categories

It is possible to define a category as a parent category for another one. For example:

   <categories>
      <category id="general" desc="General informations"  mainArticle="article1"/>     
      <category id="general2" desc="General informations 2" >
           <parentCategory id="general" >
      </category>  
   </categories>

We will have the following html content for the general2 category:

And we will have the following html content for the parent general category:

In that case the category is one of the sub-categories of the parent category.

Setting detailed descriptions

It is possible to have more than just a sentence for the description of a category. For example:

   <categories>
      <category id="syntax" desc="Articles about syntax">
   This category deals about the articles syntax.
      </category>
      <category id="structure" desc="Articles about structure"/>
   </categories>

Note that the desc attribute is however always required and will be used when presenting the link to the category in the list of categories page.

Example

The following file specifies two categories with descriptions:

   <categories>
      <category id="syntax" desc="Articles about syntax"/>
      <category id="structure" desc="Articles about structure"/>
   </categories>