Template:Cquote/doc: Difference between revisions

Nothing to hide, but nothing to show you either.
Jump to navigation Jump to search
Content added Content deleted
mNo edit summary
(Clarify how to use and cite a source)
Line 1: Line 1:
<includeonly>{{mergefrom|Cquotetxt}}</includeonly><noinclude>{{documentation subpage}}</noinclude>{{-}}{{interwikitmp-grp|wsp=|cms=}}
<includeonly>{{mergefrom|Cquotetxt}}</includeonly><noinclude>{{documentation subpage}}</noinclude>{{-}}{{interwikitmp-grp|wsp=|cms=}}{{TOCright}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->


'''{{tl|Cquote}}''' is a template meant for [[pull-quote]]s, which stand apart from the text of a page. It generally should not be used in articles unless there is a good justification for doing so. Pull-quotes work best when used with short quotes, and at the start or end of a section, to help emphasize the content of the section. For shorter pull-quotes of 50 words or fewer in a similar style, consider using {{tl|Rquote}}.
'''{{tl|Cquote}}''' (for ''''''Centered pull-quote'''''') is a template meant for [[pull-quote]]s, which stand apart from the text of a page.

* It generally should not be used in articles unless there is a good justification for doing so.
* Pull-quotes work best when used with short quotes, and at the start or end of a section, to help emphasize the content of the section.
* For shorter pull-quotes of 50 words or fewer in a similar style, consider using {{tl|Rquote}} which sets the quote off to either the right or left as in a magazine [[sidebar]].


'''NOTE''': This template should '''not be used''' for [[block quote]]s in article text. For long quotations in the text, the [[Wikipedia:Manual of Style#Quotations|Manual of Style]] recommends using the HTML &lt;[[blockquote]]&gt; element, such as through the use of the {{tl|Quote}} template.
'''NOTE''': This template should '''not be used''' for [[block quote]]s in article text. For long quotations in the text, the [[Wikipedia:Manual of Style#Quotations|Manual of Style]] recommends using the HTML &lt;[[blockquote]]&gt; element, such as through the use of the {{tl|Quote}} template.
Line 9: Line 13:
# <code><nowiki>{{cquote|quote text}}</nowiki></code>
# <code><nowiki>{{cquote|quote text}}</nowiki></code>
# <code><nowiki>{{cquote|quote text|quotewidth=40px|quoteheight=40px}}</nowiki></code> or <code><nowiki>{{cquote|quote text|40px|40px}}</nowiki></code>
# <code><nowiki>{{cquote|quote text|quotewidth=40px|quoteheight=40px}}</nowiki></code> or <code><nowiki>{{cquote|quote text|40px|40px}}</nowiki></code>
# <code><nowiki>{{cquote|quote text|quote width in pixels|quote height in pixels|Origin of quote|Cited source}}</nowiki></code>
# <code><nowiki>{{cquote|quote text|quote width in pixels|quote height in pixels|Origin of quote|Cited source}}</nowiki></code>{{i}}which is to say:
{{ibull}}title of article or book is same as Origin of quote{{ibull}}author is same as Cited source

;Only the first parameter is required.
:But since sizes are slotted into the second and third parameter places by default, to cite a source one must deliberately define dummy parameters for those (abusing the template logic which expects numbers), or explicitly define the source publication and author as 4= and 5= respectively (using them as named parameters&mdash;the preprocessor takes such fine):


Only the first parameter is required.


{{cquote|Publishers of English classics for the educational trade, [[Harrap]] was also known for publishing finely illustrated books by Rackham, Gooden, and others, and as the publisher of Winston Churchill.
|4=this is four
|5=this is five}}
;
which is generated by{{!:}}:&nbsp;
<pre>
{{cquote|Publishers of English classics for the educational trade, [[Harrap]] was also known for publishing finely illustrated books by Rackham, Gooden, and others, and as the publisher of Winston Churchill.
|4=this is four
|5=this is five}}
</pre>
==Parameters==
==Parameters==
* Parameter 1: text of the quote; use <code><nowiki><br /></nowiki></code> between paragraphs.
* Parameter 1: text of the quote; use <code><nowiki><br /></nowiki></code> between paragraphs.

Revision as of 17:32, 9 March 2009

Template:Interwikitmp-grpTemplate:TOCright

{{Cquote}} (for 'Centered pull-quote') is a template meant for pull-quotes, which stand apart from the text of a page.

  • It generally should not be used in articles unless there is a good justification for doing so.
  • Pull-quotes work best when used with short quotes, and at the start or end of a section, to help emphasize the content of the section.
  • For shorter pull-quotes of 50 words or fewer in a similar style, consider using {{Rquote}} which sets the quote off to either the right or left as in a magazine sidebar.

NOTE: This template should not be used for block quotes in article text. For long quotations in the text, the Manual of Style recommends using the HTML <blockquote> element, such as through the use of the {{Quote}} template.

Usage

  1. {{cquote|quote text}}
  2. {{cquote|quote text|quotewidth=40px|quoteheight=40px}} or {{cquote|quote text|40px|40px}}
  3. {{cquote|quote text|quote width in pixels|quote height in pixels|Origin of quote|Cited source}}Template:Iwhich is to say:

Template:Ibulltitle of article or book is same as Origin of quoteTemplate:Ibullauthor is same as Cited source

Only the first parameter is required.
But since sizes are slotted into the second and third parameter places by default, to cite a source one must deliberately define dummy parameters for those (abusing the template logic which expects numbers), or explicitly define the source publication and author as 4= and 5= respectively (using them as named parameters—the preprocessor takes such fine):


which is generated byTemplate:!:

{{cquote|Publishers of English classics for the educational trade, [[Harrap]] was also known for publishing finely illustrated books by Rackham, Gooden, and others, and as the publisher of Winston Churchill.
|4=this is four
|5=this is five}} 

Parameters

  • Parameter 1: text of the quote; use <br /> between paragraphs.
Required
Note: if the quote text contains one or more "=" (equal signs), then the template must be called as {{cquote|1=quote text}} (see "Equals sign in parameter value")

The next two parameters can be used to scale the graphical quotation marks up and down to suit larger or smaller quotes.

  • Parameter 2: "quotewidth" - desired width of the quote image; defaults to 20px. (anything larger than 48px is not recommended.)
  • Parameter 3: "quoteheight" - desired height of the quote image; defaults to 20px.

The last two parameters can be used to provide attribution for the quote:

  • Parameter 4: Name of the person that wrote or spoke the text being quoted. Can include links.
Note: if the text contains one or more "=" (equal signs), then the template must be called as {{cquote|4=text}}
  • Parameter 5: Source of the quote (publication title, speech, etc.). Can include links.
Note: if the text contains one or more "=" (equal signs), then the template must be called as {{cquote|5=text}}

Examples

{{cquote|quote text}}

As Amy Tan once said

{{cquote|1=quote text}} (quote text contains an equal sign)
{{cquote|quote text|40px|40px}}
{{cquote|quote text|30px|30px|Origin of quote|Cited source}}

For example,

{{cquote|And when they've given you their all / Some stagger and fall, after all it's not easy / Banging your heart against some mad bugger's wall.|30px|30px|[[Pink Floyd]]|''[[The Wall]]''}}

is rendered as

Example with ref tags:

{{cquote|You don't get everything you want. A dictatorship would be a lot easier.|200|50|George W. Bush<ref>http://www.governing.com/archive/1998/jul/bush.txt</ref>}}


See also

Direct variants:

Template:Quotation templates see also