Jump to content

Template:Talk quote block/doc: Difference between revisions

From pool
[checked revision][checked revision]
Content deleted Content added
No edit summary
 
Line 6: Line 6:
<!-- Categories and interwikis go at the bottom of this page. -->
<!-- Categories and interwikis go at the bottom of this page. -->
=== Usage ===
=== Usage ===
Use {{tnull|Talk quote block}} or {{tnull|tqb}} (a.k.a. {{tnull|Talkquote}}, {{tnull|Talk quote}}, or {{tnull|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|§ Indenting]] example below <sup>&#x5B;[[#Caveats|§ Caveats]]]</sup>). For a short inline quote, instead use {{tlx|Talk quote inline}} (a.k.a. {{tlx|Talk quotation}} or {{tlx|tq}}).
Use {{tnull|Talk quote block}} or {{tnull|tqb}} (a.k.a. {{tnull|Talkquote}}, {{tnull|Talk quote}}, or {{tnull|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|§ Indenting]] example below ). For a short inline quote, instead use {{tlx|Talk quote inline}} (a.k.a. {{tlx|Talk quotation}} or {{tlx|tq}}).




Line 17: Line 17:
: Explanation of named parameters:
: Explanation of named parameters:
:*'''text''' (or '''1'''): The text being quoted.
:*'''text''' (or '''1'''): The text being quoted.
:*'''by''' (or '''2'''): The author of the text being quoted. A [[WP:U|Wikipedia username]] is expected, and the username will be provided as a [[WP:Link|wikilink]] to the author's user page.
:*'''by''' (or '''2'''): The author of the text being quoted. A [[Wikipedia:WP:U|Wikipedia username]] is expected, and the username will be provided as a [[Wikipedia:WP:Link|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.
:*'''source''': The source of the text being quoted. Use instead of ''by'' when source is not individual user.
:*'''ts''': The [[WP:Timestamp|timestamp]] of the edit whose text is being quoted. Hint: You can use [[WP:5TILDES|five tildes]] to supply the current date and time: <code><nowiki>|ts=~~~~~</nowiki></code>.
:*'''ts''': The [[Wikipedia:WP:Timestamp|timestamp]] of the edit whose text is being quoted. Hint: You can use [[Wikipedia:WP:5TILDES|five tildes]] to supply the current date and time: <code><nowiki>|ts=~~~~~</nowiki></code>.
:*'''oldid''': The [[WP:Revision id|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)
:*'''oldid''': The [[Wikipedia:WP:Revision id|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 [[Help:Diff|Diff]] comparing target.
:*'''diff''': The revision ID of the [[Wikipedia:Help:Diff|Diff]] comparing target.
:*'''style''': [[HTML]] in-line style. (see the [[Template:Talk_quote_block/testcases#Parameter_"style"|testcases]])
:*'''style''': [[Wikipedia:HTML|HTML]] in-line style. (see the [[Wikipedia:Template:Talk_quote_block/testcases#Parameter_"style"|testcases]])





Latest revision as of 17:44, 21 October 2020

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 ). 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

  1. Item two
Right way
{{talk quote block|text=<nowiki />
# Item one
# Item two
}}
All items are numbered correctly:
  1. Item one
  2. Item two


See also

For more detail see wikipedia page wikipedia:Template:Talk quote block