Template:Quote/doc: Difference between revisions
Template page
More actions
| (9 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
The {{ | The {{tlg|quote}} formats block quotations and provides a wrapper with decorative marks for the HTML {{tag|blockquote|open}} element. | ||
This template should {{strong|not be used}} for block quotations in article text. Quotes work best when used with short sentences, and at the start or end of a section, as a hint of or to help emphasize the section’s content. | This template should {{strong|not be used}} for block quotations in article text. Quotes work best when used with short sentences, and at the start or end of a section, as a hint of or to help emphasize the section’s content. | ||
| Line 5: | Line 5: | ||
== Usage == | == Usage == | ||
== Usage == | |||
{{ | : {{tlg|code=yes|nolink=yes|quote|text{{=}}{{var|text}}|source{{=}}{{var|source}}}} | ||
{{tlg|nolink=yes|quote}} adds a block quotation to an article page. This is easier to type and is more wiki‐like than the equivalent HTML {{tag|blockquote}} tags, and has additional pre‐formatted attribution parameters for author and source. Block quotes do {{em|not}} normally contain quotation marks. | |||
== Parameters == | == Parameters == | ||
; {{para| | ; {{para|quote}} or {{para|1}} : The material being quoted, without quotation marks around it. | ||
; {{para|source}} or {{para|2}} : Optional speaker or source information to display that will appear below the quotation, and preceded with an attribution dash. | |||
; {{para| | |||
== Examples == | == Examples == | ||
| Line 19: | Line 20: | ||
{|class=wikitable style="width:100%;" | {|class=wikitable style="width:100%;" | ||
! style="width:50%;" | Markup | ! style="width:50%;" | Markup | ||
! Renders as | ! Renders as | ||
|- | |- | ||
| {{ | | {{tlg|code=yes|nolink=yes|quote|Quoted material.}} | ||
| {{quote|Quoted material.}} | | {{quote|Quoted material.}} | ||
|- | |- | ||
| {{ | | {{tlg|code=yes|nolink=yes|quote|text{{=}}Quoted material.|source{{=}}Source material}} | ||
| {{quote|text=Quoted material.|source=Source material}} | |||
|- | |||
| {{tlg|code=yes|nolink=yes|quote|Quoted material.|Source material}} | |||
| {{quote|Quoted material.|Source material}} | | {{quote|Quoted material.|Source material}} | ||
|} | |} | ||
| Line 49: | Line 37: | ||
If you do not provide text, the template generates a parser error message, which will appear in red text in the rendered page. | If you do not provide text, the template generates a parser error message, which will appear in red text in the rendered page. | ||
If any parameter’s actual value contains an equals sign “=”, you {{strong|must}} use a named parameter (e.g. {{para| | If any parameter’s actual value contains an equals sign “=”, you {{strong|must}} use a named parameter (e.g. {{para|text|2=“E=MC<sup>2</sup>”}}), not a blank‐name positional parameter. The text before the equals sign gets misinterpreted as a named parameter otherwise. Be wary of URLs, which frequently contain this character. Named parameters are always safer, in this and other templates. | ||
[[Category:Templates]] | [[Category:Templates]] | ||
[[Category:Templates documentation]] | [[Category:Templates documentation]] | ||
Latest revision as of 17:37, 23 July 2020
The {{quote}} formats block quotations and provides a wrapper with decorative marks for the HTML <blockquote> element.
This template should not be used for block quotations in article text. Quotes work best when used with short sentences, and at the start or end of a section, as a hint of or to help emphasize the section’s content.
Usage
Usage
{{quote|text=text|source=source}}
{{quote}} adds a block quotation to an article page. This is easier to type and is more wiki‐like than the equivalent HTML <blockquote>…</blockquote> tags, and has additional pre‐formatted attribution parameters for author and source. Block quotes do not normally contain quotation marks.
Parameters
|quote=or|1=- The material being quoted, without quotation marks around it.
|source=or|2=- Optional speaker or source information to display that will appear below the quotation, and preceded with an attribution dash.
Examples
| Markup | Renders as |
|---|---|
{{quote|Quoted material.}}
|
|
{{quote|text=Quoted material.|source=Source material}}
|
|
{{quote|Quoted material.|Source material}}
|
|
Limitations
If you do not provide text, the template generates a parser error message, which will appear in red text in the rendered page.
If any parameter’s actual value contains an equals sign “=”, you must use a named parameter (e.g. |text=“E=MC2”), not a blank‐name positional parameter. The text before the equals sign gets misinterpreted as a named parameter otherwise. Be wary of URLs, which frequently contain this character. Named parameters are always safer, in this and other templates.