Template:Cquote/doc: Difference between revisions

The "wide" parameter is now useless and does not function as it used to. It is not useful for short quotes (just separates them from their attribution undesirably), nor for long (they auto-expand, auto-wrap now).
(update - the width parameter was not documented; adding examples showing float wrapping, width constraints, source with no author)
(The "wide" parameter is now useless and does not function as it used to. It is not useful for short quotes (just separates them from their attribution undesirably), nor for long (they auto-expand, auto-wrap now).)
Line 19:
 
===Parameters===
; Parameter <code>1</code>, a.k.a. <code>quote</code>: text of the quote; use {{tag|p}} around second or subsequent paragraphs.
: '''''Required'''''
: '''Note''': if the quote text contains a <code>=</code> (equal sign), then the template must be called with a named parameter for the content, e.g. <code><nowiki>{{pull quote|</nowiki>'''<span style="color:red;">quote=</span>'''<nowiki>quote text}}</nowiki></code> {{crossref|1=(see {{section link|Help:Template#Usage hints and workarounds}})}}.
; <code>author</code>: Name of the person that wrote or spoke the text being quoted. Can include wiki syntax.
; <code>source</code>: Source of the quote (publication title, speech, etc.). Can include wiki syntax. Can be used without {{para|author}} (e.g. for a scripture, law, or other source without an author ''per se'')
; <code>bgcolor</code>: The color of the background.
; <code>float</code>: Defaults to center, but can also be right or left. Usually used with {{para|width|30%}} or so (otherwise for quotes longer than one line on the rendered page, the float will have no useful effect).
; qcolor <code>width</code>: color of quotemarks (only for use in [[WP:Signpost]], and personal pages; do not use in articles, guidelines, etc.)
; width: Defaults to "auto" (i.e. full width of quote, or full width of page if quote is longer than one line on the page); a common value is <code>30%</code> when used with {{para|float|left}} or {{para|float|right}}.
 
; wide: When set to "yes", the quote expands to the entire width of the page, even if short. Useful for long quotes, but may clash with other floating objects, such as infoboxes.
'''Deprecated''':
; qcolor : color of quotemarks (only for use in [[WP:Signpost]], and personal pages; do not use in articles, guidelines, etc.)
; <code style="color: DarkRed;">wide</code>: In older versions of the template, when this was set to "yes", the quote expanded to the entire width of the page, which was useful for long quotes. However, it clashed with other floating objects, such as infoboxes, and the template now auto-expands and line-wraps as needed (full page, or within a {{para|width}} constraint).
 
===Simple example===
Line 63 ⟶ 64:
(source with no author; floated right and width-constrained)
{{pull quote|Congress shall make no law respecting an establishment of religion, or prohibiting the free exercise thereof; or abridging the freedom of speech, or of the press; or the right of the people peaceably to assemble, and to petition the Government for a redress of grievances.|source=First Amendment to the Constitution of the United States |float=right |width=30%}}
NotNote that it will wrap around article text like this. {{lorem}}{{clear|both}}
 
 
Anonymous user