Editing Template:Talk quote block/doc (section)

== Examples ==
* {{tlx|Talk quote block|some random text|Example}} gives: <div style="background-color: var(--background-color-neutral-subtle, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:10px 10px">{{talk quote block|some random text|Example}}</div>
* {{tlx|Talk quote block|more random text|Example|ts{{=}}08:52, 21 May 2011 (UTC)}} gives: <div style="background-color: var(--background-color-neutral-subtle, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:10px 10px">{{talk quote block|more random text|Example|ts=08:52, 21 May 2011 (UTC)}}</div>
* {{tlx|Talk quote block|Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.|Example User|ts{{=}}08:52, 21 May 2011 (UTC)|id{{=}}c-Example_User-20240604182100-Example}} gives: <div style="background-color: var(--background-color-neutral-subtle, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:10px 10px">{{talk quote block|Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.|Example User|ts=08:52, 21 May 2011 (UTC)|id=c-Example_User-20240604182100-Example}}</div>
* {{tlx|Talk quote block|different random text|Example|ts{{=}}08:52, 21 May 2011 (UTC)|oldid{{=}}139992}} gives: <div style="background-color: var(--background-color-neutral-subtle, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:10px 10px">{{talk quote block|different random text|Example|ts=08:52, 21 May 2011 (UTC)|oldid=139992}}</div>

Note: {{para|ts}} must be present for {{para|oldid}} link to show.

=== Suggested boilerplate ===
<syntaxhighlight lang="wikitext">
{{Talk quote block|1=<nowiki/>
|source=}}
</syntaxhighlight>

<syntaxhighlight lang="wikitext">
{{Talk quote block|1=<nowiki/>
|by=|ts=|id=}}
</syntaxhighlight>

<syntaxhighlight lang="wikitext">
{{Talk quote block|1=<nowiki/>
|by=|ts=|oldid=}}
</syntaxhighlight>

=== Indenting ===
The template works with standard talk page indentation, as the following example illustrates. This wiki-markup:
<syntaxhighlight lang="wikitext">
Random paragraph of text. [[User:Example|Example]] ([[User talk:Example|talk]]) 09:20, 21 May 2011 (UTC)
:Opening statement by [[User:Example2|Some other user]].
:{{talk quote block|Quoting an item from random paragraph.}}
:Response to quoted text. [[User:Example2|Some other user]] ([[User talk:Example2|talk]]) ~~~~~
</syntaxhighlight>

Displays the following:
<div style="background-color: var(--background-color-neutral-subtle, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:3px 10px 3px 10px">
Random paragraph of text. [[User:Example|Example]] ([[User talk:Example|talk]]) 09:20, 21 May 2011 (UTC)
:Opening statement by [[User:Example2|Some other user]].
:{{talk quote block|Quoting an item from random paragraph.}}
:Response to quoted text. [[User:Example2|Some other user]] ([[User talk:Example2|talk]]) 09:26, 21 May 2011 (UTC)
</div>

==== Indented multi-line quote ====
To create an indented multi-line quote (such as within a a reply on a talk page), you ''must'' use <nowiki><br/></nowiki> tags to indicate the line breaks, but do ''not'' use manual line breaks. Refer to the following example:
<syntaxhighlight lang="wikitext">
Random paragraph of text. [[User:Example|Example]] ([[User talk:Example|talk]]) 09:20, 21 May 2011 (UTC)
:Opening statement by [[User:Example2|Some other user]].
:{{talk quote block|Quoting an item from random paragraph.<br/>Including a second line.}}
:Response to quoted text. [[User:Example2|Some other user]] ([[User talk:Example2|talk]]) ~~~~~
</syntaxhighlight>

Displays the following:
<div style="background-color: var(--background-color-neutral-subtle, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:3px 10px 3px 10px">
Random paragraph of text. [[User:Example|Example]] ([[User talk:Example|talk]]) 09:20, 21 May 2011 (UTC)
:Opening statement by [[User:Example2|Some other user]].
:{{talk quote block|Quoting an item from random paragraph.<br/>Including a second line.}}
:Response to quoted text. [[User:Example2|Some other user]] ([[User talk:Example2|talk]]) 09:26, 21 May 2011 (UTC)
</div>

