Template:Talk quote block/doc: Difference between revisions

Jump to navigation Jump to search
(bolding likely intention (but why add this parameter instead of just stripping the pasted sig of excess dashes? isn't adding |nodash=y much more cumbersome?))
 
m (1 revision imported)
 
(No difference)

Latest revision as of 22:23, 28 November 2020

null

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:
Page Template:Talk quote block/styles.css has no content.

some random text
— User:Example

  • {{talk quote block|more random text|Example|ts=08:52, 21 May 2011 (UTC)}} gives:
Page Template:Talk quote block/styles.css has no content.

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:
Page Template:Talk quote block/styles.css has no content.

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.
Page Template:Talk quote block/styles.css has no content.

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:
Page Template:Talk quote block/styles.css has no content.

* Item one

  • Item two
Right way
{{talk quote block|
* Item one
* Item two
}}
All items are bulleted correctly:
Page Template:Talk quote block/styles.css has no content.
  • 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:
Page Template:Talk quote block/styles.css has no content.

# Item one

  1. Item two
Right way
{{talk quote block|text=<nowiki />
# Item one
# Item two
}}
All items are numbered correctly:
Page Template:Talk quote block/styles.css has no content.
  1. Item one
  2. 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


See also

Template:Inline talk templates