Vorlage:Cquote/Doku: Unterschied zwischen den Versionen

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

Dies ist eine nachgeordnete Seite der Dokumentation von Vorlage:Cquote.
Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Vorlage-Seite ist.

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}}

“

To be, or not to be ...

”

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>
}}

“

Life is like riding a bicycle. To keep your balance you must keep moving.

”

— Albert Einstein, in a letter to his son^[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)

“

F=ma

”

— Isaac Newton

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

(quote text contains an equals sign and math syntax)

“

Thus:

”

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

“

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

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.
Parameter		Beschreibung	Typ	Status
Quote	`quote` `1` `quotetext` `text` `content`	The quote to be visually repeated	Wikitext	erforderlich
Author	`author` `personquoted`	Name of the person that wrote or spoke the text being quoted Beispiel [[Albert Einstein]]	Wikitext	vorgeschlagen
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) Beispiel in a letter to his son<ref>[[Walter Isaacson]], ''Einstein: His Life and Universe'' (2007), p. 367.</ref>	Wikitext	vorgeschlagen
Width	`width`	The width of the quote Standard Sized to fit content (auto) Beispiel 30% Autowert	Mehrzeiliger Text	optional
Float	`float`	Position the quote to float on the right or left side of the content Beispiel left	Mehrzeiliger Text	optional
Background color	`bgcolor`	The background color for the quote Standard transparent	Mehrzeiliger Text	optional
Quotation mark color	`qcolor`	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	Unbekannt	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).	Wahrheitswert	veraltet
small	`small`	keine Beschreibung	Unbekannt	veraltet
personquoted	`personquoted`	keine Beschreibung	Unbekannt	veraltet
publication	`publication`	keine Beschreibung	Unbekannt	veraltet
title	`title`	keine Beschreibung	Unbekannt	veraltet
quotesource	`quotesource`	keine Beschreibung	Unbekannt	veraltet
2	`2`	keine Beschreibung	Unbekannt	optional
3	`3`	keine Beschreibung	Unbekannt	veraltet
4	`4`	keine Beschreibung	Unbekannt	veraltet
5	`5`	keine Beschreibung	Unbekannt	veraltet
Direction	`rtl`	Sets scrript direction right-to-left (Arabic, Hebrew) Beispiel rtl=yes	Unbekannt	optional

[1] Walter Isaacson, Einstein: His Life and Universe (2007), p. 367.

[1]

@@ Zeile 1: / Zeile 1: @@
 {{Documentation subpage}}{{TOC right}}
 <!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
+{{high use}}
-{{Cquote/boilerplate}}
+{{Blockquote/doc/boilerplate}}
 == Usage ==
-For actual [[pull quote]]s, this template provides a centered, borderless pull 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.
+'''''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===
-* <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|text={{var|text of the quotation}}|author={{var|person quoted}}|source={{var|source of the quotation}}<nowiki>}}</nowiki></code>
+* {{tlx|{{BASEPAGENAME}}|2=quote={{var|text of the quotation}}|3=author={{var|person quoted}}|4=source={{var|source of the quotation}}}}
 ===Parameters===
-; Parameter <code>1</code>, a.k.a. <code>quote</code>: text of the quote; use {{tag|p}} around second or subsequent paragraphs.
+; Parameter <code>1</code>, <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}})}}.
+: {{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}})}}.
 ; <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>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).
+; <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%}}
+; <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.)
+; <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.
+; <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).
+; <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.
 ===Simple example===
-<pre>{{pull quote|quote text}}</pre>
+<pre>{{Cquote|quote text}}</pre>
-{{pull quote|To be, or not to be ...}}
+{{Cquote|To be, or not to be ...}}
 ===Sourced example===
-<source lang="moin">{{pull quote|Life is like riding a bicycle. To keep your balance you must keep moving.
+<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>
-}}</source>
+}}</syntaxhighlight>
-{{pull quote|Life is like riding a bicycle. To keep your balance you must keep moving.
+{{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>
@@ Zeile 42: / Zeile 43: @@
 ===Other examples===
-<pre>{{pull quote|1=F=ma|author=[[Isaac Newton]]}}</pre>
+<pre>{{Cquote|1=F=ma|author=[[Isaac Newton]]}}</pre>
-(the ''1='' is necessary as quote text contains an equal sign)
+(the ''1='' is necessary as quote text contains an equals sign)
-{{pull quote|1=F=ma|author=[[Isaac Newton]]}}
+{{Cquote|1=F=ma|author=[[Isaac Newton]]}}
-<pre>{{pull quote|1=Thus:
+<pre>{{Cquote|1=Thus:
 {{in5}}<math>E=mc^2</math>|author=[[Albert Einstein]]}}</pre>
-(quote text contains an equal sign and math syntax)
+(quote text contains an equals sign and math syntax)
-{{pull quote|1=Thus:
+{{Cquote|1=Thus:
 {{in5}}<math>E=mc^2</math>|author=[[Albert Einstein]]}}
-<pre>{{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%}}</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)
-{{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%}}
+{{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}}{{clear|both}}
+Note that it will wrap around article text like this.{{Lorem ipsum}}{{clear|both}}
-<pre>{{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 |width=50%}}</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 |width=50%}}</pre>
 (same quote, no float, width constraint)
-{{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 |width=50%}}
+{{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>{{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}}</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}}</pre>
 (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.)
-{{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}}
+{{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}}
 ===TemplateData===
-{{TemplateDataHeader}}
+{{TemplateData header}}
 <templatedata>
 {
@@ Zeile 164: / Zeile 165: @@
 		"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 pull quotes, a visually distinctive repetition of text that is already present on the same page. 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.",
+	"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",
@@ Zeile 183: / Zeile 189: @@
 		"2",
 		"3",
-                "4",
+		"4",
-                "5"
+		"5",
+		"rtl"
 	],
 	"format": "block"
@@ Zeile 192: / Zeile 199: @@
 {{Quotation templates}}
-<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
+<includeonly>{{sandbox other||
-| <!-- ADD CATEGORIES BELOW THIS LINE, PLEASE: -->
+[[Category:Enhanced quote templates]]
-[[Category:Pull quote templates]]
 }}</includeonly>