Template:Cquote/doc: Difference between revisions

more work on synching the pull quote templates' documentation
(normalizing the pull quote templates' documentation)
(more work on synching the pull quote templates' documentation)
Line 1:
{{Documentation subpage}}{{TOC right}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
 
{{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 &lt;[[blockquote]]&gt; element, for which that template provides a wrapper.
 
'''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 &lt;[[blockquote]]&gt; 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 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, {{tlx|Pull quote}} provides a borderless quote box spanning the page width.
* For very short pull quotes, consider using {{tl|Reduced pull quote}} whichcan be used to setsset 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 ==
'''For actual [[pull quotesquote]]s, 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.'''
 
===Syntax===
Anonymous user