Help:Categories: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
(Created page with "A '''category''' is a software feature of MediaWiki, a special page which is intended to group related pages and media. In practice, it implies that you'll associate a single ...")
 
(Rewritten and extended)
Line 1: Line 1:
A '''category''' is a software feature of MediaWiki, a special page which is intended to group related pages and media. In practice, it implies that you'll associate a single subject with a given category. The category name would be enough to guess the subject, but some extra text can be useful to precisely define it.
Through '''categories''' related pages or files can be grouped together to make it easier to find them. The categories are represented by ''category pages'', pages in the category namespace discerned by page titles beginning with "Category:".


== Quick guide ==
On the category pages the pages in a category are listed, and pages are categorised by links to the category pages which are shown on the bottom of the pages, unless categories are ''hidden categories''. The category pages are themselves categorised and form a network of related categories that can be browsed at the peril of the reader.
# How to find the appropriate categories
#* Find categories with the search engine (see #Categorization tips)
#* or check how similar images are categorized (some may not be categorized though)
#* Starting from these categories, check their parent or sub-categories to find an appropriate category. Avoid picking too general categories.
# Add the categories to the file/image
#* Select them on the upload form
#* or: add them manually by adding, e.g. <code><nowiki>[[Category:Foobar]]</nowiki></code> to the file description page (see #Categorizing_pages)


== How to use categories ==
== Quick guide to categorising ==
You should always put your uploads into categories and/or gallery pages according to topic, so your contributions can be found and used by others.
# Find appropriate categories
#* By searching (see #Categorization tips)
#* By checking how similar pages or images are categorized (though some may not yet have been categorized)
#* Starting a category, check its parent or sub-categories to find an appropriate category. Avoid picking too general categories.
# Add categories to the page or file
#* By selecting them on the upload form or in the wizard
#* By manually adding for example <code><nowiki>[[Category:Foobar]]</nowiki></code> to the page or file description page


=== Category names ===
== Using categories ==
Category names should generally be in English.
Always add pages and uploaded files to categories.  This way they will be easier to find, both by browsing through the categories and by searching, even more so by using external search engines, for example Google search.
 
=== Searching for and browsing categories ===
You can search specifically for categories by using beginning your search string with "Category:".  Note though that the wiki is ''very'' picky about both spelling and, unfortunately, case.  Another way is just search and on the results page tick the Category namespace box and search again.
 
Another way, that sometimes is more effective is to look up an article that logically should have a certain category or a related one and go to the category page from the category link at the bottom of the page, and from there browse the category structure.


=== Categorizing pages ===
=== Categorizing pages ===
To add a page (be it a real article, an image or a category page) to a category, add the following code to the end of the page.  
To add a page (be it an article, an image or any other editable page) to a category, add the following wiki markup to the end of the page, just before the language links to translated pages.
 
<nowiki>[[</nowiki>'''Category:'''Category name<nowiki>]]</nowiki>
 
=== Category sorting ===
Sometimes you want a page to be sorted under a different name on the category page. This can be done using a vertical stroke or pipe and sort key in the category link.
 
<nowiki>[[</nowiki>'''Category:'''Category name<nowiki>|</nowiki>''Sort key''<nowiki>]]</nowiki>
 
For example like below:
 
<nowiki>[[Category:Boeing|707-320]]</nowiki>
 
=== Linking to category pages ===
Linking to category pages can be done like below.  Do note that the category name have to be preceded by a colon.  A regular link will not be shown in the article text, but will add the page to that category.
 
{| class="wikitable" width="100%"
! Description
! width="30%" | What you type
! width="30%" | What you get
|-
| Linking to a category must be done with a preceding colon ('''<nowiki>:</nowiki>''').
|
<nowiki>[[:Category:Help]]</nowiki>
| [[:Category:Help]]
|-
| Links to categories can use a pipe ('''<nowiki>|</nowiki>''') as well.
|
<pre style="white-space: pre-wrap;">See the [[:Category:Help|help]] category.</pre>
| See the [[:Category:Help|help]] category.
|}


'''<nowiki>[[</nowiki>Category:'''''Category Name''''']]'''
== Creating new categories ==
=== Category names ===
Category names should generally be in English, and to the point.  In general a shorter name is preferable, but sometimes being more specific is necessary.  It is also often preferable to not mix articles, images or templates, which can be avoided by through the category name specifying what a category is for.


