Help:Categeries
 |
Myndin: Whan ye eedit this page, ye agree tae release yer contreebution unner the CC0. See The Publeec Domain Heelp Pages fer mair info. | |
Categeries, ae saffware featur o MediaWiki, provide autæmateec indexes that's uissfu aes buirds o contents.
Ye can categerise pages n files bi eikin yin or mair Categery tags til the content tex. Thir tags cræft airtins at the bottom o the page that tak ye til the leet o aw pages in that categerie, this maks it easie tae brouse sib airticles.
Ootline
Ilka page in the Category(Catergerie) namespace represents ae sae-cried categerie, ae groopin o sib pages, n contains aen index fer the pages o its categerie. Fer example, this page belangs til "Category:Help". Gif ye apen the categerie page, ye'll see aen airtin til this page thaur.
Whan ae page belangs til yin or mair categeries, thir categeries kith at the bottom o the page (or in the upper-richt corner, dependin oan the skin bein uised).
The categerie pages thairsels contain 2 pairts:
- at thair beginnin, aen optional pairt micht haud tex that can be eeditit, like onie ither page,
- at thair end, aen ever presant, autæmateeclie generated, alphabeteecal leet o aw pages in that categerie, in the form o airtins. In fact, in ASCII order.
Tae assign ae categerie til ae page, simplie eik the airtin "[[Category:Categerie name]]" til the page's wikitex. The uissual steid tae eik it is at the bottom o the page.
Tae airt ae categerie page wiin ae page aes ae normal wiki airtin (wioot eikin the page til the categerie), prefix the link name with ae colon. Fer example: [[:Category:Not in this category]]
New categeries can be cræftit afore assignin onie page til it, in the same waa aes onie ither raigulair page.
Indiveedual wikis micht hae thair ain tap-level categeries, like Category:Contents in Wikipædia.
Fer ae compleate leet o aw categeries that hae at least the ae page, see Special:Categeries.
Fer ae compleate leet o aw cræftit/eeditit categeries, incluidin the yins that dinna hae onie pages, see Special:Allpages/Category: (mynd the colon at the end).
Eikin ae page til ae categerie
Tae eik ae page or uplaidit file til ae categerie, simplie eedit the page n eik the follaein tex (whaur Name is the name o the categerie that ye want tae eik it til).
[[Category:Name]]
Onie nummer o Category tags can be eikit til the page n the page will be leetit in aw o thaim. Category tags, alang wi interwiki leid airtins steidit in the sidebaur, ar uissuallie eikit at the ver bottom o the page fer the conveeeneeance o ither eediters.
Oan ae categerised page, categeries ar displeyed in the Categories: kist strictlie in the order that thay kith in the wikitex.
Gif $wgUseCategoryBrowser is set til true, unner the first leet ilka categerie is leetit again, breadcrumb-style, wi aw its pairant categeries, sorted alphabeteeclie. (At least in MediaWiki 1.18.2) gif ae categerie is ae subcategerie o mair than the ae pairant, than baith hierarchies will be leetit, bit the tagged categerie will be stript aff af aw bit yin o thir. This cræfts the potential fer whit seem tae be dupleecate entries gif ae category wi monie pairants n yin o its pairants ar baith tagged oan ae page. Fer example suppose that Maryanne is ae subcategerie o baith Mary n Anne. Gif ae page tags categeries Maryanne n Anne than the Categerie breadcrumbs will shaw
Anne Anne Mary -> Maryanne
"Anne" seems tae be dupleecatie, bit what is meant is
Anne Anne -> Maryanne Mary -> Maryanne
This is proabablie ae bug, n haes been reporti in phab:T35614.
Sort key
Bi defaut, ae page is sortit wiin ae categerie unner the first letter o its name — wioot the namespace.
Foreby, MediaWiki groops accented characters separatelie fae thair onaccented version, sae that pages stairtin wi À, Á, Ä, wi be leetit unner separate heidins, in steid o unner heidin A.
(Giff ye hae shell access, thir defauts can be chynged uisin $wgCategoryCollation.)
Ae sort key speceefies unner whit letter heidin, n whaur in the categerie leet, the page will kith. Ye can add ae sort key bi placin it inside the tag efter ae pipe chairacter. Fer example, the tag ablo will eik the page unner the heidin "S".
There are two ways in which you can customise the category sortkey:
- Generically, for all categories, by adding the DEFAULTSORT magic word on the page.
- On an individual 'per category' basis, by placing the value inside the tag after a pipe character. For example, the tag below will add the page under heading "S".
[[Category:Name|Sort]]
Whether or not sort keys are case-sensitive depends on your configuration settings. The order o the sections wiin ae categerie follaes the Unicode sort order. The sort key disna chynge the page title displeyed in the categerie.
Spaces and other characters are perfectly valid.
Cræftin ae categerie page
Categeries exeest even gif thair page haes na been cræftit, bit thir categeries ar isolatit fae ithers n dinna serve muckle purpose fer organisation or naveegation.
Ae categerie is cræftit bi cræftin ae page in the Category: namespace. Ae categerie page can be cræftit the same waa aes ither wiki pages (see Help:Stairtin ae new page); jist eik "Category:" afore the page title.
Tae avoid extra wairk, ettle rakin wiin yer wiki afore cræftin ae new categerie. The leet o aw categeries can be foond in "Byordinar pages" in the "tuilkist" kist o the sidebaur.
Managin the categerie hierarchie
Categeries micht belang til ither categeries in ae hierarchie. Sin categerie pages ar ae lot like onie ither page, ae Category tag can be eikit til the bottom o ae categerie page.
It's ae guid idea tae organize aw categeries intil ae hierarchie wi the ae tap level categerie. The categerie structure can tak the form o ae tree wi separate brainches, bit mair aften thay'll hae ae graph structur. Generallie, thaur shid be ae conteenueess chain o pairant-bairn airtins atween ilka categerie n the tap level categerie.
Category tree
Since MediaWiki 1.31, CategoryTree extension is packaged by default, allowing Special:CategoryTree and <categorytree> to provide a tree-like structure display for the categories.
Skaukt categeries
The categeries that ae page is in ar normallie leetit at the bottom o the page. In MediaWiki 1.13+, ae categerie can be skaukt fae this leet bi eikin the mageec waird "__HIDDENCAT__" til the categerie page. Skaukt categeries arna skaukt fae categerie pages (bug 15550).
Uisers can chuise to see skaukt categeries in ae separate "Hidden categories" leet, bi checkin "Shaw hidden categories" in the "Appearence" section o Special:Preferences.
Skaukt categeries ar autæmateeclie eikit til Category:Hidden categories. This categerie is speceefied in the system message MediaWiki:Hidden-category-category.
Airtin til ae categerie
Tae cræft aen airtin til ae categerie, uise ae leadin colon afore the categerie name (wioot this colon, the nou page wid be eikit til the categerie):
[[:Category:Help]]→ Category:Help
Tae chynge the airtin tex, write the tex inside the airtin tag efter ae pipe:
[[:Category:Help|Help category]]→ Help category
Reguidal pages that reguid til categeries maun uise the colon ava, itherwise thay'll be eikit til the categerie in steid o reguidin.
Categories and templates (transcluded pages)
If you add [[Category:Cats]] inside a template (a transcluded page), both the template and pages which transclude this template will be categorised in Cats.
If you want only the template to be categorised, you should ensure to write category marker inside <noinclude> tags.
If you want only the pages which use the template to be categorised, but not the template itself, you should ensure to write category marker inside <includeonly> tags.
Due to caching issues, editing categories applied through templates may take a while to be visible everywhere. You can perform a null edit on a page to update immediately its categories.
Reguidin ae categerie
Like normal wiki pages, categerie pages can be reguidit til ither normal or categerie pages. Houever, this isna recommended, aes pages categerised in reguidit categeries dinna get categerised in the tairget categerie (phab:T5311). Some Wikimedia steids uise ae "categerie reguidal" template tae maurk reguidit categeries, permitin manual or autæmatit cleanup o pages categerised thaur.
Keepin track o categeries
Certain syntax issues, like ae broken eemage airtin, or ower monie expenseeve parser functions, can cause ae page tae be eikit til ae trackin categerie. Also, extensions may add pages to tracking categories, for example Category:Pages with math errors. See Help:Tracking categories fer details.
Renaming a category
If you move a category, since redirect will not work for categorising, all category tags will be wrong, so you have to fix them.