pgsrc/Help%2FCategories

   1 Date: Thu,  9 Dec 2010 14:51:45 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0)
   3 Content-Type: application/x-phpwiki;
   4   pagename=Help%2FCategories;
   5   flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
   6   markup=2;
   7   charset=UTF-8
   8 Content-Transfer-Encoding: binary
   9
  10 **Categories** are a way to group pages that are related to the same subject.
  11 They provide an easy way to browse the wiki.
  12
  13 In Phpwiki, categories are not stored in a separate namespace like in Mediawiki for
  14 instance. A category is a page with a name that begins with "Category" and contains
  15 a call the the [[Help:BackLinksPlugin|BackLinks plugin]].
  16
  17 == Creating a new category ==
  18
  19 The simplest way to create a new category is to to go the
  20 [[:CategoryCategory|CategoryCategory]] page.
  21
  22 Enter its name (starting with "Category") and hit "CreatePage" button.
  23
  24 This will automatically insert the necessary plugins calls.
  25
  26 You might want to add at the beginning of the page a paragraph
  27 explaining the purpose of the category.
  28
  29 Suppose you want to create a category called **~CategoryFruit**.
  30 You might add:
  31 {{{
  32 This Category groups the different kinds of fruit.
  33 }}}
  34
  35 By default, the new category is created as a subcategory of
  36 [[:CategoryCategory|CategoryCategory]] (the "root" category).
  37 You might want to change this (see below "Category hierarchies").
  38
  39 == Putting a page in a category ==
  40
  41 To put the article **banana** in ~CategoryFruit, you have to put at the end of the page:
  42
  43 {{{
  44 ----
  45 [[CategoryFruit]]
  46 }}}
  47
  48 The ~CategoryFruit page will then display your text describing the
  49 purpose of the category, then the list of pages in the category.
  50
  51 The can be done very easily by using the {{/themes/default/images/ed_category.png|[C]}}
  52 button of the edit toolbar when editing the page.
  53
  54 == Category hierarchies ==
  55
  56 The simplest way to use categories is to use "flat" categories. But you
  57 can also build a hierarchy of categories by putting categories themselves
  58 in categories.
  59
  60 For example, you can put the {{{[[CategoryFruit]]}}} in {{{[[CategoryFood]]}}}
  61 instead of default {{{[[CategoryCategory]]}}}.
  62
  63 == Tips and tricks ==
  64
  65 * Page [[:CategoryCategory]] is the root category. All categories should be subcategories of this category (recursively).
  66 * If in a page you need to refer to a category, you should add a semi-colon: {{{[[:CategoryFruit]]}}}. This will create a link to the category //without// putting the page in the category (which would be the case if using {{{[[CategoryFruit]]}}}).
  67 * You can put a page in several categories if needed.
  68
  69 ----
  70 [[PhpWikiDocumentation]]