The Wiki for Tale 6 is in read-only mode and is available for archival and reference purposes only. Please visit the current Tale 11 Wiki in the meantime.

If you have any issues with this Wiki, please post in #wiki-editing on Discord or contact Brad in-game.

Difference between revisions of "Help:Categories"

From ATITD6
Jump to navigationJump to search
(Undo revision 341982 by Jtneill (talk) Most wikis probably won't have a page about MediaWiki)
 
m (1 revision: Import of Most Recent Cache of http://www.mediawiki.org/wiki/Help:Contents (AUG 7 1PM EST))
 
(One intermediate revision by the same user not shown)
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.
−
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==
+
== How to make 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.
+
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 ==
−
<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 &lt;br /&gt; tag or a line break after the 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:
−
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.
+
<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.
−
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.
+
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:
−
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]]).
+
<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".}}
−
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}}
+
Another way to sort an article in the correct letter group without using the 'namespace' is:
 +
 
 +
<nowiki>[[Category:Help|{{SUBPAGENAME}}]]</nowiki>
 +
 
 +
This is helpful when using templates which include a category tag.
 +
 
 +
 
 +
== Linking to Category Pages ==
 +
 
 +
To create a link within page content, use a leading colon as in
 +
 
 +
<nowiki>[[:Category:NAME]]</nowiki>
 +
 
 +
so that "NAME" is the Category for the link. For example, if the name were "Help" the link would look like [[:Category:Help]]. Without the leading colon, it would be instead blank or red in the text, because there is no such content page linked within that category.
 +
 
 +
If you want to display alternate text for the link, add that after a bar as with other internal links:
 +
 
 +
<nowiki>[[:Category:NAME|TEXT]]</nowiki>
 +
 
 +
The same link to Category:Help as above might show this alternative text: [[:Category:Help|MediaWiki Help Index]]
 +
 
 +
== Categorize Categories==
 +
 
 +
Categories themselves and other uploaded files like images can be categorized like content pages. It is useful to connect the article-categories with categories already in place to establish connections and hierarchies. After saving the article, follow the category links at the end of the page to see if the Category is already in place and if not, categorize them until you connect them with an existing category.
 +
 
 +
==Moving categories==
 +
Categories cannot be easily moved [[Help:Moving a page|like other pages]]. For this reason, category names should be chosen carefully.
 +
 
 +
Those with admin privileges can create the new page, delete the old one, and then change the Category tags in each member of the category (manually or with a bot). However, this loses the page History - not a huge problem when categories are used only for navigation. But when a wiki is structured so that the category pages contain significant amounts of text, this is undesirable.
 +
 
 +
=== Moving with revision history ===
 +
However, category pages ''can'' be moved together with the full revision history, with some effort, by using the [[Special:Export]] and [[Special:Import]] functions.
 +
 
 
[[Category:Help|Categories]]
 
[[Category:Help|Categories]]

Latest revision as of 17:09, 7 August 2010

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.

How to make a Category

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.

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.

How to add a page to a Category

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: 

[[Category:NAME]]

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.

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: 

[[Category:NAME|SORT]]

To add this page to the 'Help' category to be located in the list at 'C' you would use: 

[[Category:Help|Categories]]

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 FirstName LastName but within a particular Category you want them listed as LastName, FirstName.

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".


Another way to sort an article in the correct letter group without using the 'namespace' is: 

[[Category:Help|{{SUBPAGENAME}}]]

This is helpful when using templates which include a category tag.


Linking to Category Pages

To create a link within page content, use a leading colon as in 

[[:Category:NAME]]

so that "NAME" is the Category for the link. For example, if the name were "Help" the link would look like Category:Help. Without the leading colon, it would be instead blank or red in the text, because there is no such content page linked within that category.

If you want to display alternate text for the link, add that after a bar as with other internal links: 

[[:Category:NAME|TEXT]]

The same link to Category:Help as above might show this alternative text: MediaWiki Help Index

Categorize Categories

Categories themselves and other uploaded files like images can be categorized like content pages. It is useful to connect the article-categories with categories already in place to establish connections and hierarchies. After saving the article, follow the category links at the end of the page to see if the Category is already in place and if not, categorize them until you connect them with an existing category.

Moving categories

Categories cannot be easily moved like other pages. For this reason, category names should be chosen carefully.

Those with admin privileges can create the new page, delete the old one, and then change the Category tags in each member of the category (manually or with a bot). However, this loses the page History - not a huge problem when categories are used only for navigation. But when a wiki is structured so that the category pages contain significant amounts of text, this is undesirable.

Moving with revision history

However, category pages can be moved together with the full revision history, with some effort, by using the Special:Export and Special:Import functions.

Retrieved from "http://www.atitd.org/wiki/t6w/index.php?title=Help:Categories&oldid=101"