Template:Rquote/doc

This template is meant for pull quotes, the visually distinctive of text that is  on the same page. In most cases, this is not appropriate for use in encyclopedia articles. The Manual of Style guidelines for block quotations recommend formatting block quotations using the template or the HTML &lt;blockquote&gt; element, for which that template provides a wrapper.


 * Pull quotes work best when used with short sentences, and at the start or end of a section, as a hint of or to help emphasize the section's content.
 * For typical pull quotes, especially those longer than the rest of the paragraph in which they are quoted, provides a borderless quote with decorative quotation marks, and  provided a bordered quote. Both span the article width.
 * For very short pull quotes, (with decorative quotation marks) or  (framed) can be used to set the quote off to either the right or left as in a magazine sidebar.  This can be effective on essay pages and WikiProject homepages.

For a visually distinctive block quotation, use the template. Generally, do not mix-and-match styles in an article.

Usage
For actual pull quotes, this template, a variant of the, results in a floating quote with the article text wrapping around it, like an image. It is intended for relatively short pull quotes of 50 or 100 words.

Align quote box to the right:

Align quote box to the left:

It is always safest to explicitly number the parameters (the quoted text), since the presence of any  character in it will break the template if this parameter is not named/numbered.

Compact form
If you do not want to use numbered parameters, you must use compact form, without whitespace between parameters; MediaWiki parses the entire contents of unnamed parameters extremely literally, including whitespace.

Align quote box to the right (compact version):

Align quote box to the left (compact version):

If any parameter is numbered, all of them must also be numbered.

Parameters

 * 1) Alignment: "left" or "right" are acceptable values. This parameter is mandatory; there is no default.
 * 2) Text of quotation: Remember to use an explicit 2 if material contains a = character, or replace the = with =.
 * 3) Person (or other entity) being quoted: This should not be confused with the name of the author of the source who published the quotation. For example, imagine John Doe publishing in his blog a quotation from Albert Einstein. In that case, "Albert Einstein" is what should be put in this parameter. This parameter can be ignored.
 * 4) Citation (book, article, speech, etc.): A standard  citations normally go in this parameter.

Formatting
Quotation marks are supplied by the template and should not be included in the quote text. Soft hyphens can be used to influence line breaks within the quote text.

Limitations

 * 1) This template does not always "play nice" and wrap properly when it is on the left, especially when what immediately follows it is a heading or a list.
 * 2) If the quoted content is extremely short, this template looks terrible. The content needs to be at least reach to the other side of the template. If the content is shorter than that, use  with its float option.
 * 3) As noted above, if any parameter is explicitly numbered, they must all be numbered. If none are numbered, do not use any whitespace between them.

Code
