Template:Quote/doc
Usage
{{Quote}} adds a block quotation to an article page.
This is easier to type and more wiki-like than the equivalent HTML <blockquote>...</blockquote>
tags, and has additional pre-formatted attribution and source parameters.
Note: Block quotes do not normally contain quotation marks. See MOS:QUOTE.
Synopsis
- Unnamed (positional) parameters
{{quote|phrase|person|source}}
This markup will fail if any parameter contains an equals sign (=).
- Numbered (positional) parameters
{{quote|1=phrase|2=person|3=source}}
- Named parameters
{{quote|text=phrase|sign=person|source=source}}
Example
- Wikitext
{{Quote|text=Cry "Havoc" and let slip the dogs of war.|sign=[[William Shakespeare]]|source=''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I}}
- Result
Cry "Havoc" and let slip the dogs of war.—William Shakespeare, Julius Caesar, Act III, Scene I
Restrictions
If you do not provide quoted 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 named parameters. (The equals sign gets interpreted as a named parameter otherwise.)
If any parameter's actual value contains characters used for wiki markup syntax (such as pipe, brackets, single quotation marks, etc.), you may need to escape it. See Template:! and friends.
Be wary of URLs which contain restricted characters. The equals sign is especially common.
Multiple paragraphs
Due to the utterly intractable MediaWiki bug reported at Bugzilla: 6200, and still unfixed as of February 2012[update], block quoting on Wikipedia, with or without a template, cannot handle freeform linebreaking for paragraphs and poems and the like, unless formatted one very specific (and annoying) way. It's not a problem of blockquote templates, but all uses of <blockquote>
.
The problem in action: test cases that seem like they should work but fail |
---|
The intuitive choice:
results in the mangled:
Blank lines seem to work at first:
though with quite tall spacing between the content blocks (lines, in our test cases):
Yet this markup fails with wiki ":" indentation:
Line 2 Line 3 Line 4Just trying to use
results in odd spacing, with the middle blocks too close together:
Meanwhile this version seems okay at first:
but again can't be indented:
Line 2 Line 3 Line 4 |
As of February 2012[update], the only solution for the problem is to use unbroken markup with <p>...</p>
or <br />
elements (or others, like nested blockquotes and lists):
- {{quote|Line 1<br/>Line 2<br/>Line 3<br/>Line 4.}}
which, while hard to read, especially for long content, results in the expected:
Line 1
Line 2
Line 3
Line 4.
And it does work with wikimarkup ":" indentation, unlike the failed test cases above:
- Line 1
Line 2
Line 3
Line 4.
Happily, there is an HTML-comment workaround for readability that lets you do whatever you want:
{{Quote|1=<!--
-->Line 1<br/><!--
-->Line 2<br/><!--
-->Line 3<br/><!--
-->Line 4.}}
or even:
{{Quote|1=<!--
-->Line 1<br/><!--
-->Line 2<br/><!--
-->Line 3<br/><!--
-->Line 4.}}
which results in the expected:
Line 1
Line 2
Line 3
Line 4.
They are indentable:
- Line 1
Line 2
Line 3
Line 4.
See also
- Template:Bq – quote without border, page-wide; like (and compatible with parameters of) the older {{Quote}} but with more features; conversion from all others listed here is trivially easy (retaining key data, losing decoration, etc.)
- Template:Quote – quote without border, page-wide, smaller-sized attribution
- Template:Quotation – quote with border, page-wide
- Template:Quote box – quote with border, in a reduced floating box
- Template:Cquote – pull-quote between large quotation marks, page-wide; should rarely be used in articles and is not for block quotations, only pull quotes
- Template:Rquote – pull-quote between large quotation marks, in a reduced floating area; also rarely appropriate in articles
- Template:Talkquote – for quoting other editors (or guidelines, etc.) on talk pages (in a block)
- Template:Tq - for quoting on talk pages, inline
- Category:Quotation templates