قالب:Quote/doc

هذه صفحة توثيق فرعية لـ قالب:Quote.
تتضمن معلومات الاستعمال، التصنيفات وأي محتوى آخر ليس من محتويات الأصل لصفحة القالب.

Usage

{{Quote}} adds a block quotation to an article page.

This is easier to type and more wiki-like than the equivalent HTML <blockquote>...</blockquote> tags and has additional pre-formatted attribution and source parameters.

Note: Block quotes do not normally contain quotation marks. See MOS:Blockquote.

Synopsis

Unnamed (positional) parameters {{quote|phrase|person|source}} This markup will fail if any parameter contains an equals sign (=).

Numbered (positional) parameters {{quote|1=phrase|2=person|3=source}}

Named parameters {{quote|text=phrase|sign=person|source=source}}

Style

Styling is applied through CSS rules in MediaWiki:Common.css.

/* Styling for Template:Quote */
blockquote.templatequote {
     margin-top: 0;
}
blockquote.templatequote div.templatequotecite {
    line-height: 1.5em;
    /* @noflip */
    text-align: left;
    /* @noflip */
    padding-left: 1.6em;
    margin-top: 0;
}

The source title is enclosed in <cite>...</cite>, thus it shows italicized.

Examples

Markup	{{Quote\|text=Cry "Havoc" and let slip the dogs of war.\|sign=[[William Shakespeare]]\|source=''[[Julius Caesar (play)\|Julius Caesar]]'', act III, scene I}}
Renders as	Cry "Havoc" and let slip the dogs of war. — William Shakespeare، Julius Caesar, act III, scene I

Restrictions

If you do not provide quoted text, the template generates a parser error message, which will appear in red text in the rendered page.

If any parameter's actual value contains an equals sign (=), you must use named parameters or a blank-name parameter, as: {{{|text}}}. (The equals sign gets interpreted as a named parameter otherwise.)

If any parameter's actual value contains characters used for wiki markup syntax (such as pipe, brackets, single quotation marks, etc.), you may need to escape it. See Template:! and friends.

Be wary of URLs which contain restricted characters. The equals sign is especially common. Put a break (newline) after the template, or the next blank line might be ignored.

Line breaks

(This section is transcluded from Template:Blockquote paragraphs)

The <blockquote> element and any templates that use it do not honor newlines:

Markup	Renders as
<blockquote> Line 1 Line 2 Line 3 Line 4 </blockquote>	Line 1 Line 2 Line 3 Line 4

An easy solution is to use the {{poemquote}} template instead of <blockquote>...</blockquote>. This is effectively the same as using the <poem> tag inside <blockquote>, which converts line breaks to <br /> tags:

Markup	Renders as
<blockquote><poem> Line 1 Line 2 Line 3 Line 4 </poem></blockquote>	Line 1 Line 2 Line 3 Line 4

To markup actual paragraphs within block quotations, entire blank lines can be used between them, which will convert to <p>...</p> tags:

Markup	Renders as
<blockquote> Paragraph 1 Paragraph 2 Paragraph 3 </blockquote>	Paragraph 1 Paragraph 2 Paragraph 3

Note that it may be necessary to put a line break in the wikitext before <blockquote> and after </blockquote> in order for the paragraphs to render with the intended separation. (This also makes the wikitext easier to read.)

This paragraph style also works with {{quote}}, which is a replacement for <tag> that also has parameters to make formatting of the attribution more convenient and consistent.

Blockquote and templates that call it, and are indented with colon (:), bulleted with asterisk (*), or numbered with number (#), will generate errors and incorrectly display anything after a newline character.

Markup	Renders as
:<blockquote>Paragraph 1 Paragraph 2</blockquote>	Paragraph 1 Paragraph 2

Markup	Renders as
*<blockquote>Paragraph 1 Paragraph 2</blockquote>	Paragraph 1 Paragraph 2

Markup	Renders as
#<blockquote>Paragraph 1 Paragraph 2</blockquote>	Paragraph 1 Paragraph 2

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Quote

Adds a block quotation.

وسائط القالب
وسيط		وصف	نوع	حالة
text	`text` `1` `quote`	The text to quote	نص	اختياري
sign	`sign` `2` `cite`	The person who quote it is	نص	اختياري
source	`source` `3`	A source for the quote	نص	اختياري

Known problems

This template sets a text style which might ignore one blank line, and so the template must be ended with a break (newline). Otherwise, beware inline, as:

text here {{quote|this is quoted}} More text here spans a blank line

Unless a {{quote|xx}} is ended with a line break, then the next blank line might be ignored and two paragraphs joined.