Template:Commons category/doc

From Encyc

Template:High-use

{{Template:!((:Template:Commons category|Commons categoryTemplate:))!}} links to a "Category:" name in the Wikimedia Commons repository. If that category name is misspelled or missing, the link will still appear "blue" even though the link will fail. Check the existence of the category on commons as well as the spelling of names carefully. In articles, this template should be placed at the top of the last section on the page.

Usage[edit]

{{Commons category}} Fetches the Commons sitelink from Wikidata (where available)
{{Commons category|catname}} Puts link-box connecting title catname
{{Commons category|catname|showname}} Puts link-box showing the title showname
{{Commons category|catname|position=left}} Floats link-box to the left side, as option to align box to left-margin
{{Commons category|nowrap=yes}} Stops the text of the commons category from wrapping
{{Commons category|lcfirst=yes}} Displays the first letter as lower-case

The two parameters catname and showname (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.

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=left, that moves the box to the left side, instead of the default right side. More information may be found at Template:Side box.

Location[edit]

If using a large, graphical template produces odd layout problems, like the excessive white space shown on the right of this screenshot, then switch to a different sister template.

☒N Do not place this template in a section all by itself without floating left.

☒N 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 last section on the page. 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[edit]

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Commons category

<TemplateData> { "description": "This template creates a small box containing a link to a category on Commons. If no value is provided the Commons category value from Wikidata is used, and if none was provided there then the page name is used.", "params": { "1": { "label": "Category name", "description": "The name of the Commons category this template will link to. If no value is provided the Commons category value from Wikidata is used, and if none was provided there then the page name is used.", "type": "string", "required": false }, "2": { "label": "Displayed text", "description": "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.", "type": "string", "required": false }, "position": { "label": "Position", "description": "When set to 'left', the template will be positioned on the left side of the page. Otherwise it will default to the right side.", "type": "string", "required": false }, "nowrap": { "label": "nowrap", "description": "Stops the text of the commons category from wrapping", "type": "string", "required": false }, "lcfirst": { "label": "lcfirst", "description": "Displays the first letter as lower-case", "type": "string", "required": false } } } </TemplateData>

Tracking categories[edit]

Normal categories[edit]

Maintenance categories[edit]

Redirects[edit]

See also[edit]