Template:Tag/doc

From the AARoads Wiki: Read about the road before you go
Jump to navigation Jump to search
{{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

Required parameters shown in bold italics.

|1=  (tagname above)
The XML/HTML tag's name (e.g. code, ref).
|2=  (type above)
To indicate which of the tag's types is/are presented:
p  (pair) (default)
A matching pair of open/start and close/end tags (e.g. <div>...</div>).
To suppress the ellipsis ("...") between the tags, add an empty |content= parameter (for example, <div></div>).
o  (open)
An open/start tag (e.g. <span>).
c  (close)
A close/end tag (e.g. </span>).
e  (empty)  or  s  (single)  or  v  (void)
An empty element, formed with a single self-terminating tag (e.g. <hr />); in HTML5 these are now known as "void" elements, though "empty" is the more common term.
|content=
Text to place between open/start and close/end tags.
|attribs=
Attributes and values to be included as part of an open/start tag (this parameter can also be called |params=).
|wrap=yes
Disable nowrap for long samples, so allowing wraps (line breaks).
|link=yes
Link to the element's entry at the HTML element article, e.g.:
     {{Tag|del|link=y}}
produces:
     <del>...</del>
This is 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 Renders as
{{tag|ref}}

<ref>...</ref>

{{tag|ref|content=}}

<ref></ref>

{{tag|ref|content=hello}}

<ref>hello</ref>

{{tag|span|content=foo}}

<span>foo</span>

{{tag|span|open}}

<span>

{{tag|span|open|content=hello}}

<span>hello

{{tag|span|close|content=hello}}

hello</span>

{{tag|span|pair|content=hello}}

<span>hello</span>

{{tag|ref|open|attribs=group="note"}}

<ref group="note">

{{tag|references|single}}

<references />

{{tag|br|single}}

<br />

{{tag|!--|content=comment}}

<!--comment-->

{{tag|math|attribs=chem}}

<math chem>...</math>

{{tag|a
 |attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>"
 |content=English Wikipedia}}

<a href="https://en.wikipedia.org/">English Wikipedia</a>

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:

|p|pair = <{{#if:{{{link|}}}|[[w:HTML element#

by this one:

|p|pair = <{{#if:{{{link|}}}|[[Wikipedia:en:HTML element#

Remark that the code Wikipedia:en: has been added.

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

See also

Other formatting templates

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