Vorlage:Cquote/Doku: Unterschied zwischen den Versionen
normalizing the pull quote templates' documentation
K (self-rv) |
(normalizing the pull quote templates' documentation) |
||
| Zeile 3: | Zeile 3: | ||
{{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 <[[blockquote]]> element, for which that template provides a wrapper. | |||
This template is meant for [[pull quote]]s, the visually distinctive | |||
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. | '''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.}}. | * {{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). | * 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 the | * 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 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=== | ===Syntax=== | ||