Help:Categories - Revision history

T5 Import: 1 revision: Import of Most Recent Cache of http://www.mediawiki.org/wiki/Help:Contents (AUG 7 1PM EST)

2010-08-07T17:09:35Z

1 revision: Import of Most Recent Cache of http://www.mediawiki.org/wiki/Help:Contents (AUG 7 1PM EST)

T5 Import: Created page with "MediaWiki allows you to categorize pages by appending one or more Category tags to the content text. Adding these tags creates links at the bottom of the article which take you ..."

2010-08-07T02:06:46Z

Created page with "MediaWiki allows you to categorize pages by appending one or more Category tags to the content text. Adding these tags creates links at the bottom of the article which take you ..."

T5 Import: Undo revision 341982 by Jtneill (talk) Most wikis probably won't have a page about MediaWiki

2010-08-06T14:04:36Z

Undo revision 341982 by Jtneill (talk) Most wikis probably won't have a page about MediaWiki

New page

{{PD Help Page}}
MediaWiki allows you to categorize pages and files by appending one or more '''Category''' {{#ifeq:Category|{{ns:category}}||'''({{ns:category}})'''}} tags to the content text. Adding these tags creates links at the bottom of the page that take you to the list of all pages in that category, which makes it easy to browse related articles.

==Add a page to a category==
To add a page or uploaded file to a category, simply edit the page and add the following text (where ''NAME'' is the name of the category you want to add it to).
<nowiki>[[</nowiki>{{ns:category}}:''NAME'']]

Any number of {{ns:category}} tags may be added to the page and the page will be listed in all of them. {{ns:category}} tags can be added wherever you like in the editing text, but they are usually added at the very bottom for the convenience of other editors.

Adding {{ns:category}} tags to categories will make them subcategories. It is a good idea to organize all your categories into a hierarchy with a single top level category.

Spaces and line breaks before categories are ignored, thus
<pre><nowiki>
* A list item
[[Category:Some category]] Some text
</nowiki></pre>
will be rendered the same as
<pre><nowiki>
* A list item Some text
</nowiki></pre>
You will need to manually add a <br /> tag or a line break after the category.

===Sort key===
A ''sort key'' specifies where the page will appear in the category list, and under which letter heading. (By default, the page is sorted under the first letter of its full name ''including its namespace''.) You can add a sort key to a page by adding it inside the {{ns:category}} tag. For example, the tag below will add the page under the heading "S".
<nowiki>[[</nowiki>{{ns:category}}:''NAME''|''SORT'']]

Sort keys are case-sensitive, and a space is also valid. The order of the sections within a category follows the Unicode sort order. The sort key does not change the page title displayed in the category.

==Create a category==
A category can be created the same way as other wiki pages (See [[Help:Starting a new page]]); just add "<code>{{ns:category}}:</code>" before the page title. (Category lists exist even if their description page is not created, but these categories are isolated from others and serve little purpose for organization or navigation.)

It is not possible to rename (move) a category, unlike other wiki pages. It is necessary to create a new category and change the {{ns:category}} tag on every page. The new category will not have the older category's page history, which is undesirable if there are many revisions.

To avoid extra work, try searching within your wiki before creating a new category. The list of all categories can be found in "{{int:specialpages}}" in the "{{lcfirst:{{int:toolbox}}}}" box of the [[Help:Navigation#Sidebar|sidebar]].

===Hidden categories===
The categories that a page is in are normally listed at the bottom of the page. A category can be hidden from these lists by adding "<code><nowiki>__HIDDENCAT__</nowiki></code>" [[Help:Magic words|magic word]] to the category page. (Each user can choose to see them in a separate "{{int:hidden-categories}}" list, by checking "{{int:tog-showhiddencats}}" in the "{{int:prefs-rendering}}" section of [[Special:Preferences]].)

Hidden categories are automatically added to [[:Category:{{mediawiki:hidden-category-category}}]] (specified by [[MediaWiki:Hidden-category-category]]).

Hidden categories are not hidden on category pages ({{bugzilla|15550}})

==Linking to a category==
To create a link to a category, use a leading colon before the category name. (Without this colon, it will add the current page to the category.) To change the link text, write the text inside the link tag after a pipe.
<nowiki>[[</nowiki>:{{ns:category}}:''NAME'']]
<nowiki>[[</nowiki>:{{ns:category}}:''NAME''|''TEXT'']]

For example, to link to "{{ns:category}}:Help", write "<code><nowiki>[[</nowiki>:{{ns:category}}:Help]]</code>", which will result in [[:{{ns:category}}:Help]].

[[Help:Redirects|Redirect pages]] (to categories) must also use the colon, otherwise it will be added to the category instead of redirecting.

{{Languages}}
[[Category:Help|Categories]]

← Older revision	Revision as of 17:09, 7 August 2010
(No difference)

@@ Line 1: / Line 1: @@
-{{PD Help Page}}
+MediaWiki allows you to categorize pages by appending one or more Category tags to the content text.  Adding these tags creates links at the bottom of the article which take you to the list of all pages in that category, which makes it easy to browse related articles.
-==Add a page to a category==
+== How to make a Category ==
-Any number of {{ns:category}} tags may be added to the page and the page will be listed in all of them. {{ns:category}} tags can be added wherever you like in the editing text, but they are usually added at the very bottom for the convenience of other editors.
+A Category will be created when you use that name as a link at the bottom of the page as explained next. It will not show, however, until the first linking page is Saved.  Before that, it will show as an empty link in red; afterwards, it will begin automatically compiling a Contents page of all such linking pages.
-Adding {{ns:category}} tags to categories will make them subcategories. It is a good idea to organize all your categories into a hierarchy with a single top level category.
+You should be even more careful about doing this than adding content pages.  Like content pages, Categories cannot be deleted or renamed, remaining to confuse users browsing the list of Categories.  Before attempting to make a Category, please find the list of all Categories by clicking on "Special pages" in the left sidebar "toolbox" box.  Check the contents of any other category that might suggest the one you had in mind.
-Spaces and line breaks before categories are ignored, thus
+== How to add a page to a Category ==
-===Sort key===
+To add a content page to the listing for a Category, simply put the following at the very bottom of the page you are editing:
-Sort keys are case-sensitive, and a space is also valid. The order of the sections within a category follows the Unicode sort order. The sort key does not change the page title displayed in the category.
+ <nowiki>[[Category:NAME]]</nowiki>
-==Create a category==
+where "NAME" is the name of the Category you want to add it to.  Any number of Category tags may be added to the page -- the page will be listed in all of them.
-It is not possible to rename (move) a category, unlike other wiki pages. It is necessary to create a new category and change the {{ns:category}} tag on every page. The new category will not have the older category's page history, which is undesirable if there are many revisions.
+You can also specify an additional SORT parameter that specifies where the page will appear, alphabetically, within the Category. This is done by using the following markup:
-To avoid extra work, try searching within your wiki before creating a new category. The list of all categories can be found in "{{int:specialpages}}" in the "{{lcfirst:{{int:toolbox}}}}" box of the [[Help:Navigation#Sidebar|sidebar]].
+ <nowiki>[[Category:NAME|SORT]]</nowiki>
-===Hidden categories===
+To add this page to the 'Help' category to be located in the list at 'C' you would use:
-Hidden categories are automatically added to [[:Category:{{mediawiki:hidden-category-category}}]] (specified by [[MediaWiki:Hidden-category-category]]).
+ <nowiki>[[Category:Help|Categories]]</nowiki>
-Hidden categories are not hidden on category pages ({{bugzilla|15550}})
+Without this, the page would be listed under 'H' for 'Help:Categories', instead of under 'C'.  Another example is when you have articles about people that are titled as <code>FirstName LastName</code> but within a particular Category you want them listed as <code>LastName, FirstName</code>.
-==Linking to a category==
+{{Note|the SORT parameter does not affect how the page title is displayed in the Category listing, only how it is ordered in the list.  In the above example, the link to this page at 'C' will still read "Help:Categories".}}
-{{Languages}}
+Another way to sort an article in the correct letter group without using the 'namespace' is:
 [[Category:Help|Categories]]