Confirmed users, Bureaucrats and Sysops emeriti
176
edits
Help:Categories: Difference between revisions
Added the first draft of the guide into the editor
(Added Intro section to Help:Categories) |
(Added the first draft of the guide into the editor) |
||
| Line 2: | Line 2: | ||
<br /> | <br /> | ||
<big> | <big> | ||
As part of the [https://wiki.mozilla.org/Contribute/Education/Wiki_Working_Group Wiki Working Group's] goal to revitalize the Mozilla Wiki (WikiMo), we have created this guide on '''Categories'''. This guide shows how to: | As part of the [https://wiki.mozilla.org/Contribute/Education/Wiki_Working_Group Wiki Working Group's] goal to revitalize the Mozilla Wiki (WikiMo), we have created this guide on '''Categories'''. | ||
</big> | |||
This guide shows how to: | |||
* [[#How to Create a Category|create a category]] | * [[#How to Create a Category|create a category]] | ||
| Line 11: | Line 13: | ||
The guide also describes the WWG's [[#Category Changes|Categories Project]], an effort to improve the wiki's information architecture by reviewing existing categories. | The guide also describes the WWG's [[#Category Changes|Categories Project]], an effort to improve the wiki's information architecture by reviewing existing categories. | ||
===Why Categories?=== | ===Why Categories?=== | ||
There is a lot of information on WikiMo, much of it admittedly not easy to find. Categories are the prime way to make WikiMo more searchable. | There is a lot of information on WikiMo, much of it admittedly not easy to find. Categories are the prime way to make WikiMo more searchable. | ||
===What are Categories?=== | |||
Categories are essentially tags added to pages. These tags organize information on Mozilla Wiki. Unlike [https://wiki.mozilla.org/Help:Tips_and_Tricks#The_Deal_on_Namespaces Namespaces], categories can be created by WikiMo users. They look like this in wikitext: | |||
<nowiki>[[</nowiki>Category:Category_Name<nowiki>[[</nowiki> or <nowiki>[[</nowiki>Category:Category_Name<nowiki>]]</nowiki>. In read mode, categories are displayed at the bottom of the page | |||
[image:Category_banner_example.png]. | |||
A red category link indicates that its page has not been created. A blue category link indicates that a page for that category exists. | |||
Categories are most powerful when included within templates. Let's look at the Spam template as an example. When a page is flagged with the spam template <nowiki>{{</nowiki>spam<nowiki>}}</nowiki>, that page is automatically filed in the Spam category because it is written within the template. When you create a template, include the category within the <nowiki><includeonly></nowiki> tags <nowiki>[[</nowiki>Category:Category_name<nowiki>]]</nowiki>. | |||
If you want to add another category or a category that doesn't need a template just add </nowiki>[[Category:Category_name]]</nowiki> to the page. | |||
In both instances, a Category page will be generated. Search for it and save it. Describe the category and its function. | |||
==How to Create a Category== | |||
[Need to troubleshoot this because 1) Categories are not named correctly 2) Most existing categories are unusable] First: do you need to create one? Sometimes a category very similar to the one you are about to create already exists. Search Special:Categories for similar categories. | |||
If you do not find a similar category or still want to give a page a more specific label: | |||
To create a category just type <nowiki>[[</nowiki>Category:Category_name<nowiki>]]</nowiki> or <nowiki>[[</nowiki>Category:Category_Name<nowiki>]]</nowiki> at the end of the wiki page you are editing. | |||
;'''Please do not create categories like this: :<nowiki>[[</nowiki>Category:Category/Name<nowiki>]]</nowiki>''' | |||
;'''Please do not create categories like this: :<nowiki>[[</nowiki>Category:Category:Name<nowiki>]]</nowiki>''' | |||
''''Category names that are incorrect will be changed to the appropriate format'''' | |||
Under Special:Categories you will be able to find your new category. It will be in red text, meaning a path to that link exists but a page has not been saved. Go to the link and '''write a brief summary defining the category'''. | |||
===How to Add an Existing Category=== | |||
To add an existing page, just go to Edit at the top of the wiki page, and add [Category:Category_name] to the end of the page within the wikiText editor. | |||
==Subcategories== | |||
Categories themselves can also be specified to belong to another category. When displaying the page of a category to which other categories belong, a separate automatically generated, alphabetical list of subcategories is also produced. | |||
For example you could edit <nowiki>[[</nowiki>Category:Soccer<nowiki>]]</nowiki> and add the link <nowiki>[[</nowiwki>Category:Sports<nowiki>]]</nowiki>. The Soccer category is now a subcategory of the Sports category. | |||
==How to Use Categories== | |||
It seems obvious: add as many categories to a page as the content allows. However, sometimes it is not clear if a project is still being documented on WikiMo or [something else]. | |||
==What a Category Should Not Be== | |||
Categories are not personal pages. | |||
;'''Please, do not add any user information to a category.''' | |||
;'''Please, do not add user pages to any category.''' :The Verified Users category that lists all WikiMo users is controlled by admins. | |||
;'''Categories that are date specific should be subcategories.''' :For a category about an event, for example <nowiki>[[<nowiki>Category:Opensource_conference<nowiki>]]</nowiki>, if you want to separate the event years, create a subcategory. We are deprecating/merging categories that include a specific date. For example, Fosdem 2008 and Fosdem 2009 will become Fosdem. | |||
===What to Do if a Page has been Miscategorized=== | |||
If a page has been miscategorized, tag the page with the '''<nowiki>{{</nowiki>[https://wiki.mozilla.org/Templates:Miscategorized Miscategorized]<nowiki>}}</nowiki>''' template. With this template, the category will be filed within the Miscategorized category for designated admins or bureaucrats to review. | |||