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)
Created page with "{{tlx|tag|''tagname''|''type''|content{{=}}''text''|attribs{{=}}''attributes and values''}}<br> This template provides a quick way to mention an XML/wikipe..."
 
Casiope (talk | contribs)
mNo edit summary
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{tlx|tag|''tagname''|''type''|content{{=}}''text''|attribs{{=}}''attributes and values''}}<br>
The template {{tlg|tag}} provides a quick way to mention an XML‐ or HTML‐style tag in a preformatted way.
This template provides a quick way to mention an [[wikipedia:XML|XML]]/[[wikipedia:HTML|HTML]]-style tag in a preformatted way.


==Parameters==
== Usage ==


Required parameters shown in '''''bold italics'''''.
: {{tlg|code=yes|nolink=yes|tag|{{var|tagname}}|{{var|type}}|content{{=}}{{var|text}}|attribs{{=}}{{var|attributes and values}}}}


; {{para|1}} {{nobold|(''tagname'' above)}} : The XML/HTML tag's name (e.g. code, ref).
== Parameters ==
; {{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.
; {{para|1|{{var|tagname}}}} : The XML/HTML tag’s name (e.g. code, ref).
:; <code>o</code> (<code>open</code>) : An open/start tag (e.g. {{tag|span|open}}).
; {{para|2|{{var|type}}}} : To indicate which of the tag’s types is/are presented:
:; <code>c</code> (<code>close</code>) : A close/end tag (e.g. {{tag|span|close}}).
:; ({{code|pair}}) (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.
:; <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.
:; {{code|open}} : An open/start tag (e.g. {{tag|span|open}}).
:; {{code|close}} : A close/end tag (e.g. {{tag|span|close}}).
:; {{code|empty}} or {{code|single}} or {{code|void}} : 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|content}} : Text to place between open/start and close/end tags.
; {{para|attribs}} : Attributes and values to be included as part of an open/start tag (this parameter can also be called {{para|params}}).
; {{para|attribs}} : Attributes and values to be included as part of an open/start tag.
; {{para|wrap|yes}} : Disable nowrap for long samples.
; {{para|nowrap|yes}} : Enable nowrap for long samples.
; {{para|link|yes}} : Link to the element's entry at the [[wikipedia:HTML element|HTML element]] article, e.g.:<br /><code><nowiki>{{Tag|bold|link{{=}}y}}</nowiki></code> produces {{Tag|bold|link=y}}<br />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 ==
 
{|class=wikitable style="width:100%;"
! Markup
! Renders as
|-
| {{tlg|code=yes|nolink=yes|tag|ref}}
| {{tag|ref}}
|-
| {{tlg|code=yes|nolink=yes|tag|ref|content{{=}}}}
| {{tag|ref|content=}}
|-
| {{tlg|code=yes|nolink=yes|tag|ref|content{{=}}hello}}
| {{tag|ref|content=hello}}
|-
| {{tlg|code=yes|nolink=yes|tag|span|content{{=}}foo}}
| {{tag|span|content=foo}}
|-
| {{tlg|code=yes|nolink=yes|tag|span|open}}
| {{tag|span|open}}
|-
| {{tlg|code=yes|nolink=yes|tag|span|open|content{{=}}hello}}
| {{tag|span|open|content=hello}}
|-
| {{tlg|code=yes|nolink=yes|tag|span|close|content{{=}}hello}}
| {{tag|span|close|content=hello}}
|-
| {{tlg|code=yes|nolink=yes|tag|span|pair|content{{=}}hello}}
| {{tag|span|pair|content=hello}}
|-
| {{tlg|code=yes|nolink=yes|tag|ref|open|attribs{{=}}group{{=}}"note"}}
| {{tag|ref|open|attribs=group="note"}}
|-
| {{tlg|code=yes|nolink=yes|tag|references|single}}
| {{tag|references|single}}
|-
| {{tlg|code=yes|nolink=yes|tag|br|single}}
| {{tag|br|single}}
|-
| {{tlg|code=yes|nolink=yes|tag|!--|content{{=}}comment}}
| {{tag|!--|content=comment}}
|-
| {{tlg|code=yes|nolink=yes|tag|math|attribs{{=}}chem}}
| {{tag|math|attribs=chem}}
|}


==Examples==
== See also ==


* <nowiki>{{tag|ref}}</nowiki> produces {{tag|ref}}
* {{tlg|para}} - provides a similar service for template tags.
* <nowiki>{{tag|ref|content=}}</nowiki> produces {{tag|ref|content=}}
* <nowiki>{{tag|ref|content=hello}}</nowiki> produces {{tag|ref|content=hello}}
* <nowiki>{{tag|span|content=foo}}</nowiki> produces {{tag|span|content=foo}}
* <nowiki>{{tag|span|open}}</nowiki> produces {{tag|span|open}}
* <nowiki>{{tag|span|open|content=hello}}</nowiki> produces {{tag|span|open|content=hello}}
* <nowiki>{{tag|span|close|content=hello}}</nowiki> produces {{tag|span|close|content=hello}}
* <nowiki>{{tag|span|pair|content=hello}}</nowiki> produces {{tag|span|pair|content=hello}}
* <nowiki>{{tag|ref|open|attribs=group="note"}}</nowiki> produces {{tag|ref|open|attribs=group="note"}}
* <nowiki>{{tag|references|single}}</nowiki> produces {{tag|references|single}}
* <nowiki>{{tag|br|single}}</nowiki> produces {{tag|br|single}}
* <nowiki>{{tag|!--|content=comment}}</nowiki> produces {{tag|!--|content=comment}}
* <nowiki>{{tag|math|attribs=chem}}</nowiki> produces {{tag|math|attribs=chem}}
* <nowiki>{{tag|a
|attribs=href="&lt;nowiki>https://en.wikipedia.org/&lt;/nowiki>"
|content=English Wikipedia}}</nowiki> produces {{tag|a|attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>"|content=English Wikipedia}}


[[Category:Documentation subpages]]
[[Category:Templates]][[Category:Templates documentation]]

Latest revision as of 13:22, 22 July 2020

The template {{tag}} 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.
|nowrap=yes
Enable nowrap for long samples.

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>

See also

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