Template:Quote/doc/boilerplate: Difference between revisions

From Zoophilia Wiki
Jump to navigationJump to search
meta>SMcCandlish
Rewrite to actually follow MOS:BQ and the RfC, and to highlight COPYVIO, CITE and other points. Herostratus's change to this text made it say the opposite of what consensus actually is (for typical quotes, use {{Quote}}), and the description was that of pull quotes (which WP deprecates – the entire point of the RfC!), not block quotations. Argh. No wonder abuse of these templates actually increased after the RfC, the opposite of the intended effect.
Ookami (talk | contribs)
m 35 revisions imported
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{#ifeq:{{{mos-recommended}}}|yes||{{warning|This template should {{strong|not be used}} for block quotations in article text.}}}}
<includeonly>{{#if:{{{mos-recommended|}}}||</includeonly>{{warning|This template should {{strong|not be used}} for block quotations in article text.}} <includeonly>}}</includeonly>
==General usage of block quotations in 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.
{{section link|WP:Manual of Style#Block quotations}} calls for formatting block quotations using the {{tlx|Quote}} template (or the underlying {{tag|blockquote|o|link=y}} HTML element).
* Block-quotation markup of any kind is used only for substantial material (multiple sentences, or a very long sentence).  {{strong|Short quotations are given inline}} with the rest of the material. see [[WP:Manual of Style#Quotations]] for more information.
* Quotations work best when concise and highly relevant, and preceded by {{strong|context establishing who is being quoted}}.
* {{strong|Wikipedia does not use [[pull quotes]]}} – magazine-style highlighting of quotations at the start or end of a section, as a hint (teaser) of forthcoming content or to emphasize a particular section.
* {{strong|Avoid undue emphasis}}: Typical block quotations in mainspace (articles) use normal block-quotation markup as described above.  Several templates provide alternative formatting options, but usually {{em|are not appropriate}} in articles, where they look like pull quotes and result in [[WP:UNDUE|undue emphasis]] on a particular party's statement. However, they can be effective on [[WP:ESSAY|essay]] pages, [[WP:WIKIPROJECT|wikiproject]] pages, and [[WP:USERPAGE|user pages]].
** {{tlx|Quote frame}} provides a bordered quote with a faint background shade, defaulting to the article width, but resizable and usable as a left or right [[Sidebar (publishing)|sidebar]]. {{Tlx|Quote box}} also does this, and is likely to merge into the former.  This style can be appropriate for {{em|document excerpts}} in an article (serving a function similar to an illustration but with textual content for analysis in the article). When used around an individual or organizational quotation, it usually results in undue emphasis.
** {{tlx|Cquote}} provides a borderless quote with decorative quotation marks, spanning the article width; {{tlx|Rquote}} is a resizable variant usable as a sidebar (and it may also get merged).  A reasonable use in mainspace is around {{em|famous quotations}} that are the subjects of their own sections.  Using this style in articles for general block quotations usually also results in undue emphasis.
** There are [[:Category:Enhanced quote templates|several other variants]] for specialized layout situations, mostly for the user and project namespaces.
** Inappropriate use of decorative, emphasizing quotation templates in articles should be converted to {{tlx|Quote}}. This may require creating a proper introduction for the quotation, to merge it into the article flow, as misuses of these templates tend to be isolated {{lang|la|non sequitur}} pull quotes.
* {{strong|Attribution and citations}}: In articles, attribution is almost always in the introductory line before the quotation, which is also where the [[WP:CITE|reference citation]] goes (it it is not part of the quoted material).  The templates' attribution parameters are typically only of use in a sidebar or (outside of mainspace) in a pull quote.  A common mistake is to attribute and cite in the intro sentence, then do it again in the template, just to try to use more template parameters.  If the attribution parameters {{em|are}} used, then the reference citation goes at the end of them.
* {{strong|Follow [[WP:COPYRIGHT|copyright policy]]}}; block quotation templates are not for excerpting excessive amounts of text from sources.
* Block quotations are only for quoted material.  {{strong|To indent non-quotations}}, see {{tlx|Block indent}}.


<noinclude>
* 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 quotes, especially those longer than the rest of the paragraph in which they are quoted, {{tlx|Cquote}} (for use outside of article space only) provides a borderless quote with decorative quotation marks, and {{tlx|Quote frame}} provides a bordered quote. Both span the page width.
* For very short quotes, {{tlx|Rquote}} (with decorative quotation marks, for use outside of article space only) or {{tlx|Quote box}} (framed) 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.<noinclude>
{{Documentation|content=This is shared documentation verbiage transcluded into the /doc pages of everything in [[:Category:Enhanced quote templates]].}}</noinclude>
{{Documentation|content=This is shared documentation verbiage transcluded into the /doc pages of everything in [[:Category:Enhanced quote templates]].}}</noinclude>

Latest revision as of 04:23, 3 September 2020

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.

  • 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 quotes, especially those longer than the rest of the paragraph in which they are quoted, {{Cquote}} (for use outside of article space only) provides a borderless quote with decorative quotation marks, and {{Quote frame}} provides a bordered quote. Both span the page width.
  • For very short quotes, {{Rquote}} (with decorative quotation marks, for use outside of article space only) 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.