Open main menu

Changes

Template:Commons/doc

5,595 bytes added, 13:10, 14 November 2020
m
→‎Location: bypass redir
{{documentation subpage}}
<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]). -->
{{for|other uses in Wikipedia|Wikipedia:COMMON (disambiguation)}}
{{Distinguish|Template:Copy to Wikimedia Commons}}
{{high-use| 835000+ }}
{{Lua|Module:Commons link}}
This template is part of Wikipedia's [[Wikipedia:Wikimedia sister projects|sister projects]]. This template links an article to a page on [[commons:|Wikimedia Commons]], containing a gallery of related media. Note that it does not link to a Commons category, which will give a larger selection of media; for that use [[Template:Commons category]].

===Usage===
::{|
|-
|{{Tlx|Commons}}||—puts link-box with current page's name.
|-
|{{Tlx|Commons|''pagename''}}||—puts link-box connecting title ''pagename''.
|-
|{{Tlx|Commons|''pagename''|''showname''}}||—puts link-box showing the title ''showname''.
|-
|{{Tlx|Commons|''pagename''|3=position=left}}||—floats link-box to the left side.
|}

To place this template on the page, type '''<nowiki>{{</nowiki>Commons|''pagename''}}''', where ''pagename'' is the name of a page on Wikimedia Commons (defaults to <small><nowiki>"{{PAGENAME}}"</nowiki></small>, the end-name of a page where used).
* The optional 2nd parameter gives the displayed link text.
* The {{Para|position}} parameter accepts one keyword, <code>left</code>, to float the box to the left instead of to the right.
* To link to a ''Category'', use the related template {{Tlx|Commons category|''catname''}}, where ''catname'' is the name of the category.

===Location===
[[File:Sister link template columns problem.jpg|thumb|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.]]

{{xmark}} '''Do not place this template in a section all by itself.'''

{{xmark}} '''Do not place this template in a section containing columns.'''

This template should normally be placed at the top of the last section in the article, or consider using {{tlx|Commons-inline}} instead. See [[Wikipedia:Wikimedia sister projects]] for further recommendations about the best choice of template for various situations.

On [[WP:DAB|disambiguation pages]], this template should be listed above other text, but below any cleanup templates, images, infoboxes or navboxes.<!-- Per WP:ACCESS, cleanup templates, images, infoboxes, and navboxes are always first. -->

===Defaults===
The ''pagenam'' defaults to wiki-variable <small><nowiki>"{{PAGENAME}}"</nowiki></small>, which is the end-name of the page where used. For a Template:Txxx, the <small><nowiki>{{PAGENAME}}</nowiki></small> would be the end-name "Txxx". For a Category:Catxxx, that page would have <small><nowiki>{{PAGENAME}}</nowiki></small> as the end-name "Catxxx".

The default positioning of the link-box is to the right-side.

===Examples===
{| style="border:1px solid #808080; padding:1px;"
|{{tlx|Commons}}
|}
produces
{{Commons}}
{{clear}}

{| style="border:1px solid #808080; padding:1px;"
|{{tlx|Commons|Reconquista}}
|}
produces
{{Commons|Reconquista}}
{{clear}}

{| style="border:1px solid #808080; padding:1px;"
|{{tlx|Commons|Category:Reconquista}}
|}
produces
{{Commons|Category:Reconquista}}
{{clear}}

{| style="border:1px solid #808080; padding:1px;"
|{{tlx|Commons|Reconquista|retaking of the Iberian Peninsula}}
|}
produces
{{Commons|Reconquista|retaking of the Iberian Peninsula}}
{{clear}}

{| style="border:1px solid #808080; padding:1px;"
|{{tlx|Commons|Reconquista|position{{=}}left}}
|}
produces
{{Commons|Reconquista|position=left}}
{{clear}}

===Template data===
{{TemplateData header}}
<templatedata>{
"description": "Creates a small box with a link to a related page on Wikimedia Commons.",
"params": {
"1": {
"label": "Pagename",
"description": "The page name on Commons. The article's page name is used as a default.",
"type": "string",
"required": false
},
"2": {
"label": "Showname",
"description": "Optional displayed link text.",
"type": "string",
"required": false
},
"position": {
"label": "Position",
"description": "Position to display the box: 'left' floats the box to the left rather than the default which is on the right.",
"type": "string",
"required": false
}
}}</templatedata>

== Tracking categories ==
=== Normal categories ===
* {{clc|Commons link from Wikidata}}
* {{clc|Commons link is on Wikidata}}
=== Maintenance categories ===
* {{clc|Commons link is defined as the pagename}}
* {{clc|Commons link is locally defined}}
* {{clc|Commons link is the pagename}}

===See also===
* {{Tl|Commons-inline}} – shows Commons gallery inline
* {{Tl|Commons category}}
* {{Tl|Commons category-inline}} – shows Commons category inline
* {{Tl|Commons category multi}} – to list up to six categories
* {{Tl|Commons and category}} – shows Commons box with both gallery and category
* {{Tl|Commons and category-inline}} – shows Commons gallery and category inline
* {{Tl|Copy to Wikimedia Commons}}
* {{Tl|Sister project links}} – to link all Wikinews, Wikisource, etc.
* {{Tl|Wikimedia Commons redirect}} – specialized soft redirect template for Commons
* {{Tl|Wiki category}} – to link to a gallery hosted on Wikipedia

<includeonly>{{Sandbox other||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Category:Exclude in print]]
[[Category:Interwiki link templates]]
[[Category:Wikimedia Commons templates]]
}}</includeonly>
Anonymous user