Template:Blockquote/doc: Difference between revisions

minor tweaks
(bypass redir)
(minor tweaks)
Line 8:
{{tlx|Quote}} adds a [[block quotation]] to an article page.
 
This is easier to type and is more wiki-like than the equivalent [[HTML]] {{code|lang=html|code=<blockquote>...</blockquote>}} tags, and has additional pre-formatted attribution parameters for author and source (though these are not usually used in articles; {{crossrefcrossreference|see {{section link||Reference citations}}, below}}).
 
'''Note:''' Block quotes do {{em|not}} normally contain quotation marks {{crossrefcrossreference|(see [[MOS:BLOCKQUOTE]])}}.
 
{{warning|heading=This template is for actual quotations only.|text=Do not use it for block indentation of other material; see {{tlx|Block indent}} for that purpose.}}
Line 53:
 
=== Displayed attribution ===
These parameters for for {{em|displaying}} attribution information below the quote; this should not be confused with a citing a source {{crossrefcrossreference|(see {{section link||Reference citations}}, below)}}. These parameters are entirely optional, and are usually used with famous quotations, not routine block quotations, which are usually sourced at the end of the introductory line immediately before the quotation, with a normal <syntaxhighlight lang="html" inline><ref>...</ref></syntaxhighlight> tag.
 
{{para|author}} a.k.a. {{para|2}} – optional author/speaker attribution information that will appear below the quotation, and preceded with an attribution dash.
 
{{para|title}} a.k.a. {{para|3}} – optional title of the work the quote appears in, to display below the quotation. This parameter immediately follows the output of {{para|author}} (and an auto-generated comma), if one is provided. 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 {{crossrefcrossreference|(see [[MOS:TITLES]])}}. Additional citation information can be provided in a fourth parameter, {{para|source}}, below, which will appear after the title.
 
{{para|source}} a.k.a. {{para|4}} – optionally used for additional source information to display, after {{para|title}}, like so: {{code|lang=moin|code={{!}}title="The Aerodynamics of Shaved Weasels" {{!}}source=''Perspectives on Mammal Barbering'', 2016}}; a comma will be auto-generated between the two parameters. If {{para|source}} is used without {{para|title}}, it simply acts as {{para|title}}. <small>(This parameter was added primarily to ease conversion from misuse of the [[pull quote]] template {{tlx|Quote frame}} for block quotation, but it may aid in cleaner meta-data implementation later.)</small>
Line 73:
 
=== Rarely used technical parameters ===
{{para|style}} – allows specifying additional [[Help:Cascading Style Sheets|CSS]] styles ({{em|not}} classes) to apply to the {{code|lang=html|code=<blockquote>...</blockquote>}} element. {{CrossrefCrossreference|(See [[#Nested quotations]], below, for the most common use case.)}}
 
=== Parameter list ===
Line 98:
}}
 
Please do not place the citation in a {{para|author}} or {{para|source}} parameter by itself, as it will produce a nonsensical attribution line that looks like:<br />{{in5}}—&#8239;{{fakedummy refreference}}<br />Please also do not put it just outside the {{tl|Quote}} template, as this will cause a:<br />{{in5}}{{fakedummy refreference}}<br />on a line by itself.
 
== Examples ==
Line 124:
 
=== Line breaks ===
This template sets a text style which might ignore one blank line, and so the template must be ended with a break (newline) or the next blank line might be ignored. Otherwise, beware inline, as:<br />{{in5}}text here {{tlptemplate link with parameters|Quote|this is quoted}} More text here<br />spans a blank line, unless a {{tlptemplate link with parameters|Quote|...}} is ended with a line break, then the next blank line might be ignored and two paragraphs joined.
 
{{Blockquote paragraphs}}