Template:Talk quote block/doc

Use or  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.

Usage
Unnamed (positional) parameters:
 * The order of positional parameters cannot change - text must come before by.
 * The order of positional parameters cannot change - text must come before by.

Named parameters:

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:.
 * id: The ID of the comment that will be used in a link to it if the ts parameter is also present. You can copy it by right-clicking the timestamp.
 * 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 or is not shown).
 * diff: The link to the diff comparing target.
 * style: HTML in-line style. (see the testcases)
 * y or y: Suppresses the em dash and space before source, for when pasting a sig that already starts with a dash.
 * y or y: Suppresses the link to the author to avoid notifying them.

Examples

 * gives: 
 * gives: 
 * gives: 
 * gives: 

Note: ts must be present for oldid link to show.

Indenting
The template works with standard talk page indentation, as the following example illustrates. This wiki-markup:

Displays the following:  Random paragraph of text. Example (talk) 09:20, 21 May 2011 (UTC)
 * Opening statement by Some other user.
 * Response to quoted text. Some other user (talk) 09:26, 21 May 2011 (UTC)
 * Response to quoted text. Some other user (talk) 09:26, 21 May 2011 (UTC)

Indented multi-line quote
To create an indented multi-line quote (such as within a a reply on a talk page), you must use  tags to indicate the line breaks, but do not use manual line breaks. Refer to the following example:

Displays the following:  Random paragraph of text. Example (talk) 09:20, 21 May 2011 (UTC)
 * Opening statement by Some other user.
 * Response to quoted text. Some other user (talk) 09:26, 21 May 2011 (UTC)
 * 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:

If you are using the text named parameter (as opposed to simply supplying your list as the first parameter) please add the following code:  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:

Complex formatting compatibility
Check, and (for nesting demo).

Quoted URLs with query strings break the template
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, so that your entire argument is unambiguously parsed as the value being assigned to that parameter.

Writing the transclusion as 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   that's being assigned the value.

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

Play nice with ordered and unordered lists




TemplateData
{	"params": { "style": { "description": "HTML in-line style." },		"text": { "aliases": [ "1"			],			"description": "The text being quoted.", "type": "content", "required": true },		"by": { "aliases": [ "2"			],			"description": "The author of the text being quoted.", "type": "wiki-user-name", "suggested": true },		"source": { "description": "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.", "type": "line" },		"nodash": { "aliases": [ "no-dash" ],			"label": "No dash?", "description": "Suppresses the em dash and space before source, for when pasting a sig that already starts with a dash.", "type": "boolean" },		"ts": { "label": "Timestamp", "description": "The timestamp of the edit whose text is being quoted.", "suggestedvalues": [ ""			],			"suggested": true },		"id": { "label": "ID", "description": "The ID of the comment that will be used in a link to it if the ts parameter is also present. You can copy it by right-clicking the timestamp.", "type": "string" },		"oldid": { "label": "Revision ID", "description": "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)", "type": "number" },		"diff": { "description": "The link to the diff comparing target.", "type": "number" },		"noping": { "aliases": [ "no-ping" ],			"label": "No ping?", "description": "Suppresses the link to the author to avoid notifying them.", "type": "boolean" }	},	"description": "Formats quoted text (from another's comments, a policy statement, etc.) in a block, for use on talk pages and noticeboards.", "paramOrder": [ "text", "by", "source", "nodash", "ts", "id", "oldid", "diff", "style", "noping" ] }