Template:Blockquote/doc

Usage
adds a block quotation to an article page.

This is easier to type and is more wiki-like than the equivalent HTML  tags, and has additional pre-formatted attribution and source parameters.

Note: Block quotes do normally contain quotation marks. See MOS:Blockquote.

Synopsis

 * Basic use:


 * Typical uses:



Parameters
text a.k.a. 1 The material being quoted, without quotation marks around it. It is always safest to name this parameter (rather than use an unnamed positional parameter), because any inclusion of the = character (e.g. in a URL in a source citation) will otherwise break the template.

author a.k.a. 2 Attribution information that will appear below the quotation.

source a.k.a. 3 Title of the major work the quote appears in. This parameter (which immediately follows the output of author) is rarely used, and auto-italicizes all content within it. It is used for the title (alone) of a book, periodical, filmic work, stage production or the like, not for minor works.

Attribution
The source title in source is enclosed in , thus it shows italicized, due to a default style being applied to the element. Per MOS:TITLE, italicization of titles should only be done for major works (books, journals, albums, movies and TV series, plays or operas, etc.), not for minor works, which are enclosed in quotation marks (chapters, articles, songs, episodes, scenes or acts, etc.). , this unnecessary forced italicization has been reported to Mediawiki talk:Common.css, for removal. It is unknown when it will be fixed. In the interim, the following approach to quotation attribution is recommended:



If it is appropriate to include a full source citation at this point, it can be done like so:



If a full citation and an in-text attribution should appear:



Until the problem with is fixed, the source parameter has extremely limited application. After it is fixed, the entire authorsource block will likely be wrapped in , and the parameters may be merged.

Style
Styling is applied through CSS rules in MediaWiki:Common.css. HTML:

The variant of the template adds   to.

Limitations
If you do not provide text, the template generates a parser error message, which will appear in red text in the rendered page.

If any parameter's actual value contains an equals sign, you must use named parameters or a blank-name parameter, as:. (The text before the equals sign gets interpreted as a named parameter otherwise.)

If any parameter's actual value contains characters used for wiki markup syntax (such as pipe, brackets, single quotation marks, etc.), you may need to escape it. See Template:! and friends.

Be wary of URLs which contain restricted characters. The equals sign is especially common. Put a break (newline) after the template, or the next blank line might be ignored.

As noted above, the source parameter will forcibly italicize all content in it; this is often undesirable, in which case include the material in the author parameter.

Next to left-floated images
The variant template will work around a CSS bug, in which the block quotation does not indent if it is next to a left-floated image. , this problem and the fix for it has been reported to Mediawiki talk:Common.css. It is not known when this will be fixed. After it is fixed, this variant template can be replaced with the stock.

Vanishing quotes
In rare layout cases, e.g. when quotes are sandwiched between userboxes, a quotation may appear blanked out, in some browsers. The workaround for this problem is to add overflow:inherit; to such an instance of the template.

TemplateData
{	"description": "Adds a block quotation.", "params": { "text": { "label": "text", "description": "The text to quote", "type": "content", "required": true, "aliases": [ "1",				"quote" ],			"example": "Cry \"Havoc\" and let slip the dogs of war." },		"sign": { "label": "sign", "description": "The person being quoted", "type": "content", "required": false, "aliases": [ "2",				"cite", "author" ],			"example": "William Shakespeare", "suggested": true },		"source": { "label": "source", "description": "A source for the quote", "type": "content", "required": false, "aliases": [ "3"			],			"example": "Julius Caesar, act III, scene I", "suggested": true }	} }

Known problems
This template sets a text style which might ignore one blank line, and so the template must be ended with a break (newline). Otherwise, beware inline, as: More text here spans a blank line
 * text here "this is quoted"

Unless a "xx" is ended with a line break, then the next blank line might be ignored and two paragraphs joined.