<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>HelpOnCategories</title></articleinfo><section><title>Categories</title><para>Categories are an important feature on wikis. Creating a category is easy: you just have to write a category name onto the page and you are done. MoinMoin even simplifies this by letting you choose from a list of available categories while you are editing the page. </para><para>On the page of the category, you can give a brief description of the category's contents. If you want to get a list of all pages in that particular category, either click the title of the category or insert a suitable macro which lists the pages: </para><itemizedlist><listitem><para><code>&lt;&lt;FullSearch(category:CategorySamples)&gt;&gt;</code> lists all pages in the category <code>CategorySamples</code> (alternative you can use <code>&lt;&lt;FullSearchCached(@</code><code>PAGE@)&gt;&gt;</code>) (<code>FullSearchCached</code> caches the search results and therefore displays a category page quicker and also produces less load for the wiki server, for more information please read <ulink url="http://clip.ipipan.waw.pl/HelpOnCategories/HelpOnMacros#">HelpOnMacros</ulink>) </para></listitem><listitem><para><code>&lt;&lt;FullSearch(category:CategoryRecipes -category:CategoryCake)&gt;&gt;</code> lists every recipe if it is not about a cake <inlinemediaobject><imageobject><imagedata depth="16" fileref="http://clip.ipipan.waw.pl/wiki_static/mandarin_clip/img/smile.png" width="16"/></imageobject><textobject><phrase>:-)</phrase></textobject></inlinemediaobject> </para></listitem><listitem><para>See <ulink url="http://clip.ipipan.waw.pl/HelpOnCategories/HelpOnSearching#">HelpOnSearching</ulink> for further information about the syntax. </para></listitem></itemizedlist><para>Normally, categories have to be named like <code>Category</code><code>Something</code>. If you want to allow other patterns like <code>Catégorie</code><code>Gaffeur</code> (that is French by the way), then the administrator needs to change the configuration option <code>page_category_regex</code> according to the users' language, see <ulink url="http://clip.ipipan.waw.pl/HelpOnCategories/HelpOnConfiguration#">HelpOnConfiguration</ulink>. </para><para>The best choice is to create category pages from a <ulink url="http://clip.ipipan.waw.pl/HelpOnCategories/CategoryTemplate#">CategoryTemplate</ulink> (see <ulink url="http://clip.ipipan.waw.pl/HelpOnCategories/HelpOnTemplates#">HelpOnTemplates</ulink>). </para></section></article>