.
Template:Cquote/doc: Difference between revisions
Wikicars, a place to share your automotive knowledge
Jump to navigationJump to search
Red marquis (talk | contribs) No edit summary |
Red marquis (talk | contribs) mNo edit summary |
||
Line 1: | Line 1: | ||
==Usage== | |||
'''{{tl|Cquote}}''' (for '''Centered pull-quote''') is a template meant for [[pull-quote]]s, which stand apart from the text of a page. | |||
= | * <font color="red">'''NOTE''': This template should '''not be used''' for block quotations in article text.</font> For long quotations in the text, the [[Wikipedia:Manual of Style#Quotations|Manual of Style]] recommends using the HTML <[[blockquote]]> element, such as through the use of the {{tl|Quote}} template. | ||
* 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 (publishing)|sidebar]]. This can be effective on [[WP:ESSAY|essay]] pages and [[WP:WIKIPROJECT|WikiProject]] homepages. | |||
===Syntax=== | |||
# <code><nowiki>{{cquote|quote text}}</nowiki></code> | |||
# <code><nowiki>{{cquote|quote text|quotewidth=40px}}</nowiki></code> or <code><nowiki>{{cquote|quote text|40px|}}</nowiki></code> | |||
# <code><nowiki>{{cquote|quote text|quote width in pixels||author or speaker|title of article, speech, book, etc.}}</nowiki></code> | |||
;Only the first parameter is required. | |||
:But since sizes are slotted into the second parameter place 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 author and publication as 4= and 5= respectively (using them as named parameters—the preprocessor takes such fine): | |||
{{cquote|This is one. | |||
|4=Author | |||
|5=Publication}} | |||
which is generated by: | |||
<pre> | |||
{{cquote|This is one. | |||
|4=Author | |||
|5=Publication}} | |||
</pre> | |||
or | |||
<pre>{{cquote|This is one. | |||
|author=Author | |||
|source=Publication}} </pre> | |||
===Parameters=== | |||
; Parameter 1: text of the quote; use <code><nowiki><br /></nowiki></code> between paragraphs. | |||
: '''''Required''''' | |||
: '''Note''': if the quote text contains one or more "=" (equal signs), then the template must be called as <nowiki>{{cquote|</nowiki>'''<span style="color:red;">1=</span>'''<nowiki>quote text}}</nowiki> (see [[m:Help:Templates#Equals sign in parameter value|"Equals sign in parameter value"]]) | |||
;Parameter 2: "size", "quotewidth", or "width" can also be used. - desired size of the quotation marks; defaults to 20px (anything larger than 48px is not recommended). This can be used to scale the graphical [[quotation mark]]s up and down to suit larger or smaller quotes. | |||
;<del>Parameter 3</del>:<del>"quoteheight"</del> - it was used for desired height of the quotation marks, but no longer. | |||
; author / 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 <nowiki>{{cquote|</nowiki>'''<span style="color:red;">4=</span>'''<nowiki>text}}</nowiki> | |||
; source / publication / 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 <nowiki>{{cquote|</nowiki>'''<span style="color:red;">5=</span>'''<nowiki>text}}</nowiki> | |||
; bgcolor: The color of the background. | |||
; wide: When set to "yes", the quote expands to the entire width of the page. Usefull for small quotes, but may clash with other floating objects, such as infoboxes. | |||
===Examples=== | ===Examples=== | ||
<references /> | |||
; | ==See also== | ||
{{ | ;Direct variants: | ||
* {{tl|cquotetxt}} – with text-based quotation mark | |||
{{Quotation templates see also}} | |||
<includeonly> | <includeonly> | ||
<!-- ADD CATEGORIES BELOW THIS LINE --> | <!-- ADD CATEGORIES BELOW THIS LINE --> | ||
[[ | [[Category:Quotation templates|{{PAGENAME}}]] | ||
</includeonly> | |||
<noinclude> | |||
[[Category:Templates]] | [[Category:Templates]] | ||
</noinclude> | |||
</ |
Revision as of 07:21, 9 September 2010
Usage
Template:Tl (for Centered pull-quote) is a template meant for pull-quotes, which stand apart from the text of a page.
- NOTE: This template should not be used for block quotations 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 Template:Tl template.
- 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 Template:Tl which sets the quote off to either the right or left as in a magazine sidebar. This can be effective on essay pages and WikiProject homepages.
Syntax
{{cquote|quote text}}
{{cquote|quote text|quotewidth=40px}}
or{{cquote|quote text|40px|}}
{{cquote|quote text|quote width in pixels||author or speaker|title of article, speech, book, etc.}}
- Only the first parameter is required.
- But since sizes are slotted into the second parameter place 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 author and publication as 4= and 5= respectively (using them as named parameters—the preprocessor takes such fine):
Error creating thumbnail: Unable to save thumbnail to destination
|
This is one. | Error creating thumbnail: Unable to save thumbnail to destination
|
Template:Author Template:Publication |
which is generated by:
{{cquote|This is one. |4=Author |5=Publication}}
or
{{cquote|This is one. |author=Author |source=Publication}}
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")
- Parameter 2
- "size", "quotewidth", or "width" can also be used. - desired size of the quotation marks; defaults to 20px (anything larger than 48px is not recommended). This can be used to scale the graphical quotation marks up and down to suit larger or smaller quotes.
Parameter 3"quoteheight"- it was used for desired height of the quotation marks, but no longer.- author / 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}}
- source / publication / 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}}
- bgcolor
- The color of the background.
- wide
- When set to "yes", the quote expands to the entire width of the page. Usefull for small quotes, but may clash with other floating objects, such as infoboxes.
Examples
<references />
See also
- Direct variants
- Template:Tl – with text-based quotation mark