Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Template:Tag/doc: Difference between revisions

Template page
Casiope (talk | contribs)
Casiope (talk | contribs)
mNo edit summary
Line 1: Line 1:
The {{tl|tag}} template provides a quick way to mention an XML‐ or HTML‐style tag in a preformatted way.
The {{tlg|tag}} template provides a quick way to mention an XML‐ or HTML‐style tag in a preformatted way.


== Usage ==
== Usage ==


: {{tlc|tag|{{var|tagname}}|{{var|type}}|content{{=}}{{var|text}}|attribs{{=}}{{var|attributes and values}}}}
: {{tlg|code=yes|nolink=yes|tag|{{var|tagname}}|{{var|type}}|content{{=}}{{var|text}}|attribs{{=}}{{var|attributes and values}}}}


== Parameters ==
== Parameters ==
Line 18: Line 18:
; {{para|link|yes}} : Link to the element’s entry at the HTML element article, e.g.:
; {{para|link|yes}} : Link to the element’s entry at the HTML element article, e.g.:


: {{tlc|tag|bold|link{{=}}yes}} produces {{Tag|bold|link=yes}}
: {{tlg|code=yes|nolink=yes|tag|bold|link{{=}}yes}} produces {{tag|bold|link=yes}}


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.
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.
Line 28: Line 28:
! Renders as
! Renders as
|-
|-
| <code><nowiki>{{tag|ref}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|ref}}
| {{tag|ref}}
| {{tag|ref}}
|-
|-
| <code><nowiki>{{tag|ref|content=}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|ref|content{{=}}}}
| {{tag|ref|content=}}
| {{tag|ref|content=}}
|-
|-
| <code><nowiki>{{tag|ref|content=hello}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|ref|content{{=}}hello}}
| {{tag|ref|content=hello}}
| {{tag|ref|content=hello}}
|-
|-
| <code><nowiki>{{tag|span|content=foo}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|span|content{{=}}foo}}
| {{tag|span|content=foo}}
| {{tag|span|content=foo}}
|-
|-
| <code><nowiki>{{tag|span|open}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|span|open}}
| {{tag|span|open}}
| {{tag|span|open}}
|-
|-
| <code><nowiki>{{tag|span|open|content=hello}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|span|open|content{{=}}hello}}
| {{tag|span|open|content=hello}}
| {{tag|span|open|content=hello}}
|-
|-
| <code><nowiki>{{tag|span|close|content=hello}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|span|close|content{{=}}hello}}
| {{tag|span|close|content=hello}}
| {{tag|span|close|content=hello}}
|-
|-
| <code><nowiki>{{tag|span|pair|content=hello}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|span|pair|content{{=}}hello}}
| {{tag|span|pair|content=hello}}
| {{tag|span|pair|content=hello}}
|-
|-
| <code><nowiki>{{tag|ref|open|attribs=group="note"}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|ref|open|attribs{{=}}group{{=}}"note"}}
| {{tag|ref|open|attribs=group="note"}}
| {{tag|ref|open|attribs=group="note"}}
|-
|-
| <code><nowiki>{{tag|references|single}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|references|single}}
| {{tag|references|single}}
| {{tag|references|single}}
|-
|-
| <code><nowiki>{{tag|br|single}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|br|single}}
| {{tag|br|single}}
| {{tag|br|single}}
|-
|-
| <code><nowiki>{{tag|!--|content=comment}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|!--|content{{=}}comment}}
| {{tag|!--|content=comment}}
| {{tag|!--|content=comment}}
|-
|-
| <code><nowiki>{{tag|math|attribs=chem}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|math|attribs{{=}}chem}}
| {{tag|math|attribs=chem}}
| {{tag|math|attribs=chem}}
|-
|-
| <code><nowiki>{{tag|a|attribs=href="https://en.wikipedia.org/"|content=English Wikipedia}}</nowiki></code>
| {{tlg|code=yes|nolink=yes|tag|a|attribs{{=}}href{{=}}"https://en.wikipedia.org/"|content{{=}}English Wikipedia}}
| {{tag|a|attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>"|content=English Wikipedia}}
| {{tag|a|attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>"|content=English Wikipedia}}
|}
|}
Line 73: Line 73:
== See also ==
== See also ==


* {{tl|para}} - provides a similar service for template tags.
* {{tlg|para}} - provides a similar service for template tags.


[[Category:Templates]][[Category:Templates documentation]]
[[Category:Templates]][[Category:Templates documentation]]

Revision as of 15:58, 21 July 2020

The {{tag}} template provides a quick way to mention an XML‐ or HTML‐style tag in a preformatted way.

Usage

{{tag|tagname|type|content=text|attribs=attributes and values}}

Parameters

|1=tagname
The XML/HTML tag’s name (e.g. code, ref).
|2=type
To indicate which of the tag’s types is/are presented:
(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.
open
An open/start tag (e.g. <span>).
close
A close/end tag (e.g. </span>).
empty or single or 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.
|wrap=yes
Disable nowrap for long samples.
|link=yes
Link to the element’s entry at the HTML element article, e.g.:
{{tag|bold|link=yes}} produces <bold>…</bold>

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="https://en.wikipedia.org/"|content=English Wikipedia}} <a href="https://en.wikipedia.org/">English Wikipedia</a>

See also

  • {{para}} - provides a similar service for template tags.