Template:Cquote/doc: Difference between revisions

normalizing the pull quote templates' documentation
m (self-rv)
(normalizing the pull quote templates' documentation)
Line 3:
{{warning|'''NOTE''': This template should '''not be used''' for block quotations in article text.}}
 
This template is meant for [[pull quote]]s, the visually distinctive ''{{em|repetition''}} of text that is ''{{em|already present''}} on the same page. In most cases, this is not appropriate for use in encyclopedia articles. The [[Wikipedia:Manual of Style#Block quotations|Manual of Style guidelines for block quotations]] recommend formatting block quotations using the {{tlx|Quote}} template or the HTML <[[blockquote]]> element, for which that template provides a wrapper.
==Usage==
This template is meant for [[pull quote]]s, 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 [[Wikipedia:Manual of Style#Block quotations|Manual of Style guidelines for block quotations]] recommend formatting block quotations using the {{tlx|Quote}} template or the HTML <[[blockquote]]> element.
 
'''For actual pull quotes, this template provides a centered, borderless pull quote, with scalable decorative quotation marks, and optional attribution of the source of the quote. It can be used with or without the names of the parameters.'''
 
* {{strong|NOTE: This template should {{em|only}} be used for short pull quotes, which repeat quoted text already appearing in the article, and {{em|never}} for block quotations.}}.
* The [[Wikipedia:Manual of Style#Block quotations|Manual of Style guidelines for block quotations]] recommend formatting block quotations using the HTML <[[blockquote]]> element (which can be done with the {{tl|quote}} or {{tl|quote box}} quotation templates).
* Pull quotes work best when used with short sentences, and at the start or end of a section, as a hint of theor followingto help emphasize the section's content.
* For very short pull quotes, consider using {{tl|Reduced pull quote}} which sets the quote off to either the right or left as in a magazine [[Sidebar (publishing)|sidebar]]. This can be effective on [[WP:ESSAY|essay]] pages and [[WP:WIKIPROJECT|WikiProject]] homepages.
 
For a visually distinctive block quotation, use the {{tlx|Quotation}} templates. Generally, do not mix-and-match styles in an article.
 
==Usage==
 
===Syntax===
Anonymous user