Vorlage:Cquote/Doku: Unterschied zwischen den Versionen

more work on synching the pull quote templates' documentation
(normalizing the pull quote templates' documentation)
(more work on synching the pull quote templates' documentation)
Zeile 1: Zeile 1:
{{Documentation subpage}}{{TOC right}}
{{Documentation subpage}}{{TOC right}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{warning|'''NOTE''': This template should '''not be used''' for block quotations in article text.}}
{{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.
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.
* 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 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 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, {{tl|Reduced pull quote}} can be used to set 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.
For a visually distinctive block quotation, use the {{tlx|Quotation}} templates. Generally, do not mix-and-match styles in an article.


==Usage==
== Usage ==
For actual [[pull quote]]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===
===Syntax===
Anonymer Benutzer