Help:  Contents | Getting Started | New to BRWiki | Editing BRWiki | Editing BRWiki (advanced) | Communication and Community | Additional Help
The help pages are currently being redesigned so they are more helpful. If you have any comments or are interested in helping out, please see the help team.
Categories provide automatic indexes, that are useful as table of contents. Together with links and templates they structure a project.

[top]Basics


[top]How to include a page in a category


Just link to the category name, in the namespace "Category", ex:

  
and it is done.

[top]Linking to a category


If you want to link to a category without adding your page to it you should use the following link form:

 Category name[/i]]Category name 
Note the extra ":" before "Category"!

[top]Subcategories


Categories themselves can also belong to a category. Such "sub categories" are listed on top of regular articles in the parent category page.
For example you could edit [[Category:Soccer]] and add the link [[Category:Sports]]. The Soccer category would then be a subcategory of the Sports category.

[top]Categories to which a page belongs


Pages, including categories, can belong to more than one category. The categories to which a page belongs are displayed in a fixed location (the bottom of the page for the 'BRWiki' skin), regardless of where in the wikitext they are written.

[top]Creating a new category


Creating a new category works just like creating a new article. Just browse to e.g. http://www.birthright.net/Category:My_new_category and add a description of the category. Then you can start adding pages to it.
When a category has no descriptive text, links to it become Edit (red) links, which makes the category somewhat hard to use. Avoid this by at least having some statement in the category page. Perhaps a one-liner about what kinds of pages that go in it, or a link to a page containing links to many of the pages in the category.

[top]Setting sort keys


Normally, articles are sorted alphabetically in a category page. If you want the article to be positioned by something else, you should use the following link form:
[[Category:My category|sort key]], where sort key is the value to sort by.
For example to add an article called Albert Einstein to the the category "People" and have the article sorted by "Einstein, Albert" ("Einstein" is the first sort key and "Albert" the second), you would type
[[Category:People|Einstein, Albert]].
The sort keys are case sensitive, so
[[Category:My category|Foobar]]
is sorted before
[[Category:My category|foobar]].
  • To make pages inside namespaces (i.e. "Help:", "BRWiki:") sort by the page name rather than "H" and "W", you can use [[Category:My category|{{PAGENAME}}]]. This will keep working even when the page is renamed.

  • To make a page appear at the very top of the listing, prefix a space, i.e. [[Category:My category| {{PAGENAME}}]]


[top]Additional information


[top]Case Sensitivity


For category names the usual rules for case-sensitivity of page names apply: they are case-sensitive beyond the first character. So be aware that you create a new category if the capitalization beyond the first character is not the same.

[top]A category tag in a template; caching problem


A template can contain category tags (often within tags; see Templates). If you use such a template, your page automatically ends up in the category that the template specifies.
However, adding or deleting a category tag in the template does not automatically add or delete pages using the template to the new category pages, until some edit is made in the page that uses the template.
In other words:
  • Category page listings are based on the situation just after the most recent page edits!

Since adding or removing a category or template tag is obviously an edit there is only a complication when a page is indirectly added to or deleted from a category, through a change in a template the page uses.
In order to update a page in such cases, use "action=purge", in a URL like http://www.birthright.net/forumsTemplate:localurl:help: -- template pagenamee

[top]A category name depending on a template or parameter


An attempt to specify a category name depending on a template or parameter does not work and gives odd results, see Cat and Template talk:Cat.
Is this info really up to date? --Mikk 13:21, 29 May 2006 (EDT)

[top]Relation with "What links here"


A category is somewhat like a "What links here" page with regard to the special category links.
However, "What links here" tends to be a by-product of links that are useful anyway (although links may be put with this use in mind), while category links are put specially to produce a category page.
Linking from a test page, user page, etc. to a category is considered to pollute the category, while regular links from such pages showing up in "what links here" is considered harmless.
Category listings are alphabetical, for "What links here" this typically applies for the first part only, for the pages already linking to the given page at the time of the last rebuilding of the link tables in the database.

[top]Applying "What links here" and "Related Changes" to a category


For the "What links here" and "Related Changes" features, only the links in the editable part of the page count, not the links to the pages in the category.

[top]Conventions and project-specific settings


Each page is typically in at least one category. It may be in more, but it may be wise not to put a page in a category and also in a parent of that category. If a category has subcategories, it is to make it more navigable. Having everything from its subcategories clobber the main category makes the subcategories somewhat pointless.
Check the conventions in a project and make yourself familiar with the categories in use before assigning pages and subcategories to categories and before creating new categories.

[top]See Also





Tags for this Page

Bookmarks

Posting Permissions

Posting Permissions
  • You may not create new articles
  • You may not edit articles
  • You may not protect articles
  • You may not post comments
  • You may not post attachments
  • You may not edit your comments
BIRTHRIGHT, DUNGEONS & DRAGONS, D&D, the BIRTHRIGHT logo, and the D&D logo are trademarks owned by Wizards of the Coast, Inc., a subsidiary of Hasbro, Inc., and are used by permission. ©2002-2010 Wizards of the Coast, Inc.