Bản mẫu:Quote/doc

Đây là một trang con tài liệu dành cho Bản mẫu:Quote.
Nó gồm có các thông tin hướng dẫn sử dụng, thể loại và các nội dung khác không thuộc về phần trang bản mẫu gốc.

Cách sử dụng

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

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

Ghi chú: Block quotes do not normally contain quotation marks (see ).

Bảng tóm tắt

Sử dụng cơ bản:: {{Quote|chữ=Quoted material. |tác giả=Attribution |nguồn=Reference }}

Các thông số

|chữ= a.k.a. |1= The material being quoted, without quotation marks around it. It is always safest to name this parameter (rather than use an unnamed positional parameter), because any inclusion of the = character (e.g. in a URL in a source citation) will otherwise break the template.

|tác giả= a.k.a. |2= Attribution information that will appear below the quotation.

|nguồn= a.k.a. |3= Title of the work the quote appears in. This parameter immediately follows the output of |tác giả= (and an auto-generated comma); it does not auto-italicize. Major works (books, plays, albums, feature films, etc.) should be italicized; minor works (articles, chapters, poems, songs, TV episodes, etc.) go in quotation marks (see ). Both can be given at once: |nguồn="The Aerodynamics of Shaved Weasels", ''Perspectives on Mammal Barbering''.

Chú thích nguồn gốc

Một chú thích tham khảo có thể được đặt:

In the regular-prose introduction to the quotation:
According to Pat Doe, in "Underwater Basketweaving Tips" (2015):<ref>...</ref> {{quote |chữ=Quoted material.}}
At the end of the quotation, when a quotation is given without |tác giả= or |nguồn= (e.g. because the material before the quote makes it clear who is being quoted):
According to Pat Doe, in "Underwater Basketweaving Tips" (2015): {{quote |chữ=Quoted material.<ref>...</ref>}}
After the quoted person's name, in |tác giả=, when a |nguồn= is not being added:
As noted in "Underwater Basketweaving Tips" (2015): {{quote |chữ=Quoted material. |tác giả=Pat Doe<ref>...</ref>}}
After the source title, in |nguồn= (the preferred location when both attribution parameters are present):
One expert noted in 2015: {{quote |chữ=Quoted material. |tác giả=Pat Doe |nguồn="Underwater Basketweaving Tips"<ref>...</ref>}}

Please do not place the citation in a |tác giả= or |nguồn= parameter by itself, as it will produce a nonsensical attribution line that looks like:
— ^[1]
Please also do not put it just outside the {{Quote}} template, as this will cause a:
^[1]
on a line by itself.

Kiểu

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

/* Styling for bản mẫu: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;
}

HTML:

<blockquote class="templatequote">
<p>Quote text.</p>
<cite><div class="templatequotecite">—Tác giả, Nguồn</div></cite>
</blockquote>

Các ví dụ

Cú pháp	{{Quote\|chữ=Cry "Havoc" and let slip the dogs of war.\|tác giả=[[William Shakespeare]]\|nguồn=''[[Julius Caesar (play)\|Julius Caesar]]'', act III, scene I}}
Kết quả	Crʰ "Havoc" and let slip the dogs of war. — William Shakespeare, Julius Caesar, act III, scene I

Limitations

If you do not provide 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: {{{|chữ}}} (the text before 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 Bản mẫu:! 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.

As noted above, the |nguồn= parameter will forcibly italicize all content in it; this is often undesirable, in which case include the material in the |tác giả= parameter.

Next to right-floated boxes

Tính đến tháng 9 năm 2015^{[cập nhật]}, the text of a block quotation may rarely overflow (in Firefox or other Gecko browsers) a right-floated item (e.g. a {{Listen}} box, when that item is below another right-floated item of a fixed size that is narrower. In Safari and other Webkit browsers (and even more rarely in Chrome/Chromium) the same condition can cause the block quotation to be pushed downward. Both of these problems can be fixed by either:

removing the sizing on the upper item and letting it use its default size (e.g. removing ###x###px sizing or |upright= from a right-floated image above a wider right-floated object that is being overflowed by quotation text; or
using |style=overflow:inherit;= in the quotation template.

There may be other solutions, and future browser upgrades may eliminate the issue. It arises at all because of the blockquote { overflow: hidden; } CSS declaration in Mediawiki:Common.css, which itself works around other, more common display problems. A solution that fixes all of the issues is unknown at this time.

Vanishing quotes

In rare layout cases, e.g. when quotes are sandwiched between userboxes, a quotation may appear blanked out, in some browsers. The workaround for this problem is to add |style=overflow:inherit; to such an instance of the template.

Line breaks

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

Cú pháp	Kết quả
<blockquote> Dòng 1 Dòng 2 Dòng 3 Dòng 4 </blockquote>	Dòng 1 Dòng 2 Dòng 3 Dòng 4

The simplest workaround for this is to use the <poem> tag inside <blockquote>, which will convert line breaks to <br /> tags:

Cú pháp	Kết quả
<blockquote><poem> Dòng 1 Dòng 2 Dòng 3 Dòng 4 </poem></blockquote>	Dòng 1 Dòng 2 Dòng 3 Dòng 4

Dữ liệu bản mẫu

Đây là tài liệu Dữ liệu bản mẫu cho bản mẫu này được sử dụng bởi Trình soạn thảo trực quan và các công cụ khác; xem báo cáo sử dụng tham số hàng tháng cho bản mẫu này.

Dữ liệu bản mẫu cho Quote

Adds a block quotation.

Tham số bản mẫu
Tham số		Miêu tả	Kiểu	Trạng thái
chữ	`text` `1` `quote`	The text to quote Ví dụ Cry "Havoc" and let slip the dogs of war.	Nội dung	bắt buộc
chữ ký	`sign` `2` `cite` `author`	The person being quoted Ví dụ [[William Shakespeare]]	Nội dung	khuyên dùng
nguồn	`source` `3`	A source for the quote Ví dụ ''[[Julius Caesar (play)\|Julius Caesar]]'', act III, scene I	Nội dung	khuyên dùng

Các lỗi

Pages where this template is not used correctly populate Thể loại:Các trang không đúng làm bản mẫu 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.