ଛାଞ୍ଚ:Quote box/doc

This is a documentation subpage for ଛାଞ୍ଚ:Quote box.
It may contain usage information, categories and other content that is not part of the original ଛାଞ୍ଚ page.

Usage

The {{quote box}} template allows you to easily put a quote (and its source) inside a box, with flexible control over bordering, background color, alignment, and other features. The box itself is floating div, which (like images) can appear on the right or left or across the entire page. Article text will wrap around the div in the first two cases. This is useful in articles that are short on images and need some graphic-like element, or where an important or interesting quote wants to be presented in a way that sets it off from the surrounding text.

Caution: This is a div-based template, and may break if indented using wikitext syntax. This is a current limitation of the Wikipedia HTML parsing software.

Parameters

Basic parameters

title = Optional title to appear at the top of the quote box.
quote = The quote or text to be displayed in the box.
source = Optional source of the quote (author, publication, etc.).

Main box styling

align: Alignment of the quote box on the page—left / right / center / none. Defaults to right alignment. Using align=none will remove word wrapping.
width: The width of the quote box. Defaults to the width of the quote included, unless |align=center where the width will default to 100%.
border: The width of the quote box border. Defaults to 1px. Remember to include 'px' or 'em' to specify the correct width.
fontsize: The fontsize of the quote box text. Defaults to 88%.
bgcolor: The RGB background color of the box. Defaults to #F9F9F9 (light gray).
style: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding parameters.

Title styling

title_bg: The RGB background color of the title. Defaults to #F9F9F9 (light gray).
title_fnt: The title font color. Defaults to black.
tstyle: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding title parameters.

Quote styling

qalign: Alignment of the quote element—left / right / center. Defaults to left.
qstyle: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding quote parameters.
quoted: If this parameter evaluates to true (is not 0, false, or empty) the quote box will enclose the quote in fat-quotes. Use judiciously, and read the Manual of Style.

Source styling

salign: Alignment of the source element—left / right / center. Defaults to the value of qalign.
sstyle: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding source parameters.

Full syntax

{{Quote box
 |title = 
 |quote = 
 |source = 
 |align = 
 |width = 
 |border = 
 |fontsize = 
 |bgcolor = 
 |style = 
 |title_bg = 
 |title_fnt = 
 |tstyle = 
 |qalign = 
 |qstyle = 
 |quoted = 
 |salign = 
 |sstyle = 
}}

Examples

Various example codes and their results. For more intricate examples see Template:Quote_box/examples.

Floating and wrapping

Minimal code, defaults to floating right and minimal width:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
}}
{{Lorem ipsum}}

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Floating right:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |width  = 50%
 |align  = right
}}
{{Lorem ipsum}}

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Floating left:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |width  = 50%
 |align  = left
}}
{{Lorem ipsum}}

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Centered (but not floating any more):

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |width  = 50%
 |align  = center
}}
{{Lorem ipsum}}

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Fat-quotes

Using fat-quotes:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |quoted = 1
}}

Cry "Havoc", and let slip the dogs of war.

“

”

William Shakespeare, Julius Caesar, Act III, Scene I.

Quote alignment

{{Quote box
 |title = Centered quote
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |qalign = center
}}

Centered quote

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

{{Quote box
 |title = Left title, right quote
 |tstyle = text-align: left;
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |source = [[William Shakespeare]], ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |qalign = right
}}

Left title, right quote

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Collapsing text

Sections of text can be collapsed by use of {{hidden begin}} and {{hidden end}}.

Markup

Renders as

{{quote box
| border=2px
| align=center
| bgcolor = Cornsilk
| font = Times
| title=<u>The Spider and the Fly</u>
| halign=center
| quote=<poem>
“Will you walk into my parlour?” said the Spider to the Fly,
 'Tis the prettiest little parlour that ever you did spy;
The way into my parlour is up a winding stair,
And I've a many curious things to shew when you are there.”
“''Oh no, no,''” said the little Fly, “''to ask me is in vain,''
''For who goes up your winding stair can ne'er come down again.''”
{{hidden begin}}
“I'm sure you must be weary, dear, with soaring up so high;
Will you rest upon my little bed?” said the Spider to the Fly.
“There are pretty curtains drawn around; the sheets are fine and thin,
And if you like to rest awhile, I'll snugly tuck you in!”
“''Oh no, no,''” said the little Fly,  “''for I've often heard it said,''
''They never, never wake again, who sleep upon your bed!''”
</poem>
{{hidden end}}
|salign=right|source=~ [[Mary Howitt]], <small>1829</small>}}

The Spider and the Fly

“Will you walk into my parlour?” said the Spider to the Fly,
'Tis the prettiest little parlour that ever you did spy;
The way into my parlour is up a winding stair,
And I've a many curious things to shew when you are there.”
“Oh no, no,” said the little Fly, “to ask me is in vain,
For who goes up your winding stair can ne'er come down again.”

