Template:Quote frame/doc

From MattWiki
Jump to: navigation, search


This template is meant for pull quotes, the visually distinctive repetition of text that is already present 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 {{Quote}} template or the HTML <blockquote> 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, {{Pull quote}} provides a borderless quote with decorative quotation marks, and {{Quote frame}} provided a bordered quote. Both span the article width.
  • For very short pull quotes, {{Reduced pull quote}} (with decorative quotation marks) or {{Quote box}} (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.

Usage

This template provides a page-width-spanning quotation in a bordered box, on a light grey background. Do not put quotation marks around the quoted material.

Markup Renders as
{{Quote frame|Quoted material|Author|Title|other details}}
Quoted material — Author, Title, other details
{{Quote frame|Quoted material|Author||"Article Title", ''Newspaper Name''}}
Quoted material — Author, "Article Title", Newspaper Name
Here, the 3rd parameter (which auto-italicizes) has been skipped, and we use the 4th to manually apply italics where needed.
{{Quote frame|Quoted material|Author|Title}}
Quoted material — Author, Title
{{Quote frame|Quoted material}}
Quoted material
{{Quote frame|Quoted material|align=center}}
Quoted material

The equal sign (=)

If any of the parameters include an equal sign (=) in its input, this will make the template not recognize the parameter properly unless:

  • The parameters are numbered:

     {{Quote frame|1=Einstein's equation, E=mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|2=Abdul Kalam}}

  • The = in the content is escaped with the {{=}} template:

     {{Quote frame|Einstein's equation, E{{=}}mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|Abdul Kalam}}

  • The = in the content is escaped with the &#61; character entity:

     {{Quote frame|Einstein's equation, E&#61;mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|Abdul Kalam}}

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

TemplateData for Quote frame

insert description here

Template parameters

ParameterDescriptionTypeStatus
Quoted material1

Default
empty
Example
empty
Auto value
empty
Stringrequired
Author2

Default
empty
Example
empty
Auto value
empty
Stringoptional
Title3

Default
empty
Example
empty
Auto value
empty
Stringoptional
Publication4

Use and {{Cite book}} etc.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Alignmentalign

Alignment of the quote box on the page—left / right / center / none. Defaults to none alignment.

Default
empty
Example
empty
Auto value
empty
Stringoptional

Bugs

  • As of 28 November 2015 using {{quotation}} in a discussion that will later be archived with {{archive top}} and {{archive bottom}} will cause problems if the line in which the template is used in is intended with colons. In other words, avoid doing this if you expect the discussion to be archived using the "archive top" and "archive bottom" templates:
    :{{quotation|quoted material}}

Example of bug:

{{archive top}}
Some text here.
:{{quotation|quoted text}}
More text here.
{{archive bottom}}

results in:

The following discussion is closed. Please do not modify it. Subsequent comments should be made on the appropriate discussion page. No further edits should be made to this discussion.

Some text here.

quoted text

More text here.


The discussion above is closed. Please do not modify it. Subsequent comments should be made on the appropriate discussion page. No further edits should be made to this discussion.


See also