Difference between revisions of "Template:Tag/doc"

From Summertime Saga Wiki
Jump to: navigation, search
m
m
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
The {{tlg|tag}} template provides a quick way to mention an XML‐ or HTML‐style tag in a preformatted way.
+
The template {{tlg|tag}} provides a quick way to mention an XML‐ or HTML‐style tag in a preformatted way.
  
 
== Usage ==
 
== Usage ==
Line 9: Line 9:
 
; {{para|1|{{var|tagname}}}} : The XML/HTML tag’s name (e.g. code, ref).
 
; {{para|1|{{var|tagname}}}} : The XML/HTML tag’s name (e.g. code, ref).
 
; {{para|2|{{var|type}}}} : To indicate which of the tag’s types is/are presented:
 
; {{para|2|{{var|type}}}} : To indicate which of the tag’s types is/are presented:
:; ({{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|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|open}} : An open/start tag (e.g. {{tag|span|open}}).
 
:; {{code|open}} : An open/start tag (e.g. {{tag|span|open}}).
 
:; {{code|close}} : A close/end tag (e.g. {{tag|span|close}}).
 
:; {{code|close}} : A close/end tag (e.g. {{tag|span|close}}).
Line 15: Line 15:
 
; {{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.
 
; {{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 HTML element article, e.g.:
 
 
 
: {{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.
 
  
 
== Examples ==
 
== Examples ==
  
{|class=wikitable style="width: 100%;"
+
{|class=wikitable style="width:100%;"
 
! Markup
 
! Markup
 
! Renders as
 
! Renders as
Line 66: Line 61:
 
| {{tlg|code=yes|nolink=yes|tag|math|attribs{{=}}chem}}
 
| {{tlg|code=yes|nolink=yes|tag|math|attribs{{=}}chem}}
 
| {{tag|math|attribs=chem}}
 
| {{tag|math|attribs=chem}}
|-
 
| {{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}}
 
 
|}
 
|}
  

Latest revision as of 15: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.