“I'm sure you must be weary, dear, with soaring up so high;
Will you rest upon my little bed?” said the Spider to the Fly.
“There are pretty curtains drawn around; the sheets are fine and thin,
And if you like to rest awhile, I'll snugly tuck you in!”
“Oh no, no,” said the little Fly, “for I've often heard it said,
They never, never wake again, who sleep upon your bed!”

~ Mary Howitt, 1829

Note that, although |halign=center, the centering is reset after the {{hidden begin}}, since that template applies its own styling. This can be resolved by using |bodystyle= in {{hidden begin}} with appropriate markup; in this case:

{{hidden begin |bodystyle=width: auto; margin-left: auto; margin-right: auto;}}

Markup

Renders as

{{quote box
| border=2px
| align=center
| bgcolor = Cornsilk
| font = Times
| title=<u>The Spider and the Fly</u>
| halign=center
| quote=<poem>
“Will you walk into my parlour?” said the Spider to the Fly,
 'Tis the prettiest little parlour that ever you did spy;
The way into my parlour is up a winding stair,
And I've a many curious things to shew when you are there.”
“''Oh no, no,''” said the little Fly, “''to ask me is in vain,''
''For who goes up your winding stair can ne'er come down again.''”
{{hidden begin |bodystyle=width:auto; margin-left:auto; margin-right:auto;}}
“I'm sure you must be weary, dear, with soaring up so high;
Will you rest upon my little bed?” said the Spider to the Fly.
“There are pretty curtains drawn around; the sheets are fine and thin,
And if you like to rest awhile, I'll snugly tuck you in!”
“''Oh no, no,''” said the little Fly,  “''for I've often heard it said,''
''They never, never wake again, who sleep upon your bed!''”
</poem>
{{hidden end}}
| salign=right
| source=~ [[Mary Howitt]], <small>1829</small>
}}

The Spider and the Fly

“Will you walk into my parlour?” said the Spider to the Fly,
'Tis the prettiest little parlour that ever you did spy;
The way into my parlour is up a winding stair,
And I've a many curious things to shew when you are there.”
“Oh no, no,” said the little Fly, “to ask me is in vain,
For who goes up your winding stair can ne'er come down again.”

“I'm sure you must be weary, dear, with soaring up so high;
Will you rest upon my little bed?” said the Spider to the Fly.
“There are pretty curtains drawn around; the sheets are fine and thin,
And if you like to rest awhile, I'll snugly tuck you in!”
“Oh no, no,” said the little Fly, “for I've often heard it said,
They never, never wake again, who sleep upon your bed!”

~ Mary Howitt, 1829

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Quote box in articles based on its TemplateData.

TemplateData for Quote box

Put a quote, and its source, inside a box, with flexible control over bordering, background color, alignment, and other features

Template parameters
Parameter		Description	Type	Status
title	`title`	Optional title to appear at the top of the quote box.	String	optional
quote	`quote`	The quote or text to be displayed in the box.	String	required
source	`source`	Optional source of the quote (author, publication, etc.).	String	optional
align	`align`	Alignment of the quote box on the page—left / right / center / none. Defaults to right alignment. Using align=none will remove word wrapping.	String	optional
width	`width`	The width of the quote box. Defaults to the width of the quote included, unless align=center where the width will default to 100%. Use CSS lengths eg. 50% or 400px	String	optional
border	`border`	The width of the quote box border. Defaults to 1px. Remember to include 'px' or 'em' to specify the correct width.	String	optional
fontsize	`fontsize`	The fontsize of the quote box text. Defaults to 88%.	String	optional
bgcolor	`bgcolor`	The RGB background color of the box. Defaults to #F9F9F9 (light gray).	String	optional
style	`style`	A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding parameters.	String	optional
title_bg	`title_bg`	The RGB background color of the title. Defaults to #F9F9F9 (light gray).	String	optional
title_fnt	`title_fnt`	The title font color. Defaults to black.	String	optional
tstyle	`tstyle`	A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding title parameters.	String	optional
qalign	`qalign`	Alignment of the quote element—left / right / center. Defaults to left.	String	optional
qstyle	`qstyle`	A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding quote parameters.	String	optional
quoted	`quoted`	If this parameter evaluates to true (is not 0, false, or empty) the quote box will enclose the quote in fat-quotes. Use judiciously, and read the Manual of Style.	String	optional
salign	`salign`	Alignment of the source element—left / right / center. Defaults to the value of qalign.	String	optional
sstyle	`sstyle`	A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding source parameters.	String	optional

Usage

Parameters

Full syntax

Examples

Floating and wrapping

Fat-quotes

Quote alignment

Collapsing text

TemplateData

See also