Revision as of 20:41, 17 February 2015 editGadget850 (talk | contribs)115,579 edits →Parameters: wrap← Previous edit | Latest revision as of 23:54, 4 October 2024 edit undoTule-hog (talk | contribs)Extended confirmed users4,171 editsm rm pointless lk | ||
(58 intermediate revisions by 25 users not shown) | |||
Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
{{high-use}} | |||
{{About|'displaying' markup tags|'using' markup tags|mw:Help:Magic_words#Miscellaneous{{!}}the #tag magic word|the inline maintenance tag|Template:Fix}} | |||
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE --> | <!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE BOTTOM OF THIS PAGE --> | ||
: {{tc|tag |
: {{tc|tag|''tagname'' }} | ||
⚫ | This template provides a quick way to mention |
||
A ] is an open < and a close > angle brackets and the content within them, in a markup language, as ] or ]: | |||
: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'''''. | 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}}).<br/>To suppress the ] ("...") between the tags, add an empty {{para|content}} parameter (for example, {{tag|div|pair|content=}}). | ||
:: <kbd>p</kbd> (pair) ''(default)'' | |||
⚫ | :; <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}}). | ||
:: <kbd>o</kbd> (open) | |||
:; <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. | ||
:: <kbd>c</kbd> (close) | |||
; {{para|attribs}} : ] to be included as part of an open/start tag (this parameter can also be called {{para|params}}). | |||
⚫ | : |
||
; {{para|wrap|yes}} : Disable ] for long samples, so allowing wraps (]). | |||
:: <kbd>s</kbd> (single) | |||
; {{para|link|yes}} : Link to the element's entry at the ] article, e.g.{{colon}}<br />{{in5}}{{tnull|Tag|del|link{{=}}y}}<br />produces:<br />{{in5}}{{Tag|del|link=y}}<br />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. | |||
::: A single tag (e.g. {{tag|hr|single}}). | |||
⚫ | ; {{ |
||
; {{bigger|params=}} : Parameters to be included as part of an open/start tag. | |||
; {{para|wrap|yes}} : to disable nowrap for long samples. | |||
==Examples== | |||
{{Markup | {{Markup | ||
| <nowiki>{{tag|ref}}</nowiki> | {{tag|ref}} | | <nowiki>{{tag|ref}}</nowiki> | {{tag|ref}} | ||
| <nowiki>{{tag|ref|content=}}</nowiki> | {{tag|ref|content=}} | | <nowiki>{{tag|ref|content=}}</nowiki> | {{tag|ref|content=}} | ||
| <nowiki>{{tag|ref|content=hello}}</nowiki> | {{tag|ref|content=hello}} | | <nowiki>{{tag|ref|content=hello}}</nowiki> | {{tag|ref|content=hello}} | ||
| <nowiki>{{tag| |
| <nowiki>{{tag|span|content=foo}}</nowiki> | {{tag|span|content=foo}} | ||
| <nowiki>{{tag| |
| <nowiki>{{tag|span|open}}</nowiki> | {{tag|span|open}} | ||
| <nowiki>{{tag| |
| <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|close|content=hello}}</nowiki> | {{tag|span|close|content=hello}} | ||
| <nowiki>{{tag|span|pair|content=hello}}</nowiki> | {{tag|span|pair|content=hello}} | | <nowiki>{{tag|span|pair|content=hello}}</nowiki> | {{tag|span|pair|content=hello}} | ||
| <nowiki>{{tag|ref|open| |
| <nowiki>{{tag|ref|open|attribs=group="note"}}</nowiki> | {{tag|ref|open|attribs=group="note"}} | ||
| <nowiki>{{tag|references|single}}</nowiki> | {{tag|references|single}} | | <nowiki>{{tag|references|single}}</nowiki> | {{tag|references|single}} | ||
| <nowiki>{{tag|br|single}}</nowiki> | {{tag|br|single}} | | <nowiki>{{tag|br|single}}</nowiki> | {{tag|br|single}} | ||
| <nowiki>{{tag|!--|content=comment}}</nowiki> | {{tag|!--|content=comment}} | | <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 Misplaced Pages}}</nowiki> | {{tag|a|attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>"|content=English Misplaced Pages}} | |||
}} | }} | ||
== 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# | |||
{{Interwikitmp-grp|commons=Tag|wbk=Tag|mw=Tag}} | |||
</pre> | |||
by this one: | |||
<pre> | |||
|p|pair = <{{#if:{{{link|}}}|[[Misplaced Pages:en:HTML element# | |||
</pre> | |||
Remark that the code '''<code>Misplaced Pages:en:</code>''' has been added. | |||
For template documentation in the sister project, you can use ]. | |||
⚫ | ==See also== | ||
* ] | |||
* {{tl|HTMLElement}} | * {{tl|HTMLElement}} | ||
* {{tl|XMLElement}} | * {{tl|XMLElement}} | ||
Line 45: | Line 71: | ||
* ], the ] that generates working tags. | * ], the ] that generates working tags. | ||
===Other formatting templates=== | |||
⚫ | <includeonly>{{ |
||
{{#lsth:Template:Template-linking_templates|Other formatting templates}} | |||
⚫ | |||
{{semantic markup templates}} | |||
⚫ | <includeonly>{{sandbox other|| | ||
⚫ | <!-- CATEGORIES BELOW THIS LINE, PLEASE: --> | ||
] | |||
] | |||
] | ] | ||
}}</includeonly> | }}</includeonly> |
Latest revision as of 23:54, 4 October 2024
This is a documentation subpage for Template:Tag. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 6,500 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
{{tag|tagname }}
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 divRequired 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
) ors
(single
) orv
(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}} |
|
{{tag|ref|content=}} |
|
{{tag|ref|content=hello}} |
|
{{tag|span|content=foo}} |
|
{{tag|span|open}} |
|
{{tag|span|open|content=hello}} |
|
{{tag|span|close|content=hello}} |
|
{{tag|span|pair|content=hello}} |
|
{{tag|ref|open|attribs=group="note"}} |
|
{{tag|references|single}} |
|
{{tag|br|single}} |
|
{{tag|!--|content=comment}} |
|
{{tag|math|attribs=chem}} |
|
{{tag|a |attribs=href="<nowiki>https://en.wikipedia.org/</nowiki>" |content=English Misplaced Pages}} |
|
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|}}}|[[HTML element#
by this one:
|p|pair = <{{#if:{{{link|}}}|[[Misplaced Pages:en:HTML element#
Remark that the code Misplaced Pages:en:
has been added.
For template documentation in the sister project, you can use Template:Misplaced Pages doc.
See also
- HTML tag
- {{HTMLElement}}
- {{XMLElement}}
- {{xtag}} adds a MediaWiki parser or extension tag that links to the extension page.
- #tag:, the parser function that generates working tags.
Other formatting templates
Code example | Effect | Notes |
---|---|---|
{{Tj|Hatnote|Some text|selfref: yes|category: no|lang: fr}}
|
{{Hatnote | Some text | selfref = yes | category = no | lang = fr }} |
Supports colors, placeholder texts, named and unnamed parameters |
<syntaxhighlight lang="wikitext"> {{Hatnote | Some text | selfref = yes | category = no | lang = fr }} </syntaxhighlight> |
{{Hatnote | Some text | selfref = yes | category = no | lang = fr }} |
Same as above |
{{Tji|Hatnote|Some text|selfref: yes|category: no|lang: fr}}
|
{{Hatnote |
Supports colors, placeholder texts, named and unnamed parameters |
|
{{Hatnote|Some text|selfref=yes|category=no|lang=fr}}
|
Same as above |
{{tl2|Hatnote|lang=fr}}
|
{{hatnote}} |
Supports linking to sister projects (e.g., fr:Hatnote) |
{{demo|<nowiki>{{Hatnote|lang=fr|Some text}}</nowiki>}}
|
{{hatnote|lang=fr|Some text}}Some text |
Shows code and example |
{{tln|Hatnote}}
|
Template:Hatnote | Produces a normal link to the template |
{{elc|Template:Hatnote}} {{elc|Template:Hatnote|Hatnote}}
|
] ] |
Formats wikilink, with optional piped link text and blended suffix |
{{ml|Example|hello}}
|
{{#invoke:Example|hello}} | Counterpart to {{tl}} for linking to Lua modules |
{{mfl|Example|hello}}
|
{{#invoke:Example|hello}} | Similar to {{ml}}, but expects the function to be documented and creates a link to the corresponding section |
{{mlx|Example|hello}}
|
{{#invoke:Example|hello}} |
Counterpart to {{tlx}} for linking to Lua modules |
{{ml-lua|Module:Example}}
|
require('Module:Example') |
Link to Lua modules and built-in libraries, showing Lua code. |
{{para|title|<var>book title</var>}}
|
|title=book title |
Formats template parameters for display, with or without values |
{{sclx|LASTING}}
|
] |
Takes a shortcut suffix in project namespace and displays it with brackets and the WP: alias in a <code>...</code> tag.
|
{{tag|ref}} {{xtag|templatedata}}
|
<ref>...</ref> <templatedata> |
Formats HTML tags; can add content, choose opening, closing, or self-closing |
{{dtl|Ping project}}
|
{{d:Ping project}} | Wikidata counterpart to {{tl}} |
{{pf|if}} {{pf|if|{{{1}}}|true|false}}
|
{{#if}} {{#if:{{{1}}}|true|false}} |
Parser function equivalent to {{tl}} |
{{magic word|uc:}}
|
{{uc:}} | Magic word links |
Semantic markup templates | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|