Difference between revisions of "Template:Tag"

From The Coppermind
Jump to navigation Jump to search
m (tweak docs)
Line 6: Line 6:
 
-->[[Category:{{{cat|{{{1}}}|}}}]]<!--
 
-->[[Category:{{{cat|{{{1}}}|}}}]]<!--
   
--></includeonly><noinclude>Use this template to link to a page and also add a category.
+
--></includeonly><noinclude>The '''tag''' template links to a page, and adds the page it's on to a category. It's best to use it on the page's [[Help:Infoboxes|infobox]] rather than in the text proper.
   
  +
=== Template ===
This template defaults to <code><nowiki>[[ {{{1}}} ]][[Category: {{{1}}} ]]</nowiki></code> but has named parameters and can be used as <code>[[ {{{link}}} | {{{text}}} ]][[Category: {{{cat}}} ]]</code>.
 
  +
<pre class=mw-code>
  +
{{tag |{{1}} |cat= |text= }}
  +
</pre>
  +
  +
=== Parameters ===
  +
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: 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>
  +
}}
  +
  +
|}
   
 
[[Category: link macros]]
 
[[Category: link macros]]

Revision as of 16:41, 8 December 2019

The tag template links to a page, and adds the page it's on to a category. It's best to use it on the page's infobox rather than in the text proper.

Template

{{tag |{{1}} |cat= |text= }}

Parameters

Highlighted lines indicate mandatory parameters.

Positional parameters are indicated with {{N}} in their name. For example, {{1}} means "the first template parameter".

{{Tag}} Parameters
Parameter Description Examples
{{1}} Use the first parameter to create a link and add the page to a category with the same name.

|Diagram

cat Use this to add this page to a category named differently than the first parameter; if cat is used, the first parameter serves only as a page link.

Note: This is useful in cases such as when the first parameter links to a disambiguation page; for example, {{tag|Diagram}} would add the page to Category:Diagram and link to Diagram, while {{tag|Diagram (group)|cat=Diagram}} adds the page to Category:Diagram and links to Diagram (group).

|cat=Diagram

text Use this to change how the tag is displayed on the page.

Note: To follow from the above example, {{tag|Diagram (group)|cat=Diagram|text=Patriots}} adds the page to Category:Diagram, links to Diagram (group) and displays the tag as Patriots.

|text=Patriots