Changes
Jump to navigation
Jump to search
m
→Global use and documentation
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->
: {{tc|tag|''tagname'' [|''type''] [|content=''text''] [|attribs=''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| (''tagname'' above)}} : The XML/HTML tag's name (e.g. {{mono|100%|code}}, {{mono|100%|ref}}).
; {{para|2}} {{nobold| (''type'' above)}} : To indicate which of the tag's types is/are presented:
:; <code>p</code> (<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> (<code>open</code>) : An open/start tag (e.g. {{tag|span|open}}).
:; <code>c</code> (<code>close</code>) : A close/end tag (e.g. {{tag|span|close}}).
:; <code>e</code> (<code>empty</code>) or <code>s</code> (<code>single</code>) or <code>v</code> (<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="<nowiki>https://en.wikipedia.org/</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 = <{{#if:{{{link|}}}|[[HTML element#
</pre>
by this one:
<pre>
|p|pair = <{{#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==
* [[HTML tag]]
{{Interwikitmp-grp|commons=Tag|wbk=Tag|mw=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:Programming typing-aid templates]]
[[Category:Wikipedia XHTML tag-replacing templates| ]]
}}</includeonly>
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE -->
: {{tc|tag|''tagname'' [|''type''] [|content=''text''] [|attribs=''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| (''tagname'' above)}} : The XML/HTML tag's name (e.g. {{mono|100%|code}}, {{mono|100%|ref}}).
; {{para|2}} {{nobold| (''type'' above)}} : To indicate which of the tag's types is/are presented:
:; <code>p</code> (<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> (<code>open</code>) : An open/start tag (e.g. {{tag|span|open}}).
:; <code>c</code> (<code>close</code>) : A close/end tag (e.g. {{tag|span|close}}).
:; <code>e</code> (<code>empty</code>) or <code>s</code> (<code>single</code>) or <code>v</code> (<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="<nowiki>https://en.wikipedia.org/</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 = <{{#if:{{{link|}}}|[[HTML element#
</pre>
by this one:
<pre>
|p|pair = <{{#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==
* [[HTML tag]]
{{Interwikitmp-grp|commons=Tag|wbk=Tag|mw=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:Programming typing-aid templates]]
[[Category:Wikipedia XHTML tag-replacing templates| ]]
}}</includeonly>
