Editing Template:Tag/doc

{{Documentation subpage}}
{{About|'displaying' markup tags|'using' markup tags|m:Help:Magic_words#Miscellaneous{{!}}the #tag magic word|the inline maintenance tag|Template:Fix}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->

: {{tc|tag|''tagname'' [|''type''] [|content&#61;''text''] [|attribs&#61;''attributes and values'']}}

A [[markup tag]] is an open < and a close > angle brackets and the content within them, in a markup language, as [[XML]] or [[HTML]]:

:For example, the '''<title>''' tag provides a title for the Web page.

This template provides a quick way to mention a markup-style [[tag]] in a preformatted way. Mainly used in discussion/help pages.

== Parameters ==
{{See also|Span and div}}

Required parameters shown in '''''bold italics'''''.

; {{para|1}} {{nobold|&nbsp;(''tagname'' above)}} : The XML/HTML tag's name (e.g. {{mono|100%|code}}, {{mono|100%|ref}}).
; {{para|2}} {{nobold|&nbsp;(''type'' above)}} : To indicate which of the tag's types is/are presented:
:; <code>p</code> &nbsp;(<code>pair</code>) ''(default)'' : A matching pair of open/start and close/end tags (e.g. {{tag|div|pair}}).<br/>To suppress the [[ellipsis]] ("...") between the tags, add an empty {{para|content}} parameter (for example, {{tag|div|pair|content=}}).
:; <code>o</code> &nbsp;(<code>open</code>) : An open/start tag (e.g. {{tag|span|open}}).
:; <code>c</code> &nbsp;(<code>close</code>) : A close/end tag (e.g. {{tag|span|close}}).
:; <code>e</code> &nbsp;(<code>empty</code>) &nbsp;or &nbsp;<code>s</code> &nbsp;(<code>single</code>) &nbsp;or &nbsp;<code>v</code> &nbsp;(<code>void</code>) : An empty element, formed with a single self-terminating tag (e.g. {{tag|hr|single}}); in HTML5 these are now known as "void" elements, though "empty" is the more common term.
; {{para|content}} : Text to place between open/start and close/end tags.
; {{para|attribs}} : [[HTML attribute|Attributes and values]] to be included as part of an open/start tag (this parameter can also be called {{para|params}}).
; {{para|wrap|yes}} : Disable [[:Template:Nowrap|nowrap]] for long samples, so allowing wraps ([[Help:Line-break handling|line breaks]]).
; {{para|link|yes}} : Link to the element's entry at the [[HTML element]] article, e.g.{{colon}}<br />{{in5}}{{tnull|Tag|del|link{{=}}y}}<br />produces:<br />{{in5}}{{Tag|del|link=y}}<br />This is {{em|only}} for HTML elements; the page is hard-coded, so it cannot be used for, e.g., XML elements from a particular schema. If desired, a feature for specifying the link page can be added.

== Examples ==
{{Markup
 | <nowiki>{{tag|ref}}</nowiki>                      | {{tag|ref}}
 | <nowiki>{{tag|ref|content=}}</nowiki>             | {{tag|ref|content=}}
 | <nowiki>{{tag|ref|content=hello}}</nowiki>        | {{tag|ref|content=hello}}
 | <nowiki>{{tag|span|content=foo}}</nowiki>         | {{tag|span|content=foo}}
 | <nowiki>{{tag|span|open}}</nowiki>                | {{tag|span|open}}
 | <nowiki>{{tag|span|open|content=hello}}</nowiki>  | {{tag|span|open|content=hello}}
 | <nowiki>{{tag|span|close|content=hello}}</nowiki> | {{tag|span|close|content=hello}}
 | <nowiki>{{tag|span|pair|content=hello}}</nowiki>  | {{tag|span|pair|content=hello}}
 | <nowiki>{{tag|ref|open|attribs=group="note"}}</nowiki> | {{tag|ref|open|attribs=group="note"}}
 | <nowiki>{{tag|references|single}}</nowiki>        | {{tag|references|single}}
 | <nowiki>{{tag|br|single}}</nowiki>                | {{tag|br|single}}
 | <nowiki>{{tag|!--|content=comment}}</nowiki>      | {{tag|!--|content=comment}}
 | <nowiki>{{tag|math|attribs=chem}}</nowiki>    | {{tag|math|attribs=chem}}
 | <nowiki>{{tag|a
 |attribs=href="&lt;nowiki>https://en.wikipedia.org/&lt;/nowiki>"
 |content=English Wikipedia}}</nowiki>  | {{tag|a|attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>"|content=English Wikipedia}}
}}
== Global use and documentation==
For a global use of this template in other sister or Wikimedia projects, after copying it to paste in the destination project, remember to change in the code: 

<pre>
|p|pair = &lt;{{#if:{{{link|}}}|[[HTML element#
</pre>

by this one:

<pre>
|p|pair = &lt;{{#if:{{{link|}}}|[[Wikipedia:en:HTML element#
</pre>

Remark that the code '''<code>Wikipedia:en:</code>''' has been added.

For template documentation in the sister project, you can use [[m:Template:Wikipedia doc|Template:Wikipedia doc]].

== See also ==
* [[w:HTML tag|HTML tag]]
* {{tl|HTMLElement}}
* {{tl|XMLElement}}
* {{tl|xtag}} adds a MediaWiki parser or extension tag that links to the extension page.
* [[mw:Help:Magic words#Miscellaneous|#tag:]], the [[Wikipedia:Parser functions|parser function]] that generates working tags.

===Other formatting templates===
{{#lsth:Template:Template-linking_templates|Other formatting templates}}

<includeonly>{{sandbox other||
<!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:HTML typing-aid templates]]
[[Category:Wikitext typing-aid templates]]
[[Category:Wikipedia XHTML tag-replacing templates| ]]
}}</includeonly>