=== 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:
{| class="wikitable"
! Wiki-markup !! Output
|-
| '''Wrong way'''
<syntaxhighlight lang="wikitext">
{{talk quote block|* Item one
* Item two
}}
</syntaxhighlight>
| First item isn't bulleted correctly:
<div style="background-color: var(--background-color-base, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:3px 10px 3px 10px">
{{talk quote block|* Item one
* Item two
}}
</div>
|-
| '''Right way'''
<syntaxhighlight lang="wikitext">
{{talk quote block|
* Item one
* Item two
}}
</syntaxhighlight>
| All items are bulleted correctly:
<div style="background-color: var(--background-color-base, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:3px 10px 3px 10px">
{{talk quote block|
* Item one
* Item two
}}
</div>
|}

If you are using the {{para|text}} named parameter (as opposed to simply supplying your list as the first parameter) please add the following code: <code>&lt;nowiki /&gt;</code> after the <code>=</code> 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:
{| class="wikitable"
! Wiki-markup !! Output
|-
| '''Wrong way'''
<syntaxhighlight lang="wikitext">
{{talk quote block|text=
# Item one
# Item two
}}
</syntaxhighlight>
| First item isn't numbered correctly:
<div style="background-color: var(--background-color-base, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:3px 10px 3px 10px">
{{talk quote block|text=
# Item one
# Item two
}}
</div>
|-
| '''Right way'''
<syntaxhighlight lang="wikitext">
{{talk quote block|text=&lt;nowiki /&gt;
# Item one
# Item two
}}
</syntaxhighlight>
| All items are numbered correctly:
<div style="background-color: var(--background-color-base, #f8f9fa); color: inherit; border:1px dashed #3170ab; padding:3px 10px 3px 10px">
{{talk quote block|text=<nowiki />
# Item one
# Item two
}}
</div>
|}

=== Caveats ===
==== Complex formatting compatibility ====
Check {{section link||Quoting}}, and {{section link|Help:Table|Nested tables}} (for nesting demo).

==== Quoted URLs with query strings break the template ====
<syntaxhighlight lang="wikitext">
{{Talk quote block|This here diff: https://en.wikipedia.org/w/index.php?title=User:IamNotU/sandbox&diff=904787385&oldid=904785977}}
</syntaxhighlight>

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 {{em|explicit}}, so that your entire argument is unambiguously parsed as the value being assigned to that parameter.

<syntaxhighlight lang="wikitext">
{{Talk quote block|1=This here diff: https://en.wikipedia.org/w/index.php?title=User:IamNotU/sandbox&diff=904787385&oldid=904785977}}
</syntaxhighlight>
{{Talk quote block|1=This here diff: https://en.wikipedia.org/w/index.php?title=User:IamNotU/sandbox&diff=904787385&oldid=904785977}}

Writing the transclusion as {{tlx|Talk quote block|2=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 <syntaxhighlight lang="wikitext" inline>This here diff: https://en.wikipedia.org/w/index.php?title</syntaxhighlight> that's being assigned the value <syntaxhighlight lang="wikitext" inline>User:IamNotU/sandbox&diff=904787385&oldid=904785977</syntaxhighlight>.

Due to [[MediaWiki]]'s parsing limitations, embedding such templates into a [[Help:List|list]] (using the leading <code>*</code>/<code>#</code>/<code>;</code>/<code>:</code> syntax) is very likely to lead to unexpected results (for it regards the [[newline]] as the syntax delimiter [[Special:PermaLink/961705865#Common_mistakes|Help:List §§ Common mistakes]], and [[Special:PermaLink/961705865#Paragraphs_and_other_breaks|Paragraphs and other breaks]]).

==== Play nice with ordered and unordered lists ====
<syntaxhighlight lang="wikitext">
{{Lorem ipsum}}
: {{Talk quote block|source=Talk quote block|text=<nowiki/>
# Item one
# Item two
}}
</syntaxhighlight>

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

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

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