phpwiki-talk

[Phpwiki-talk] how to use categories?

[Roel V. <rva...@ri...>]

Hi all,

While looking for documentation on the phpwiki site I noticed that there
seems to be a concept of categories - how do I use these? How do I
create one, and how do I add pages to a category? Is there a standard
way to get a list of all categories? And from what version on does this
work? Thanks!

cheers,

roel

Re: [Phpwiki-talk] how to use categories?

[Adam S. <ad...@pe...>]

> While looking for documentation on the phpwiki site I noticed that there
> seems to be a concept of categories - how do I use these? How do I
> create one, and how do I add pages to a category? Is there a standard
> way to get a list of all categories? And from what version on does this
> work? Thanks!

Hey Roel,

Categories are just just another wikipage.  However by using them in a
certain way you can take advantage of a wiki's features to automatically
document and categorize your pages.

The standard "wiki way" of adding a page to a category is to put:

----
CategoryWhatever

at the bottom of the page where "Whatever" is the name of the category
that it belongs to.  Now when you go to the CategoryWhatever page it
does a full text search for all pages which belong to CategoryWhatever. 
Typically the Category* pages belong to a category called
CategoryCategory which will list all the known category pages for you.

Make sense?

There are some minor alternatives.  My favorite is to take advantage of
InterWiki links and mark pages as belonging to categories by having a
link at the bottom of a page like this:

----
Category:Whatever

the advantage of that is that it stops the CategoryWhatever page from
referencing pages which mention CategoryWhatever without actually
belonging to it.

The only problem is that the current backlinks method doesn't work on
the CategoryWhatever page because there isn't a page called
Category:Whatever and the FullTextSearch displays all the matching lines
from the page which makes for a rather cluttered display.

The solution would to either allow the BackLinks plugin to accept an
arbitrary page name to search for or to have an option to the
FullTextSearch to only return matching page names, not page contents. 
Neither should be hard to do but I haven't gotten to either of them yet.

Adasm.

Re: [Phpwiki-talk] how to use categories?

[Steve W. <sw...@pa...>]

Hmm... since we have InterWiki linking, we could try adding pages to the 
default installation that point to pages in the c2.com Wiki.

http://c2.com/cgi/wiki?WikiCategories gives a rather obtuse explanation 
of Categories. (I think WikiBadges is another term here).

Simply put, if you want to add a page to a category you put CategoryFoo 
at the bottom of the page to add it to the Foo category.

If CategoryFoo didn't exist, the first time you follow the link you can 
create a page for it.

To me, category link/pages, and the idea of DocumentMode versus 
ThreadMode are two fundamental concepts to effective Wiki use.

~swain

Roel Vanhout wrote:
> Hi all,
> 
> While looking for documentation on the phpwiki site I noticed that there
> seems to be a concept of categories - how do I use these? How do I
> create one, and how do I add pages to a category? Is there a standard
> way to get a list of all categories? And from what version on does this
> work? Thanks!
> 
> cheers,
> 
> roel
> 
> 
> 
> 
> _______________________________________________
> Phpwiki-talk mailing list
> Php...@li...
> https://lists.sourceforge.net/lists/listinfo/phpwiki-talk
> 
> 
> 
> 

Re: [Phpwiki-talk] how to use categories? (with small attachment)

[Marcel v. d. B. <ma...@hs...>]

We use categories with the Category:Categoryname syntax  and the 
FullTextSearch plugin to generate pages with the pages which belong to a 
certain category.  For us we made a little change to the FullTextSearch 
plugin (which is attached)

So what we do is:

1.  At the bottom of a page we include the text Category:CategoryName 
which is linked as per the configuration in the interwiki.map file (we 
let it link to a page called "CategoryCategoryName")
2. On the page "CategoryCategoryName"  we include the following:

--snip--
This page contains a list of documents in the Category:CategoryName 
category:

<?plugin FullTextSearch s="Category:CategoryName" noheader=1 onlytitle=1 
?>  

or

<?plugin FullTextSearch s="Category:Development -Category:Category" 
noheader=1 onlytitle=1 ?>

