[phpwiki-checkins] SF.net SVN: phpwiki:[7174] trunk/pgsrc

[<var...@us...>]

Revision: 7174
          http://phpwiki.svn.sourceforge.net/phpwiki/?rev=7174&view=rev
Author:   vargenau
Date:     2009-10-02 10:13:06 +0000 (Fri, 02 Oct 2009)

Log Message:
-----------
New Help page about categories

Modified Paths:
--------------
    trunk/pgsrc/PhpWikiManual

Added Paths:
-----------
    trunk/pgsrc/Help%2FCategories

Added: trunk/pgsrc/Help%2FCategories
===================================================================
--- trunk/pgsrc/Help%2FCategories	                        (rev 0)
+++ trunk/pgsrc/Help%2FCategories	2009-10-02 10:13:06 UTC (rev 7174)
@@ -0,0 +1,71 @@
+Date: Fri,  2 Oct 2009 12:11:25 +0000
+Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124)
+X-Rcs-Id: $Id: Help%2FInterWiki 7173 2009-10-02 08:43:48Z vargenau $
+Content-Type: application/x-phpwiki;
+  pagename=Help%2FCategories;
+  flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
+  markup=2;
+  charset=UTF-8
+Content-Transfer-Encoding: binary
+
+**Categories** are a way to group pages that are related to the same subject.
+They provide an easy way to browse the wiki.
+
+In Phpwiki, categories are not stored in a separate namespace like in Mediawiki for
+instance. A category is a page with a name that begins with "Category" and contains
+a call the the [[Help:BackLinksPlugin|BackLinks plugin]].
+
+== Creating a new category
+
+The simplest way to create a new category is to to go the 
+[[:CategoryCategory|CategoryCategory]] page.
+
+Enter its name (starting with "Category") and hit "CreatePage" button.
+
+This will automatically insert the necessary plugins calls.
+
+You might want to add at the beginning of the page a paragraph
+explaining the purpose of the category.
+
+Suppose you want to create a category called **~CategoryFruit**.
+You might add:
+{{{
+This Category groups the different kinds of fruit.
+}}}
+
+By default, the new category is created as a subcategory of
+[[:CategoryCategory|CategoryCategory]] (the "root" category).
+You might want to change this (see below "Category hierarchies").
+
+== Putting a page in a category
+
+To put the article **banana** in ~CategoryFruit, you have to put at the end of the page:
+
+{{{
+----
+[[CategoryFruit]]
+}}}
+
+The ~CategoryFruit page will then display your text describing the
+purpose of the category, then the list of pages in the category.
+
+The can be done very easily by using the {{/themes/default/images/ed_category.png|[C]}}
+button of the edit toolbar when editing the page.
+
+== Category hierarchies
+
+The simplest way to use categories is to use "flat" categories. But you
+can also build a hierarchy of categories by putting categories themselves
+in categories.
+
+For example, you can put the {{{[[CategoryFruit]]}}} in {{{[[CategoryFood]]}}}
+instead of default {{{[[CategoryCategory]]}}}.
+
+== Tips and tricks
+
+* Page [[:CategoryCategory]] is the root category. All categories should be subcategories of this category (recursively).
+* 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]]}}}).
+* You can put a page in several categories if needed.
+
+----
+[[PhpWikiDocumentation]]

Modified: trunk/pgsrc/PhpWikiManual
===================================================================
--- trunk/pgsrc/PhpWikiManual	2009-10-02 08:43:48 UTC (rev 7173)
+++ trunk/pgsrc/PhpWikiManual	2009-10-02 10:13:06 UTC (rev 7174)
@@ -1,4 +1,4 @@
-Date: Wed, 10 Jun 2009 16:30:14 +0000
+Date: Fri,  2 Oct 2009 12:11:25 +0000
 Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124)
 X-Rcs-Id: $Id$
 Content-Type: application/x-phpwiki;
@@ -16,6 +16,7 @@
 <<IncludePage page="Help/GoodStyle">>
 <<IncludePage page="Help/GoogleLink">>
 <<IncludePage page="Help/HowToUseWiki">>
+<<IncludePage page="Help/Categories">>
 <<IncludePage page="Help/InterWiki">>
 <<IncludePage page="Help/LinkIcons">>
 <<IncludePage page="Help/ActionPage">>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.