Vorlage:Cquote/Doku: Unterschied zwischen den Versionen

Aus skandinavien-wiki.net
(link)
K (Xineohp1506 verschob die Seite Vorlage:Cquote/doc nach Vorlage:Cquote/Doku, ohne dabei eine Weiterleitung anzulegen)
 
(119 dazwischenliegende Versionen von 54 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<includeonly>{{mergefrom|Cquotetxt}}</includeonly>
{{Documentation subpage}}{{TOC right}}
{{Documentation subpage}}{{TOC right}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
'''{{tl|Cquote}}''' (for '''Centered pull-quote''') is a template meant for [[pull-quote]]s, which stand apart from the text of a page. 
{{high use}}
{{Blockquote/doc/boilerplate}}


* It generally should not be used in articles unless there is a good justification for doing so.
== Usage ==
* 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.  
'''''Centered quote''''' – 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.
* 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]].


'''NOTE''': This template should '''not be used''' for [[block quote]]s in article text.  For long quotations in the text, the [[Wikipedia:Manual of Style#Quotations|Manual of Style]] recommends using the HTML &lt;[[blockquote]]&gt; element, such as through the use of the {{tl|Quote}} template.
===Syntax===
* {{tlx|{{BASEPAGENAME}}|2=quote={{var|text of the quotation}}|3=author={{var|person quoted}}|4=source={{var|source of the quotation}}}}


===Usage===
===Parameters===
# <code><nowiki>{{cquote|quote text}}</nowiki></code>
; Parameter <code>1</code>, <code>quote</code>: text of the quote; use {{tag|p}} around second or subsequent paragraphs.
# <code><nowiki>{{cquote|quote text|quotewidth=40px}}</nowiki></code> or <code><nowiki>{{cquote|quote text|40px|}}</nowiki></code>
: '''''Required'''''
# <code><nowiki>{{cquote|quote text|quote width in pixels||Origin of quote|Cited source}}</nowiki></code>
: {{A note}} if the quote text contains a <code>=</code> (equals sign), then the template must be called with a named parameter for the content. For example: {{tlx|Cquote|{{stronggood|quote{{=}}}}{{var|quote text{{=}}more quoted text}}}} {{Crossreference|1=(see {{section link|Help:Template#Usage hints and workarounds}})}}.
which is to say:  
; <code>author</code>: Name of the person that wrote or spoke the text being quoted. Can include wiki syntax.
*title of article or book is same as Origin of quote
; <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'')
*author is same as Cited source
; <code>bgcolor</code>: The color of the background. This parameter is disabled in article space.
; <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). This parameter is disabled in article space.
; <code>width</code>: for example {{para|width|30%}}. This parameter is disabled in article space.
; <code>qcolor</code>: color of quotemarks, for example {{para|qcolor|#FF0000}} for a red color (only for use in [[WP:Signpost]], and personal pages; do not use in articles, guidelines, etc.). This parameter is disabled in article space.
; <code>rtl</code>: 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. This parameter is disabled in article space.
; <code>quotealign</code>: set to center to center align the quote text. This parameter is disabled in article space.
'''Deprecated''':
; <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).  This parameter is disabled in article space.


;Only the first parameter is required.
===Simple example===
: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 publication and author as 4= and 5= respectively (using them as named parameters&mdash;the preprocessor takes such fine):
<pre>{{Cquote|quote text}}</pre>
{{Cquote|To be, or not to be ...}}


===Sourced example===
<syntaxhighlight lang="moin">{{Cquote|Life is like riding a bicycle. To keep your balance you must keep moving.
|author=[[Albert Einstein]]
|source=in a letter to his son<ref>[[Walter Isaacson]], ''Einstein: His Life and Universe'' (2007), p. 367.</ref>
}}</syntaxhighlight>


{{cquote|Publishers of English classics for the educational trade, [[Harrap]] was also known for publishing finely illustrated books by Rackham, Gooden, and others, and as the publisher of Winston Churchill.
{{Cquote|Life is like riding a bicycle. To keep your balance you must keep moving.
|4=this is four
|author=[[Albert Einstein]]
|5=this is five}}
|source=in a letter to his son<ref>[[Walter Isaacson]], ''Einstein: His Life and Universe'' (2007), p. 367.</ref>
 
}}
which is generated by{{!:}}:&nbsp;
<pre>
{{cquote|Publishers of English classics for the educational trade, [[Harrap]] was also known for publishing finely illustrated books by Rackham, Gooden, and others, and as the publisher of Winston Churchill.
|4=this is four
|5=this is five}}
</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.
; 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>
; 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.


===Examples===
{{reflist}}
<pre>{{cquote|quote text}}</pre>
{{cquote|External success has to do with people who may see me as a model, or an example, or a representative. As much as I may dislike or want to reject that responsibility, this is something that comes with public success. It's important to give others a sense of hope that it is possible and you can come from really different places in the world and find your own place in the world that's unique for yourself.|4=[[Amy Tan]]}}<!--This is a bad example, as it is illustrating use of the template in article text, not as a pull-quote!-->


<pre>{{cquote|1=quote text}}</pre> (quote text contains an equal sign)
===Other examples===
{{cquote|1=The essential point, established by Lorentz, is that the equations of the electromagnetic field are not altered by a certain transformation (which I will call by the name of Lorentz) of the form<sup id="refQLT1904"><small>[[#endnoteQLT1904|2]]</small></sup>:
<pre>{{Cquote|1=F=ma|author=[[Isaac Newton]]}}</pre>
:<math>x^\prime = k\ell\left(x + \varepsilon t\right),t^\prime = k\ell\left(t + \varepsilon x\right),y^\prime = \ell y,z^\prime = \ell z, k = 1/\sqrt{1-\varepsilon^2}.</math>}}
(the ''1='' is necessary as quote text contains an equals sign)
{{Cquote|1=F=ma|author=[[Isaac Newton]]}}


<pre>{{cquote|quote text|40px}}</pre>
{{Cquote|You have the right to remain silent. If you give up that right, anything you say can and will be used against you in a court of law. You have the right to an attorney and to have an attorney present during questioning. If you cannot afford an attorney, one will be provided to you at no cost.  During any questioning, you may decide at any time to exercise these rights, not answer any questions, or make any statements.|40px}}


<pre>{{cquote|quote text|30px||Origin of quote|Cited source}}</pre>
<pre>{{Cquote|1=Thus:
For example,
{{in5}}<math>E=mc^2</math>|author=[[Albert Einstein]]}}</pre>
<pre>{{cquote|And when they've given you their all / Some stagger and fall, after all it's not easy / Banging your heart against some mad bugger's wall.|30px||[[Pink Floyd]]|''[[The Wall]]''}}</pre>
(quote text contains an equals sign and math syntax)
is rendered as
{{Cquote|1=Thus:
{{cquote|And when they've given you their all / Some stagger and fall, after all it's not easy / Banging your heart against some mad bugger's wall.|30px||[[Pink Floyd]]|''[[The Wall]]''}}
{{in5}}<math>E=mc^2</math>|author=[[Albert Einstein]]}}


Example with ref tags:


<pre>{{cquote|You don't get everything you want. A dictatorship would be a lot easier.|200px||George W. Bush<ref>http://www.governing.com/archive/1998/jul/bush.txt</ref>}}</pre>
<pre>{{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%}}</pre>
(source with no author; floated right and width-constrained)
{{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%}}
Note that it will wrap around article text like this.{{Lorem ipsum}}{{clear|both}}


{{cquote|You don't get everything you want. A dictatorship would be a lot easier.|200px||George W. Bush<ref>http://www.governing.com/archive/1998/jul/bush.txt</ref>}}


<references />
<pre>{{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%}}</pre>
(same quote, no float, width constraint)
{{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%}}


===See also===


Direct variants:
<pre>{{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}}</pre>
* {{tl|cquotetxt}} – with text-based quotation mark
(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.)
{{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}}


{{Quotation templates see also}}
===TemplateData===
{{TemplateData header}}
<templatedata>
{
"params": {
"2": {},
"3": {
"deprecated": true
},
"4": {
"deprecated": true
},
"5": {
"deprecated": true
},
"float": {
"label": "Float",
"description": "Position the quote to float on the right or left side of the content",
"example": "left",
"type": "string"
},
"bgcolor": {
"label": "Background color",
"description": "The background color for the quote",
"type": "string",
"default": "transparent"
},
"wide": {
"label": "Full width",
"description": "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).",
"type": "boolean",
"deprecated": "Replace it with width=100%"
},
"width": {
"label": "Width",
"description": "The width of the quote",
"example": "30%",
"type": "string",
"default": "Sized to fit content (auto)",
"autovalue": ""
},
"qcolor": {
"label": "Quotation mark color",
"description": "Color of quotemarks (only for use in WP:Signpost, and personal pages; do not use in articles, guidelines, etc.)",
"example": "#FF0000 for a red color",
"default": "#B2B7F2"
},
"small": {
"deprecated": "This is an option of a template that was merged into this one. You can remove it."
},
"quote": {
"aliases": [
"1",
"quotetext",
"text",
"content"
],
"label": "Quote",
"description": "The quote to be visually repeated",
"type": "content",
"required": true
},
"author": {
"aliases": [
"personquoted"
],
"label": "Author",
"description": "Name of the person that wrote or spoke the text being quoted",
"example": "[[Albert Einstein]]",
"type": "content",
"suggested": true
},
"personquoted": {
"deprecated": "This is an option of a template that was merged into this one. You can replace it with 'author'."
},
"source": {
"aliases": [
"publication",
"title",
"quotesource"
],
"label": "Source",
"description": "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)",
"example": "in a letter to his son<ref>[[Walter Isaacson]], ''Einstein: His Life and Universe'' (2007), p. 367.</ref>",
"type": "content",
"suggested": true
},
"publication": {
"deprecated": "This is an option of a template that was merged into this one. You can replace it with 'source'"
},
"title": {
"deprecated": true
},
"quotesource": {
"deprecated": "This is an option of a template that was merged into this one. You can replace it with 'source'."
},
"rtl": {
"label": "Direction",
"description": "Sets scrript direction right-to-left (Arabic, Hebrew)",
"example": "rtl=yes"
}
},
"description": "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.",
"paramOrder": [
"quote",
"author",
"source",
"width",
"float",
"bgcolor",
"qcolor",
"wide",
"small",
"personquoted",
"publication",
"title",
"quotesource",
"2",
"3",
"4",
"5",
"rtl"
],
"format": "block"
}
</templatedata>


<includeonly>
{{Quotation templates}}
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Quotation templates|{{PAGENAME}}]]


<!-- ADD INTERWIKIS BELOW THIS LINE -->
<includeonly>{{sandbox other||
[[bg:Шаблон:Цитат]]
[[Category:Enhanced quote templates]]
[[cs:Šablona:Citát]]
}}</includeonly>
[[es:Plantilla:Cita]]
[[eu:Txantiloi:Aipu]]
[[id:Template:cquote]]
[[fr:Modèle:Citation bloc]]
[[ms:Templat:Cquote]]
[[mk:Шаблон:Цитатник]]
[[ja:Template:Cquote]]
[[ko:틀:인용문2]]
[[ka:თარგი:Cquote]]
[[pt:Predefinição:Quote2]]
[[ru:Шаблон:Цитатник]]
[[sr:Шаблон:Цитат2]]
[[sv:Mall:Citat]]
[[fa:الگو:نقل قول]]
[[zh:Template:Cquote]]
</includeonly>

Aktuelle Version vom 8. Februar 2023, 16:47 Uhr

Gnome-emblem-important.svg
Diese Vorlage wird auf vielen Seiten verwendet
Um große Unterbrechungen und unnötige Serverauslastung zu vermeiden, solltest du Änderungen an anderer Stelle testen, indem du beispielsweise den Quellcode dieser Vorlage kopierst und in den Benutzerbereich oder in die Sandbox einfügst. Erwäge, deine Änderungen auf der Diskussionsseite vorzuschlagen, bevor du diese Vorlage bearbeitest.

The Manual of Style guidelines for block quotations recommend formatting block quotations using the {{Blockquote}} template or the HTML <blockquote> element, for which that template provides a wrapper.

  • 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}} (for use outside of article space only) provides a borderless quote with decorative quotation marks, and {{Quote frame}} provides a bordered quote. Both span the page width.
  • For very short quotes, {{Rquote}} (with decorative quotation marks, for use outside of article space only) or {{Quote box}} (framed) 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.

Usage

Centered quote – 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
Note: if the quote text contains a = (equals sign), then the template must be called with a named parameter for the content. For example: {{Cquote|quote=quote text=more quoted text}} (see Help:Template § Usage hints and workarounds).
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. This parameter is disabled in article space.
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). This parameter is disabled in article space.
width
for example |width=30%. This parameter is disabled in article space.
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.). This parameter is disabled in article space.
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. This parameter is disabled in article space.
quotealign
set to center to center align the quote text. This parameter is disabled in article space.

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). This parameter is disabled in article space.

Simple example

{{Cquote|quote text}}

Sourced example

{{Cquote|Life is like riding a bicycle. To keep your balance you must keep moving.
|author=[[Albert Einstein]]
|source=in a letter to his son<ref>[[Walter Isaacson]], ''Einstein: His Life and Universe'' (2007), p. 367.</ref>
}}


  1. 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 equals sign)


{{Cquote|1=Thus:
{{in5}}<math>E=mc^2</math>|author=[[Albert Einstein]]}}

(quote text contains an equals sign and math syntax)


{{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)

Note that it will wrap around article text like this.Lorem ipsum dolor sit amet, consectetur adipisicing 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.


{{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)


{{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.)

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See the monthly parameter usage report for this template.

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.

Vorlagenparameter

Diese Vorlage bevorzugt Blockformatierung von Parametern.

ParameterBeschreibungTypStatus
Quotequote 1 quotetext text content

The quote to be visually repeated

Wikitexterforderlich
Authorauthor personquoted

Name of the person that wrote or spoke the text being quoted

Beispiel
[[Albert Einstein]]
Wikitextvorgeschlagen
Sourcesource 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)

Beispiel
in a letter to his son<ref>[[Walter Isaacson]], ''Einstein: His Life and Universe'' (2007), p. 367.</ref>
Wikitextvorgeschlagen
Widthwidth

The width of the quote

Standard
Sized to fit content (auto)
Beispiel
30%
Autowert
Mehrzeiliger Textoptional
Floatfloat

Position the quote to float on the right or left side of the content

Beispiel
left
Mehrzeiliger Textoptional
Background colorbgcolor

The background color for the quote

Standard
transparent
Mehrzeiliger Textoptional
Quotation mark colorqcolor

Color of quotemarks (only for use in WP:Signpost, and personal pages; do not use in articles, guidelines, etc.)

Standard
#B2B7F2
Beispiel
#FF0000 for a red color
Unbekanntoptional
Full widthwide

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).

Wahrheitswertveraltet
smallsmall

keine Beschreibung

Unbekanntveraltet
personquotedpersonquoted

keine Beschreibung

Unbekanntveraltet
publicationpublication

keine Beschreibung

Unbekanntveraltet
titletitle

keine Beschreibung

Unbekanntveraltet
quotesourcequotesource

keine Beschreibung

Unbekanntveraltet
22

keine Beschreibung

Unbekanntoptional
33

keine Beschreibung

Unbekanntveraltet
44

keine Beschreibung

Unbekanntveraltet
55

keine Beschreibung

Unbekanntveraltet
Directionrtl

Sets scrript direction right-to-left (Arabic, Hebrew)

Beispiel
rtl=yes
Unbekanntoptional