View source for Template:Commons category multi/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{Message box |id = |halign = |malign = |backgroundcolor = |image  =Gnome-mime-text-x-credits.svg|30px |heading = |message =Note how misspelled words seem to be valid links to Wikimedia. Check spelling carefully.}}
{{tsh|Ccatm}}

===Usage===
This template is similar to {{tl|Commons category}} but shows 2, 3, 4, 5 or 6 categories, and allows changing width or floating the box to the left.

:: Usage: <code><nowiki>{{Commons category multi | topic1 | topic2 | align=left | width=20em}}</nowiki></code>
:: Usage: <code><nowiki>{{Commons category multi | topic1 | topic2 | topic3}}</nowiki></code>
:: Usage: <code><nowiki>{{Commons category multi | topic1 | topic2 | topic3 | topic4}}</nowiki></code>
:: Usage: <code><nowiki>{{Commons category multi | topic1 | t2 | t3 | t4 | t5 | t6}}</nowiki></code>

The template will state "[[Wikimedia Commons]] has media related to (category):..." and then display the first 2 topic names in bold/italics as "'''''topic1''''' or '''''topic2'''''" (as links). The optional topics 3 or 4 would be on the next line ("or '''''topic3''''' or '''''topic4'''''"). Optional topics 5 and 6 would be on a third line. 

The optional {{para|align|left}} shifts the box to the left margin. The template is on the right margin by default.

{{Para|delimiter}} specifies which delimiter is used to separate each entry. Be careful, as this parameter accepts wikicode as well. So, to specify semicolon (;) as the delimiter ([[H:DL|which is the Wikicode for definition list]]), use <nowiki>{{;}}</nowiki> instead. Because the leading and trailing spaces are ignored, use &amp;#32; to indicate space.

Note that the topic names should exist as category names in Wikimedia Commons (edited using a Wikimedia login name).

===Location===
[[File:Sister link template columns problem.jpg|thumb|Incorrect usage]]
{{Further|Wikipedia:Wikimedia sister projects#Where to place links}}
{{cross}} '''Do not place this template in a section all by itself.'''

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

In articles, this template should be placed in the [[WP:EL|External links]] section, if one exists, or at the top of the last section on the page, if no external links section exists. However, uf 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.
{{clear}}

===Examples===
The following examples show the results of the template uasge.

{|
|<code><nowiki>{{Commons category multi | Gold | Silver}}</nowiki></code>
|-
|{{Commons category multi | Gold | Silver}}
|-
|This example shows the use of {{para|align|left}}

<code><nowiki>{{Commons category multi | Red | Pale Green | align=left}}</nowiki></code>
|-
|{{Commons category multi | Red | Pale Green | align=left}}
|-
|<code><nowiki>{{Commons category multi | Los Angeles | New York}}</nowiki></code>
|-
|{{Commons category multi | Los Angeles | New York}}
|-
|This example shows links to misspelled words, in this case "Les Angles".

<code><nowiki>{{Commons category multi | Les Angles | Now York}}</nowiki></code>
|-
|{{Commons category multi | Les Angles | Now York}}
|-
|<code><nowiki>{{Commons category multi | Ludwig van Beethoven | Richard Strauss}}</nowiki></code>
|-
|{{Commons category multi | Ludwig van Beethoven | Richard Strauss}}
|-
|<code><nowiki>{{Commons category multi | Gold | Silver | Bronze}}</nowiki></code>
|-
|{{Commons category multi | Gold | Silver | Bronze}}
|-
|<code><nowiki>{{Commons category multi | Gold | Silver | Bronze | Iron}}</nowiki></code>
|-
|{{Commons category multi | Gold | Silver | Bronze | Iron}}
|-
|This example shows the use of delimiters. See "Usage" section above for explanation.

<code><nowiki>{{Commons category multi | Gold | Silver | Bronze | Iron | Copper | Brass |delimiter={{;}}&amp;#32;}}</nowiki></code>
|-
|{{Commons category multi | Gold | Silver | Bronze | Iron | Copper | Brass |delimiter={{;}}&#32;}}
|}

===See also===
* [[Template:Commons]]
* [[Template:Commons-inline]]—shows Commons gallery inline
* [[Template:Commons category]]
* [[Template:Commons category-inline]]—shows Commons category inline
* [[Template:Commons and category]]—shows Commons gallery and category
* [[Template:Commons and category-inline]]—shows Commons gallery and category inline
* [[Template:Wikimedia Commons redirect]]—specialized soft redirect template for Commons
* [[Template:Sister project links]]—to link all Wikinews, Wikisource, etc.


<includeonly>{{sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Interwiki category linking templates]]
[[Category:Interwiki link templates]]
[[Category:Wikimedia Commons templates]]
}}</includeonly>