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.
| This template is used on approximately 873,000 pages, or roughly 17124% of all pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
Lua error in Module:TNT at line 159: Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Uses TemplateStyles.tab.
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.
A quote box is an alternative to an inline quote or a block quote. Quote boxes are displayed in a stand-alone manner (similar to images) and are best suited to noteworthy or important quotes. Quote boxes should be used with care, because they lack the context supplied by the flow of the body text, and might present point of view issues or undue weight issues. The Manual of Style guidelines for block quotations recommend formatting block quotations using the {{Blockquote}} template.
- The text presented in quote boxes should not be enclosed in quotation marks.
- 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}}provides a borderless quote with decorative quotation marks, and{{Quote frame}}provides a bordered quote. Both span the article width. (However, do not use{{Cquote}}for block quotations in articles.) - For very short quotes,
{{Rquote}}(with decorative quotation marks) 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, but should not be used in articles.
Usage
For actual quotes, and poems, this template (a variant of {{Quote frame}}) can be used to present a title, quote, author, and source in a box such as that shown opposite, with options to customise its bordering, background, alignment and other aspects.
Caution: The {{Quote box}} template is a floating div, which means that, just as it happens with images, its position will vary depending on the rendering layout, and the article's text above and below may or may not flow around the box. This is a liability to the quote–context relation and, as such, {{Quote box}} can only be used as long as it does not produce out-of-context, undue emphasis or any form of editorializing effect (see MOS:PULLQUOTE).
Note: This is a div-based template, so it may malfunction if indented using wikitext syntax. This is a current limitation of the Wikipedia HTML parsing software.
When used with a poem, it is convenient to wrap the poem's content in <poem>...</poem> tags; these preserve line breaks without having to manually insert <br /> markup.
To be or not to be ...
Parameters
Basic parameters
- <syntaxhighlight lang="wikitext" inline style="display: none;" />
|title=: Optional title to appear at the top of the quote box. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|quote=: The quote or other text to be displayed in the box. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|author=: Optional name of the author. A<ref>...</ref>reference citation can be added at the end. A dash is automatically rendered in front of the author, or in front of the source if there is no author. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|source=: Optional source of the quote ("Quoted" or Italic work title, and other publication data). A<ref>...</ref>reference citation can be added at the end.
Main box styling
- <syntaxhighlight lang="wikitext" inline style="display: none;" />
|align=: Alignment of the quote box on the page—left / right / center / none. Defaults to right alignment. Using align=none will remove word wrapping. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|width=: The width of the quote box. Defaults to the width of the quote included, unless <syntaxhighlight lang="wikitext" inline style="display: none;" />|align=centeror <syntaxhighlight lang="wikitext" inline style="display: none;" />|align=nonewhere the width will default to 100%. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|border=: The width of the quote box border. Defaults to 1px. Remember to include 'px' or 'em' to specify the correct width. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|fontsize=: The fontsize of the quote box text; specify a percentage, e.g. <syntaxhighlight lang="wikitext" inline style="display: none;" />|fontsize=90%. Use font sizes of 85% or higher, per MOS:SMALLFONT. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|bgcolor=: The RGB background color of the box. Defaults to #F9F9F9 (light gray). - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|style=: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding parameters.
Title styling
- <syntaxhighlight lang="wikitext" inline style="display: none;" />
|title_bg=: The RGB background color of the title. Defaults to #F9F9F9 (light gray). - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|title_fnt=: The title font color. Defaults to black. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|tstyle=: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding title parameters.
Quote styling
- <syntaxhighlight lang="wikitext" inline style="display: none;" />
|qalign=: Alignment of the quote element—left / right / center. Defaults to left. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|qstyle=: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding quote parameters. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|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; quote marks do not display in mainspace (articles) per MOS:BLOCKQUOTE.
Source styling
These affect the entire <syntaxhighlight lang="wikitext" inline style="display: none;" />|author= and <syntaxhighlight lang="wikitext" inline style="display: none;" />|source= block, below the quotation.
- <syntaxhighlight lang="wikitext" inline style="display: none;" />
|salign=: Alignment of the source element—left / right / center. Defaults to the value of qalign. - <syntaxhighlight lang="wikitext" inline style="display: none;" />
|sstyle=: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding source parameters.
Full syntax
<syntaxhighlight lang="wikitext">
Error: No text given for quotation (or equals sign used in the actual argument to an unnamed parameter)
</syntaxhighlight>
Examples
Various example codes and their results. For more intricate examples see Template:Quote box/examples. In the examples the {{lorem ipsum}} template merely generates several lines of sample text without meaning, and is not part of the quote syntax.
Floating and wrapping
Minimal code, defaults to floating right and minimal width:
<syntaxhighlight lang="wikitext">{{Quote box
|quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I.
}}
{{Lorem ipsum}}</syntaxhighlight>Cry "Havoc", and let slip the dogs of war.
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:
<syntaxhighlight lang="wikitext">{{Quote box
|quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I. |width = 50% |align = right
}}
{{Lorem ipsum}}</syntaxhighlight>Cry "Havoc", and let slip the dogs of war.
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:
<syntaxhighlight lang="wikitext">{{Quote box
|quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I. |width = 50% |align = left
}}
{{Lorem ipsum}}</syntaxhighlight>Cry "Havoc", and let slip the dogs of war.
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, not floating:
<syntaxhighlight lang="wikitext">{{Quote box
|quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I. |width = 50% |align = center
}}
{{Lorem ipsum}}</syntaxhighlight>Cry "Havoc", and let slip the dogs of war.
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
<syntaxhighlight lang="wikitext">{{Quote box
|quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I. |quoted = 1}}</syntaxhighlight>
Cry "Havoc", and let slip the dogs of war.
Alignment of text in box
<syntaxhighlight lang="wikitext">{{Quote box
|title = Centered quote |quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I. |qalign = center}}</syntaxhighlight>
Cry "Havoc", and let slip the dogs of war.
<syntaxhighlight lang="wikitext">{{Quote box
|title = Left title, right quote |tstyle = text-align: left; |quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I. |qalign = right}}</syntaxhighlight>
Cry "Havoc", and let slip the dogs of war.
Custom classes
This parameter should only be used by editors who fully understand how this template works. The "class=" parameter can be used to add a generic CSS class to this template. Some classes are not compatible with other options or require specific options be set to be useful or look good.
Letterhead custom class
The "letterhead" class should be used with <syntaxhighlight lang="wikitext" inline style="display: none;" />|title_bg=none, <syntaxhighlight lang="wikitext" inline style="display: none;" />|border=none, and <syntaxhighlight lang="wikitext" inline style="display: none;" />|bgcolor= either not used or set to "none". Since the upper-left-corner will have a white background, it should only be used on pages with a white background.
Care should be taken that neither the title nor the text extends into the "left corner" portion of the box. To use a blank line for a title, use <syntaxhighlight lang="wikitext" inline style="display: none;" />|title= . To provide a blank line at the bottom of the letterhead, add <br /><br /> to the end of the <syntaxhighlight lang="wikitext" inline style="display: none;" />|source= parameter (or <syntaxhighlight lang="wikitext" inline style="display: none;" />|author=, if <syntaxhighlight lang="wikitext" inline style="display: none;" />|source= was not used).
<syntaxhighlight lang="wikitext">{{Quote box
|class = letterhead |title = |tstyle = text-align: right; |title_bg = none |border = none |quote = Cry "Havoc", and let slip the dogs of war. |author = William Shakespeare |source = Julius Caesar, Act III, Scene I.}}</syntaxhighlight>
|qalign = right
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
|title = The Spider and the Fly
|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!''"
{{hidden end}}
</poem>
|salign = right
|author = [[Mary Howitt]]
|source = <small>1829</small>
}} |
The Spider and the Fly
— Mary Howitt, 1829
|
Note that, although <syntaxhighlight lang="wikitext" inline style="display: none;" />|halign=center, the centering is reset after the {{hidden begin}}, since that template applies its own styling. This can be resolved by using <syntaxhighlight lang="wikitext" inline style="display: none;" />|contentstyle= in {{hidden begin}} with appropriate markup; in this case:
{{hidden begin|ta2=center|contentstyle=margin: 1em auto;}}
| Markup | Renders as |
|---|---|
{{Quote box
|border = 2px
|align = center
|bgcolor = Cornsilk
|title = The Spider and the Fly
|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||ta2=center|contentstyle=margin: 1em 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!''"
{{hidden end}}
</poem>
|salign = right
|author = [[Mary Howitt]]
|source = <small>1829</small>
}}
|
The Spider and the Fly
— Mary Howitt, 1829
|
TemplateData
TemplateData for Quote box
<templatedata> { "description": "Put a quote, and its source, inside a box, with flexible control over bordering, background color, alignment, and other features", "params": { "class": { "label": "CSS class", "description": "Optional CSS class to modify or override the default class quotebox. Care should be used when using this parameter. Consider using other templates instead. See the Custom classes section of this document for more information.", "type": "string", "required": false }, "title": { "label": "Title", "description": "Optional title to appear at the top of the quote box.", "type": "string", "required": false }, "quote": { "label": "Quote", "description": "The quote or text to be displayed in the box.", "type": "content", "required": true, "aliases": [ "1", "content", "quotetext", "text" ] }, "source": { "label": "Source", "description": "Optional source of the quote (author, publication, etc.). Set off from author with a comma.", "type": "string", "required": false, "aliases": [ "3" ] }, "align": { "label": "Alignment", "description": "Alignment of the quote box on the page—left / right / center / none. Defaults to right alignment. Using align=none will remove word wrapping.", "type": "string", "required": false, "suggestedvalues": [ "left", "center", "right", "none" ] }, "width": { "label": "Width", "description": "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", "type": "string", "required": false }, "border": { "label": "Border width", "description": "The width of the quote box border. Defaults to 1px. Remember to include 'px' or 'em' to specify the correct width.", "type": "string", "required": false }, "fontsize": { "label": "Font size", "description": "The fontsize of the quote box text. Defaults to 88%.", "type": "string", "required": false }, "bgcolor": { "label": "Background color", "description": "The RGB background color of the box. Defaults to #F9F9F9 (light gray).", "type": "string", "required": false }, "style": { "label": "CSS style", "description": "A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding parameters.", "type": "string", "required": false }, "title_bg": { "label": "Title background color", "description": "The RGB background color of the title. Defaults to #F9F9F9 (light gray).", "type": "string", "required": false }, "title_fnt": { "label": "Title font color", "description": "The title font color. Defaults to black.", "type": "string", "required": false }, "tstyle": { "label": "Title CSS style", "description": "A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding title parameters.", "type": "string", "required": false }, "qalign": { "label": "Quote alignment", "description": "Alignment of the quote element—left / right / center. Defaults to left.", "type": "string", "required": false, "aliases": [ "halign" ], "suggestedvalues": [ "left", "center", "right" ] }, "qstyle": { "label": "Quote CSS style", "description": "A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding quote parameters.", "type": "string", "required": false }, "quoted": { "label": "Add quotes?", "description": "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.", "type": "string", "required": false }, "salign": { "label": "Source alignment", "description": "Alignment of the source element—left / right / center. Defaults to the value of qalign.", "type": "string", "required": false, "suggestedvalues": [ "left", "center", "right" ] }, "sstyle": { "label": "Source CSS style", "description": "A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding source parameters.", "type": "string", "required": false }, "tclass": { "label": "Title CSS class", "description": "Advanced: additional classes to apply to the title element", "type": "string" }, "qclass": { "label": "Quote CSS class", "description": "Advanced: additional classes to apply to the quote's element" }, "author": { "aliases": [ "2" ], "label": "Author", "description": "The author to whom the quote is attributed", "type": "line" } }, "format": "block", "paramOrder": [ "class", "title", "quote", "author", "source", "align", "width", "border", "fontsize", "bgcolor", "style", "title_bg", "title_fnt", "tstyle", "qalign", "qstyle", "quoted", "salign", "sstyle", "tclass", "qclass" ] } </templatedata>
Tracking category
See also
- {{Floated box}}