The latter will not show the main Category page which lists all categories.

The "onlytitle" parameter is the one we added to the plugin: if set to 1 
the plugin only returns the names of the pages and not the text found in 
the page itself.  I've attached the modified plugin. As this was a very 
simple and quick hack to the module I don't know if this is of general 
interest to include in the distribution, but here it 's attached.

We also have a Category:Empty page which lists all the non-categorized 
pages. In this case the plugin like looks like:

<?plugin FullTextSearch s="-Category:" noheader=1 onlytitle=1 ?>

Notice the minus sign? This will give a list of pages NOT containing the 
string "Category:"

Marcel

Roel Vanhout wrote:

>Hi all,
>
>While looking for documentation on the phpwiki site I noticed that there
>seems to be a concept of categories - how do I use these? How do I
>create one, and how do I add pages to a category? Is there a standard
>way to get a list of all categories? And from what version on does this
>work? Thanks!
>
>cheers,
>
>roel
>
>
>
>
>_______________________________________________
>Phpwiki-talk mailing list
>Php...@li...
>https://lists.sourceforge.net/lists/listinfo/phpwiki-talk
>

-- 
Marcel van der Boom
HS-Development BV
Kwartiersedijk 14B
Fijnaart, The Netherlands
Tel. : 0168-468822
Fax. : 0168-468823
Email: ma...@hs...

Re: [Phpwiki-talk] how to use categories? (with small attachment)

[Adam S. <ad...@pe...>]

Can this patch or an equivalent of it be committed to CVS?

Adam.

On Fri, 2002-02-22 at 02:56, Marcel van der Boom wrote:
> We use categories with the Category:Categoryname syntax  and the 
> FullTextSearch plugin to generate pages with the pages which belong to a 
> certain category.  For us we made a little change to the FullTextSearch 
> plugin (which is attached)
> 
> So what we do is:
> 
> 1.  At the bottom of a page we include the text Category:CategoryName 
> which is linked as per the configuration in the interwiki.map file (we 
> let it link to a page called "CategoryCategoryName")
> 2. On the page "CategoryCategoryName"  we include the following:
> 
> --snip--
> This page contains a list of documents in the Category:CategoryName 
> category:
> 
> <?plugin FullTextSearch s="Category:CategoryName" noheader=1 onlytitle=1 
> ?>  
> 
> or
> 
> <?plugin FullTextSearch s="Category:Development -Category:Category" 
> noheader=1 onlytitle=1 ?>
> 
> The latter will not show the main Category page which lists all categories.
> 
> The "onlytitle" parameter is the one we added to the plugin: if set to 1 
> the plugin only returns the names of the pages and not the text found in 
> the page itself.  I've attached the modified plugin. As this was a very 
> simple and quick hack to the module I don't know if this is of general 
> interest to include in the distribution, but here it 's attached.
> 
> We also have a Category:Empty page which lists all the non-categorized 
> pages. In this case the plugin like looks like:
> 
> <?plugin FullTextSearch s="-Category:" noheader=1 onlytitle=1 ?>
> 
> Notice the minus sign? This will give a list of pages NOT containing the 
> string "Category:"
> 
> Marcel
> 
> Roel Vanhout wrote:
> 
> >Hi all,
> >
> >While looking for documentation on the phpwiki site I noticed that there
> >seems to be a concept of categories - how do I use these? How do I
> >create one, and how do I add pages to a category? Is there a standard
> >way to get a list of all categories? And from what version on does this
> >work? Thanks!
> >
> >cheers,
> >
> >roel
> >
> >
> >
> >
> >_______________________________________________
> >Phpwiki-talk mailing list
> >Php...@li...
> >https://lists.sourceforge.net/lists/listinfo/phpwiki-talk
> >
> 
> -- 
> Marcel van der Boom
> HS-Development BV
> Kwartiersedijk 14B
> Fijnaart, The Netherlands
> Tel. : 0168-468822
> Fax. : 0168-468823
> Email: ma...@hs...
> 
> 
>