Template:Talk quote block/doc: Difference between revisions
(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) |
Latest revision as of 22:23, 28 November 2020
This is a documentation subpage for Template:Talk quote block. It contains usage information, categories and other content that is not part of the original template page. |
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.
|
Right way
{{talk quote block| * Item one * Item two }} |
All items are bulleted correctly:
Page Template:Talk quote block/styles.css has no content.
|
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.
|
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.
|
Caveats
Complex formatting compatibility
- Check § Quoting lists, and Help:Table § Nested tables (for nesting demo).
- Template:Tq2
- 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]) - Template:Tq2
See also
Template:Inline talk templates