Template:Cquote/doc: Difference between revisions
meta>Nøkkenbuer added {{tlx}}s, {{stronggood}}, {{=}}s, {{var}}s, and {{A note}} |
meta>Jdaloner m "{{TemplateDataHeader}}" --> "{{TemplateData header}}" |
||
Line 70: | Line 70: | ||
===TemplateData=== | ===TemplateData=== | ||
{{ | {{TemplateData header}} | ||
<templatedata> | <templatedata> | ||
{ | { |
Revision as of 04:43, 14 August 2018
This is a documentation subpage for Template:Cquote. It may contain usage information, categories and other content that is not part of the original template page. |
Usage
For quotes, this template provides a centered, borderless quote, with scalable decorative quotation marks, and optional attribution of the source of the quote. It can be used with or without the names of the parameters.
Syntax
{{Cquote|quote=text of the quotation|author=person quoted|source=source of the quotation}}
Parameters
- Parameter
1
,quote
- text of the quote; use
<p>...</p>
around second or subsequent paragraphs. - Required
- File:Pictogram voting info.svg Note: if the quote text contains a
=
(equal sign), then the template must be called with a named parameter for the content. For example:{{Cquote|quote=quote text=more quoted text}}
author
- Name of the person that wrote or spoke the text being quoted. Can include wiki syntax.
source
- Source of the quote (publication title, speech, etc.). Can include wiki syntax. Can be used without
|author=
(e.g. for a scripture, law, or other source without an author per se) bgcolor
- The color of the background.
float
- Defaults to center, but can also be right or left. Usually used with
|width=30%
or so (otherwise for quotes longer than one line on the rendered page, the float will have no useful effect). width
- for example
|width=30%
qcolor
- color of quotemarks, for example
|qcolor=#FF0000
for a red color (only for use in WP:Signpost, and personal pages; do not use in articles, guidelines, etc.) rtl
- set to any non-blank value for quotes that should be rendered from right to left (e.g., Arabic). Adds the necessary dir attribute and reverses the quotes.
Deprecated:
wide
- 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
|width=
constraint).
Simple example
{{Cquote|quote text}}
“ | To be, or not to be ... | ” |
Sourced example
<source lang="moin">
“ | Life is like riding a bicycle. To keep your balance you must keep moving. | ” |
— Albert Einstein, in a letter to his son[1] |
</source>
“ | Life is like riding a bicycle. To keep your balance you must keep moving. | ” |
— Albert Einstein, in a letter to his son[2] |
- ↑ Walter Isaacson, Einstein: His Life and Universe (2007), p. 367.
- ↑ Walter Isaacson, Einstein: His Life and Universe (2007), p. 367.
Other examples
{{Cquote|1=F=ma|author=[[Isaac Newton]]}}
(the 1= is necessary as quote text contains an equal sign)
“ | F=ma | ” |
— Isaac Newton |
{{Cquote|1=Thus: {{in5}}<math>E=mc^2</math>|author=[[Albert Einstein]]}}
(quote text contains an equal sign and math syntax)
“ | Thus:
Script error: No such module "in5".<math>E=mc^2</math> |
” |
— Albert Einstein |
{{Cquote|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%}}
(source with no author; floated right and width-constrained)
“ | 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. | ” |
— First Amendment to the Constitution of the United States |
Note that it will wrap around article text like this. Template:Lorem
{{Cquote|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 |width=50%}}
(same quote, no float, width constraint)
“ | 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. | ” |
— First Amendment to the Constitution of the United States |
{{Cquote|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}}
(same quote, no float, no width setting – for short quote, would use as much of line as necessary, and for longer quotes, full width of page, wrapping for multiple lines.)
“ | 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. | ” |
— First Amendment to the Constitution of the United States |
TemplateData
TemplateData for Cquote
This template is intended for quotes. Usually this is not appropriate for encyclopedia articles. The Manual of Style guidelines for block quotations recommend formatting block quotations using the {{Quote}} template or the HTML <blockquote> element.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Quote | quote 1 quotetext text content | The quote to be visually repeated | Content | required |
Author | author personquoted | Name of the person that wrote or spoke the text being quoted
| Content | suggested |
Source | source publication title quotesource | Source of the quote (publication title, speech, etc.). Can include wiki syntax. Can be used without |author= (e.g. for a scripture, law, or other source without an author per se)
| Content | suggested |
Width | width | The width of the quote
| String | optional |
Float | float | Position the quote to float on the right or left side of the content
| String | optional |
Background color | bgcolor | The background color for the quote
| String | optional |
Quotation mark color | qcolor | Color of quotemarks (only for use in WP:Signpost, and personal pages; do not use in articles, guidelines, etc.)
| Unknown | optional |
Full width | wide | 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 |width= constraint). | Boolean | deprecated |
small | small | no description | Unknown | deprecated |
personquoted | personquoted | no description | Unknown | deprecated |
publication | publication | no description | Unknown | deprecated |
title | title | no description | Unknown | deprecated |
quotesource | quotesource | no description | Unknown | deprecated |
2 | 2 | no description | Unknown | optional |
3 | 3 | no description | Unknown | deprecated |
4 | 4 | no description | Unknown | deprecated |
5 | 5 | no description | Unknown | deprecated |
Direction | rtl | Sets scrript direction right-to-left (Arabic, Hebrew)
| Unknown | optional |