Template:Quote/doc

From PortlandWiki
Jump to navigation Jump to search

This documentation subpage contains instructions, categories, or other information for technical reasons.
To view the Template page itself, see Template:Quote.

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 ShakespeareJulius 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, 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>.

As of February 2012, 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