For information on how to find good categories for your uploads and galleries, read the section ''[[#Find an appropriate category|Find an appropriate category]]'' below.
Category names, as other page names, are except for the initial character case sensitive.  It is therefore often preferable that only the initial character in the category name should be capital, as using the category might be less easy, not to mention searching for it.  When the category is related to a certain subject that have more capitals than only the initial character, for example FGCom, it probably is preferable to use the more common spelling.


=== Creating a new category ===
=== Creating a new category page ===
To create a new category:
To create a new category:
# Do a thorough search, to be sure there isn't an existing category that will serve the purpose.
* By first editing a page
# Find pages or images which should be put in the new category. Edit this page, and at the end insert the new category reference. ''e.g.'' <code><nowiki>[[Category:Title]]</nowiki></code>. Save the edited page. The new category appears as a red link at the bottom of the page.
*# Search for variants of the intended category name, to be sure there isn't an existing category that will serve the purpose.
# Click on that red link. The new, empty, category page appears for editing. You can now edit the category like any other wiki page.
*# Find pages or images which should be put in the new category. Edit one of those pages, and at the end, but before the language links, insert the new category reference, for example <code><nowiki>[[Category:Title]]</nowiki></code>. Save the edited page. The new category appears as a red link at the bottom of the page.
*# Click on that red link. The new, empty, category page appears for editing. You can now edit the category like any other wiki page.
 
* By searching for a page
*# As above search for variants of the intended category name.
*# Click the red link with the page name you searched for to open up an editing window.
 
=== Category page contents ===
<nowiki>{{en|This is an example category.}}
 
[[Category:Examples|Category]]</nowiki>


A category page should contain the following information (in order of importance):
A category page should contain the following information (in order of importance):
*Category-links that put it into one or more parent categories. At the bottom of the new page, insert lines of the form <code><nowiki>[[Category:Relevant categories]]</nowiki></code>.
# Category links that put it into one or more parent categories. At the bottom of the new page.
*A short description text that explains what should be in the category, if the title is not clear or unambiguous enough on its own.
# A short description text that explains what should be in the category, if the title is not clear or unambiguous enough on its own.  Preferably use a [[:Category:Language templates|language template]].
* If the category should be sorted according to a different string than the category title, add a <code><nowiki>{{DEFAULTSORT:}}</nowiki></code>. For instance, the title of a category about a person would not be the right sort string. For such categories, insert after the interwiki links a line like <code><nowiki>{{DEFAULTSORT:Lastname, firstname}}</nowiki></code> with the correct sort string.
# If the category should be sorted according to a different string than the category title, either use category sorting using a sort key or add a <code><nowiki>{{DEFAULTSORT:}}</nowiki></code> magic word. For instance, the title of a category about a person would not be the right sort string. For such categories, insert after the interwiki links a line like <code><nowiki>{{DEFAULTSORT:Lastname, firstname}}</nowiki></code> with the correct sort string.


== Related content ==
== Related content ==

Revision as of 21:11, 20 December 2013

Through categories related pages or files can be grouped together to make it easier to find them. The categories are represented by category pages, pages in the category namespace discerned by page titles beginning with "Category:".

On the category pages the pages in a category are listed, and pages are categorised by links to the category pages which are shown on the bottom of the pages, unless categories are hidden categories. The category pages are themselves categorised and form a network of related categories that can be browsed at the peril of the reader.

Quick guide to categorising

  1. Find appropriate categories
    • By searching (see #Categorization tips)
    • By checking how similar pages or images are categorized (though some may not yet have been categorized)
    • Starting a category, check its parent or sub-categories to find an appropriate category. Avoid picking too general categories.
  2. Add categories to the page or file
    • By selecting them on the upload form or in the wizard
    • By manually adding for example [[Category:Foobar]] to the page or file description page

Using categories

Always add pages and uploaded files to categories. This way they will be easier to find, both by browsing through the categories and by searching, even more so by using external search engines, for example Google search.

Searching for and browsing categories

You can search specifically for categories by using beginning your search string with "Category:". Note though that the wiki is very picky about both spelling and, unfortunately, case. Another way is just search and on the results page tick the Category namespace box and search again.

Another way, that sometimes is more effective is to look up an article that logically should have a certain category or a related one and go to the category page from the category link at the bottom of the page, and from there browse the category structure.

Categorizing pages

To add a page (be it an article, an image or any other editable page) to a category, add the following wiki markup to the end of the page, just before the language links to translated pages.

[[Category:Category name]]

Category sorting

Sometimes you want a page to be sorted under a different name on the category page. This can be done using a vertical stroke or pipe and sort key in the category link.

[[Category:Category name|Sort key]]

For example like below:

[[Category:Boeing|707-320]]

Linking to category pages

Linking to category pages can be done like below. Do note that the category name have to be preceded by a colon. A regular link will not be shown in the article text, but will add the page to that category.

Description What you type What you get
Linking to a category must be done with a preceding colon (:).
[[:Category:Help]]
Category:Help
Links to categories can use a pipe (|) as well.
See the [[:Category:Help|help]] category.
See the help category.

Creating new categories

Category names

Category names should generally be in English, and to the point. In general a shorter name is preferable, but sometimes being more specific is necessary. It is also often preferable to not mix articles, images or templates, which can be avoided by through the category name specifying what a category is for.

Category names, as other page names, are except for the initial character case sensitive. It is therefore often preferable that only the initial character in the category name should be capital, as using the category might be less easy, not to mention searching for it. When the category is related to a certain subject that have more capitals than only the initial character, for example FGCom, it probably is preferable to use the more common spelling.

Creating a new category page

To create a new category:

  • By first editing a page
    1. Search for variants of the intended category name, to be sure there isn't an existing category that will serve the purpose.
    2. Find pages or images which should be put in the new category. Edit one of those pages, and at the end, but before the language links, insert the new category reference, for example [[Category:Title]]. Save the edited page. The new category appears as a red link at the bottom of the page.
    3. Click on that red link. The new, empty, category page appears for editing. You can now edit the category like any other wiki page.
  • By searching for a page
    1. As above search for variants of the intended category name.
    2. Click the red link with the page name you searched for to open up an editing window.

Category page contents

{{en|This is an example category.}}

[[Category:Examples|Category]]

A category page should contain the following information (in order of importance):

  1. Category links that put it into one or more parent categories. At the bottom of the new page.
  2. A short description text that explains what should be in the category, if the title is not clear or unambiguous enough on its own. Preferably use a language template.
  3. If the category should be sorted according to a different string than the category title, either use category sorting using a sort key or add a {{DEFAULTSORT:}} magic word. For instance, the title of a category about a person would not be the right sort string. For such categories, insert after the interwiki links a line like {{DEFAULTSORT:Lastname, firstname}} with the correct sort string.

Related content