Difference between revisions of "Template:Commons category/doc"
(+ TD header) |
m (1 revision) |
(No difference)
| |
Latest revision as of 23:44, 1 February 2014
| 40x40px | This template is used on 360,000+ pages. To avoid large-scale disruption and unnecessary server load, any changes to this template should first be tested in its /sandbox or /testcases subpages, or in your own user space. The tested changes can then be added to this page in one single edit. Please consider discussing any changes on the talk page before implementing them. |
| 45px | Note how misspelled words seem to be valid links to Wikimedia. Check spelling carefully. |
{{Commons category}} links to a "Category:" name in the Wikimedia Commons repository (edited using a Wikimedia login name). If that category name is misspelled or missing, the link will still appear "blue" even though the link will fail. Check spelling of names carefully.
Contents
Usage
{{Commons category}}– puts link-box with current page's name as the category. {{Commons category|catnam}}– puts link-box connecting title catnam. {{Commons category|catnam|shownam}}– puts link-box showing the title shownam. {{Commons category |catnam|position=left}}– floats link-box to the left side, as option to align box to left-margin.
The two parameters catnam and shownam (1 & 2) are optional, and are intended for cases where the Commons category name is different from the Wikipedia page name. The first parameter is the name of the corresponding category on the Wikimedia Commons, without the "Category:" prefix. If this first parameter is used, then the template will display the Commons category name, which may be confusing to readers. This text can be overridden by the second parameter, where the Wikipedia page name would typically be used.
| 40x40px | Wikimedia Commons has media related to Polar bears. |
For example, on the Polar bear page, {{Commons category|Ursus maritimus|Polar bears}} produces a link to Commons:Category:Ursus maritimus displayed as "Polar bears".
The parameter |position= accepts one value, |position=leftl, that moves the box to the left side, instead of the default right side. More information may be found at Template:Side box. The template can also be floated left by using a colon (:) before it.
Location
20px Do not place this template in a section all by itself without floating left.
20px Do not place this template in a section containing columns without floating left.
In articles, this template should be placed at the top of the ==External links== section, or at the top of the last section on the page, if no external links section exists. On disambiguation pages, this template is usually placed at the top of the page. See Wikipedia:Wikimedia sister projects#Where to place links for more information and alternatives.
In categories, this template should be grouped with other templates at the beginning of the category introduction. This avoids unnecessary white space as any text is floated around the template boxes.
TemplateData
Commons category/doc
This template creates a small box containing a link to a category on commons.
| Parameter | Description | Type | Default | Status | |
|---|---|---|---|---|---|
| Category name | 1 | The name of the commons category this template will link to. If no value is provided the page name is used by default. | string | empty | optional |
| Displayed text | 2 | The text that the link will display to the user. If no value is provided it will default to category name or page name, in that order. | string | empty | optional |
| Position | position | When set to 'left', the template will be positioned on the left side of the page. Otherwise it will default to the right side. | string | empty | optional |
See also
- Template:Commons
- Template:Commons-inline – shows Commons gallery inline
- Template:Commons category-inline – shows Commons category inline
- Template:Commons category multi – lists up to 6 categories
- Template:Commons and category – shows Commons box with both gallery and category
- Template:Commons and category-inline – shows Commons gallery and category inline
- Template:Sister project links – links to all Wikimedia sister projects (Wikinews, Wikisource, etc.)
