Confirmed users, Bureaucrats and Sysops emeriti
176
edits
Help:Categories: Difference between revisions
m
added future tense about the Categories Project
m (added future tense about the Categories Project) |
|||
| (23 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
<br /> | <br /> | ||
<big> | <big> | ||
As part of the [[Contribute/Education/Wiki_Working_Group|Wiki Working Group]] goal to revitalize the Mozilla Wiki (WikiMo), we have created this guide on '''Categories'''. | As part of the [[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: | This guide shows how to: | ||
| Line 12: | Line 12: | ||
* [[#How to Use Categories|implement categories]] | * [[#How to Use Categories|implement categories]] | ||
The guide also | The guide will also describe the WWG's [[#Category Changes|Categories Project]], an effort to improve WikiMo information architecture by reviewing existing categories. | ||
</big> | </big> | ||
===Why Categories?=== | ===Why Categories?=== | ||
| Line 34: | Line 34: | ||
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. | 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 | '''If you do not find a similar category or want to add another categorization:''' | ||
<big>To create a category just type</big> | <big>To create a category just type</big> | ||
| Line 47: | Line 48: | ||
<big>'''Please | <big>'''Please do not create categories like this'''</big> | ||
<pre><nowiki>[[</nowiki>Category:Category/Name<nowiki>]]</nowiki></pre> | <pre><nowiki>[[</nowiki>Category:Category/Name<nowiki>]]</nowiki></pre> | ||
| Line 64: | Line 65: | ||
A red category link indicates that its page has not been created. A blue category link indicates that a page for that category exists. | A red category link indicates that its page has not been created. A blue category link indicates that a page for that category exists. | ||
When | ==Using Categories with Templates== | ||
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>[[Template:Spam|Spam]]<nowiki>}}</nowiki> it is automatically filed in <nowiki>[[</nowiki>[https://wiki.mozilla.org/Category:Spam Category:Spam]<nowiki>]]</nowiki>. How? When an editor creates or edits a template, they can add a category to it just like any content page. Once a category has been added to a template, whenever that template is invoked it's member categories are as well. | |||
===How to Add a Category to a Template=== | |||
When creating a template, just include the category within the <nowiki><</nowiki>includeonly<nowiki>></nowiki> tags: | |||
<pre> | |||
<nowiki><</nowiki>includeonly<nowiki>></nowiki> | |||
<nowiki>[[</nowiki>Category:Category_name<nowiki>]]</nowiki> | |||
<nowiki>[[</nowiki>Category:Another_category_name<nowiki>]]</nowiki> | |||
<nowiki><</nowiki>/includeonly<nowiki>></nowiki> | |||
</pre> | |||
==Category Pages== | ==Category Pages== | ||
| Line 75: | Line 89: | ||
Category pages should only include: | Category pages should only include: | ||
;a brief definition | ;a brief definition :What does this category mean? | ||
;its purpose | ;its purpose :Why was this category created? | ||
;an example | ;an example :Provide a link to a page that provides good context of when to implement the category | ||
=How to Add an Existing Category= | =How to Add an Existing Category= | ||
| Line 85: | Line 99: | ||
==Subcategories== | ==Subcategories== | ||
A subcategory is a category belonging to another category. Subcategories are useful when a contributor wants to group pages by an event date. For example, <nowiki>[[</nowiki>Category:Great_Mozilla_Conference<nowiki>]]</nowiki> can be a main category while each event year should be a subcategory. | |||
For example | |||
===How to Create a Subcategory=== | |||
In the edit mode of a main category page, declare a category as you would on a regular content page. Once saved, the main category page will now display its new subcategory and the pages belonging to that subcategory. | |||
=How to Use Categories= | =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 | 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. | ||
==What a Category Should Not Be== | ==What a Category Should Not Be== | ||
Categories are not personal or project pages. | Categories are not personal or project pages. | ||
;'''Please | ;'''Please do not add any user information. Please, do not add specific project information to a category page.''' :[[#Category Page Guidelines|A category page]] should only include a | ||
* brief definition | * brief definition | ||
| Line 102: | Line 117: | ||
;'''Please, do not add categories to user pages.''' :The Verified Users category that lists all WikiMo users is controlled by admins. | ;'''Please, do not add categories to user pages.''' :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. | ;'''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=== | ===What to Do if a Page has been Miscategorized=== | ||
If a page has been miscategorized, tag the page with the '''<nowiki>{{</nowiki> [[Template:Miscategorized|Miscategorized]] <nowiki>}}</nowiki>''' template. With this template, the category will be filed within the [[Template:Miscategorized|Miscategorized]] category for designated admins or bureaucrats to review. | If a page has been miscategorized, tag the page with the '''<nowiki>{{</nowiki>[[Template:Miscategorized|Miscategorized]]<nowiki>}}</nowiki>''' template. With this template, the category will be filed within the [[Template:Miscategorized|Miscategorized]] category for designated admins or bureaucrats to review. | ||