Template:Talk quote block/doc

"Template:Talkquote" redirects here. For quoting inline, see Template:Talk quote inline.

Usage

Use {{Talk quote block}} or {{tqb}} (a.k.a. {{Talkquote}}, {{Talk quote}}, or {{tq2}}) to quote (another's comments, a policy statement, etc.) in a block, on talk pages and noticeboards. It can be safely used after colon-indenting as well (see the § Indenting example below ^{[§ Caveats]}). For a short inline quote, instead use {{Talk quote inline}} (a.k.a. {{Talk quotation}} or {{tq}}).

Parameters

Unnamed (positional) parameters

{{talk quote block|text|by}}

• The order of positional parameters cannot change - text must come before by.

Using named parameters

{{talk quote block|text=text|by=by|source=source|ts=ts|oldid=oldid}}

Explanation of named parameters:

• text (or 1): The text being quoted.
• by (or 2): The author of the text being quoted. A Wikipedia username is expected, and the username will be provided as a wikilink to the author's user page.
• source: The source of the text being quoted. Use instead of by when source is not individual user.
• ts: The timestamp of the edit whose text is being quoted. Hint: You can use five tildes to supply the current date and time: |ts=~~~~~.
• oldid: The revision ID of the edit introducing the change that was made. Displayed as the timestamp linking to the Diff of the edit. (requires ts parameter or is not shown)
• diff: The revision ID of the Diff comparing target.
• style: HTML in-line style. (see the testcases)

Examples

• {{talk quote block|some random text|Example}} gives:

some random text
— User:Example

• {{talk quote block|more random text|Example|ts=08:52, 21 May 2011 (UTC)}} gives:

more random text
— User:Example 08:52, 21 May 2011 (UTC)

• {{talk quote block|different random text|Example|ts=08:52, 21 May 2011 (UTC)|oldid=139992}} gives:

different random text
— User:Example 08:52, 21 May 2011 (UTC)

(Note: ts parameter must be present for oldid link to show)

Suggested boilerplate

{{tq2|1=<nowiki/>
|source=}}

{{tq2|1=<nowiki/>
|by=|ts=|oldid=}}

Indenting

The template works with standard talk page indentation, as the following example illustrates. This wiki-markup:

Random paragraph of text. [[User:Example|Example]] ([[User talk:Example|talk]]) 09:20, 21 May 2011 (UTC)
:Opening statement by [[User:User|Some other user]].
:{{talk quote block|Quoting an item from random paragraph.}}
:Response to quoted text. [[User:User|Some other user]] ([[User talk:User|talk]]) ~~~~~

...displays the following:

Random paragraph of text. Example (talk) 09:20, 21 May 2011 (UTC)

Opening statement by Some other user.

Quoting an item from random paragraph.

Response to quoted text. Some other user (talk) 09:26, 21 May 2011 (UTC)

Quoting lists

If the text you are quoting is a bulleted or numbered list, the first list item must start on a new line, or it won't be rendered properly. For example:

Wiki-markup	Output
Wrong way {{talk quote block|* Item one * Item two }}	First item isn't bulleted correctly: * Item one Item two
Right way {{talk quote block| * Item one * Item two }}	All items are bulleted correctly: Item one Item two

If you are using the |text= named parameter (as opposed to simply supplying your list as the first parameter) please add the following code: <nowiki /> after the = sign. The reason is that the MediaWiki parser automatically removes line breaks at the start of the text, causing the list to be displayed improperly otherwise. Example:

Wiki-markup	Output
Wrong way {{talk quote block|text= # Item one # Item two }}	First item isn't numbered correctly: # Item one Item two
Right way {{talk quote block|text=<nowiki /> # Item one # Item two }}	All items are numbered correctly: Item one Item two

Caveats

Complex formatting compatibility

1. Check § Quoting lists, and Help:Table § Nested tables (for nesting demo).
2. Template:Tq2
3. Due to MediaWiki's parsing limitations, embedding such templates into a list (using the leading */#/;/: syntax) is very likely to lead to unexpected results. (for it regards the newline as the syntax delimiter ^{[Help:List §§ Common mistakes, and Paragraphs and other breaks]})
4. Template:Tq2