Difference between revisions of "Template:Tag"

2,720 bytes added ,  10 months ago
m
no edit summary
m
m
 
(18 intermediate revisions by 5 users not shown)
<includeonly><span class="cm-tag {{{class|}}}"><!--
<!--
LINK
-->[[{{{link|{{{1}}}|}}}|{{{text|{{{1}}}|}}}]]<!--
 
CATEGORY
-->[[Category:{{cat ns|{{{cat|{{{1}}}|}}}|{{{key|{{PAGENAME}}|}}}]]<!--
 
--></span></includeonly><noinclude>
-->{{#if:{{{key|}}}|[[Category: tag.key]]}}<!--
The '''tag''' template is a link macro template that links to a page and applies a category. It's best to use it on the page's [[help: infoboxes|infobox]] rather than in the text proper.
 
Note that the category will be suppressed on userpages for the sake of drafting articles without affecting readers, you can use [[Special:ExpandTemplates]] if you wish to test that proper categories are included before moving the draft to the mainspace.
--><noinclude>
 
=== Template ===
This template automatically adds links and categories to a number of parameters passed. It defaults to <nowiki>[[{{{1}}}]][[Category:{{{1}}}]]</nowiki> with optional parameters for the link, the text, the <tt>cat</tt>egory and the sort key.
<small>'''Note:''' Replace <code><nowiki>{{1}}</nowiki></code> with an actual parameter.</small>
<pre class=mw-code>
{{tag |{{1}} |cat= |text= }}
</pre>
 
=== Parameters ===
[[Category: link macros]]
Highlighted lines indicate '''mandatory''' parameters.
 
Positional parameters are indicated with <nowiki>{{N}}</nowiki> in their name. For example, <nowiki>{{1}}</nowiki> means "the first template parameter".
 
{{docs|title={{t|Tag}} Parameters}}
 
<!-- ------------- -->
<!-- ROW: {1} -->
<!-- ------------- -->
{{docs/row/required
|param=<nowiki>{1}</nowiki>
|desc= Use the first parameter to create a link and add the page to a category with the same name.
|eg=
<code><nowiki>|Diagram</nowiki></code>
}}
 
<!-- -------- -->
<!-- ROW: cat -->
<!-- -------- -->
{{docs/row/optional
|param=cat
|desc=Use this to add this page to a category named differently than the first parameter; if <code>cat</code> is used, the first parameter serves only as a page link.<br>
<small>'''Note:''' This is useful in cases such as when the first parameter links to a disambiguation page; for example, <code><nowiki>{{tag|Diagram}}</nowiki></code> would add the page to [[:Category:Diagram]] and link to [[Diagram]], while <code><nowiki>{{tag|Diagram (group)|cat=Diagram}}</nowiki></code> adds the page to [[:Category:Diagram]] and links to [[Diagram (group)]].</small>
|eg=
<code><nowiki>|cat=Diagram</nowiki></code>
}}
 
<!-- -------- -->
<!-- ROW: link-->
<!-- -------- -->
{{docs/row/optional
|param=link
|desc=Use this to change which page the tag links to.<br>
<small>'''Note:''' To follow from the above example, <code><nowiki>{{tag|Diagram|link=Diagram (group)}}</nowiki></code> adds the page to [[:Category:Diagram]], links to [[Diagram (group)]] and displays the tag as [[Diagram (group)|Diagram]].</small>
|eg=
<code><nowiki>|link=Diagram (group)</nowiki></code>
}}
 
 
<!-- -------- -->
<!-- ROW: text -->
<!-- -------- -->
{{docs/row/optional
|param=text
|desc=Use this to change how the tag is displayed on the page.<br>
<small>'''Note:''' To follow from the above example, <code><nowiki>{{tag|Diagram (group)|cat=Diagram|text=Patriots}}</nowiki></code> adds the page to [[:Category:Diagram]], links to [[Diagram (group)]] and displays the tag as [[Diagram (group)|Patriots]].</small>
|eg=
<code><nowiki>|text=Patriots</nowiki></code>
}}
 
|}
 
[[Categorycategory: link macros]]
 
== Articles using Template ==
{{for|Special:WhatLinksHere/{{FULLPAGENAME}}|a full listing|here|pre=This list is limited to 100 pages.}}
{{Special:WhatLinksHere/{{FULLPAGENAME}}|namespace=0|limit=100}}