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 name, or when copy-pasting an entire sig.
• 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)
• nodash=y or no-dash=y: Suppresses the em dash and space before source, for when pasting a sig that already starts with a dash

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. Quoted URLs with query strings break the template

   ...

   {{tq2|This here diff: https://en.wikipedia.org/w/index.php?title=User:IamNotU/sandbox&diff=904787385&oldid=904785977}}
   

   Doesn't display at all:

   
   — User:IamNotU 15:12, 4 July 2019 (UTC)

   When your template arguments contain an equals sign, you can't use implicit positional parameters because everything preceding the first equals sign gets parsed as the parameter name. The trick, in those situations, is to make the assignment explicit, so that your entire argument is unambiguously parsed as the value being assigned to that parameter.

   
   IOW:

   {{tq2|1=This here diff: https://en.wikipedia.org/w/index.php?title=User:IamNotU/sandbox&diff=904787385&oldid=904785977}}
   

   This here diff: https://en.wikipedia.org/w/index.php?title=User:IamNotU/sandbox&diff=904787385&oldid=904785977

   
   

   Writing the transclusion as {{tq2|1=...}} puts the entire URL on the right-hand side of an assignment to the first unnamed parameter, rather than it being parsed as a template parameter named This here diff: https://en.wikipedia.org/w/index.php?title that's being assigned the value User:IamNotU/sandbox&diff=904787385&oldid=904785977.
   — User:FeRDNYC 16:25, 5 July 2019 (UTC)

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. Play nice with ordered and unordered lists

   • Lorem ipsum

   Is there a way to get this template to function when used at the beginning of a list item? For instance * {{talkquote|Lorem ipsum}} will turn the bullet (or number) into a regular indent, rather than showing the bullet/number. It's fine if you put something between the bullet and template, but it'd be nice if it didn't need the hack.
   — User:Czar 23:05, 6 February 2017 (UTC)

   As you can see by your own example above, this is now fixed. (It was fixed some time ago, I'm not sure exactly when.) Lists now play nicely with the {{tq}} templates, or vice versa. You can even colon-indent them on Talk pages, now!

   I suspect the colon-indenting was the real motivation for fixing this.
   — FeRDNYC (talk) 14:31, 6 July 2019 (UTC)

   
   — User:FeRDNYC 14:31, 6 July 2019 (UTC)

   :::: {{tqb|I suspect the colon-indenting was the ''real'' motivation for fixing this.|source=[[User:FeRDNYC|FeRDNYC]] ([[User talk:FeRDNYC|talk]]) 14:31, 6 July 2019 (UTC)}}
   

   
   
   

   Ordered list, named parameter with nowiki, colon-indented following lorem ipsum paragraph

   Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Item one Item two — {{Talk quote block}}

   
   — Template:Talk quote block/testcases

   : {{Talk quote block|source={{tlx|Talk quote block}}|text=<nowiki />
   # Item one
   # Item two
   }}
   

   
   

   <dl><dd>{{tq2|1=<nowiki/>
   # Item one
   # Item two|source={{tlx|Talk quote block}}}}</dd></dl>
   

   1. Item one
   2. Item two
      — {{Talk quote block}}

   
   — The hack

TemplateData

Formats quoted text (from another's comments, a policy statement, etc.) in a block, for use on talk pages and noticeboards

Template parameters

Parameter		Description	Type	Status
text	text 1	The text being quoted	Content	required
by	by 2	The author of the text being quoted	User	suggested
source	source	The source of the text being quoted. Use instead of by when source is not individual user name, or when copy-pasting an entire sig.	Line	optional
No dash?	nodash no-dash	Suppresses the em dash and space before source, for when pasting a sig that already starts with a dash	Boolean	optional
Timestamp	ts	The timestamp of the edit whose text is being quoted Suggested values ~~~~~	Unknown	suggested
Old ID	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)	Number	optional
diff	diff	The revision ID of the Diff comparing target.	Number	optional
style	style	HTML in-line style.	Unknown	optional