FilipeFonseca: 1 revision imported

2021-07-08T07:21:11Z

1 revision imported

New page

{{Documentation subpage}}
{{About|'displaying' markup tags|'using' markup tags|m:Help:Magic_words#Miscellaneous{{!}}the #tag magic word|the inline maintenance tag|Template:Fix}}


: {{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}}). 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}} {{in5}}{{tnull|Tag|del|link{{=}}y}} produces: {{in5}}{{Tag|del|link=y}} 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]]
* {{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||

[[Category:HTML typing-aid templates]]
[[Category:Wikitext typing-aid templates]]
[[Category:Wikipedia XHTML tag-replacing templates| ]]
}}</includeonly>

Template:Tag/doc - Revision history

FilipeFonseca: 1 revision imported