Template:Rquote: Difference between revisions
(rv redirect. syntax is different between rquote and quotebox, thus redirection results in breaking all existing rquote usages. It would be better to TfD rquote and manually transition.) |
m (85 revisions imported from wikipedia:Template:Rquote) |
||
| (45 intermediate revisions by 23 users not shown) | |||
| Line 1: | Line 1: | ||
<noinclude>The template appears as follows in article space: |
|||
{| class="float{{{1}}}" width="33%" align="{{{1}}}" style="background-color:inherit;border-collapse:collapse;border-style:none;margin: .5em .75em;" |
|||
{{Quote| class = rquote|text={{lorem ipsum}}| style=width:33%}} |
|||
| ⚫ | |||
and as follows in all other namespaces: |
|||
| valign="top" align="left" style="padding:0 10px;" | {{{2<noinclude>|{{Lorem ipsum}}</noinclude>}}} |
|||
</noinclude><templatestyles src="Rquote/styles.css"/>{{main other |
|||
| ⚫ | |||
|demospace={{{demospace|}}} |
|||
|- |
|||
|1=<!-- result if in mainspace -->{{Blockquote |
|||
| colspan="3" style="padding-top: 10px" | {{#if:{{{3|<noinclude>Origin</noinclude>}}}|<p style="font-size:smaller;line-height:1em;text-align: right">'''<cite style="font-style:normal;">—{{{3<noinclude>|Source</noinclude>}}}{{#if:{{{4|<noinclude>Citation</noinclude>}}}|, {{{4<noinclude>|Citation</noinclude>}}}}}</cite>'''</p>}} |
|||
| class = rquote |
|||
| ⚫ | |||
| text = {{trim quotes|{{{text|{{{content|{{{quotetext|{{{quote|{{{2|<includeonly>{{error|Error: No text given for quotation (or equals sign used in the actual argument to an unnamed parameter)}}</includeonly><noinclude>{{lorem ipsum}}</noinclude>}}}}}}}}}}}}}}}}} |
|||
===Related templates=== |
|||
| author = {{{3|{{{author|<noinclude>person quoted</noinclude>}}}}}} |
|||
* [[Template:Cquote]] |
|||
| source = {{#if:{{{4|{{{source|}}}}}}|{{{4|{{{source<noinclude>|cited source</noinclude>}}}}}}}} |
|||
* [[Template:Quotation]] |
|||
| style =float:{{{1|{{{align}}}}}}; width:{{{width|33%}}}; {{{style|}}} |
|||
* [[Template:Quote box]] |
|||
}} |
|||
|2=<!-- result if elsewhere --> |
|||
=== Parameters === |
|||
{{{!}} class="rquote pullquote float{{{1|{{{align}}}}}}" role="presentation" style="display:table; border-collapse:collapse; border-style:none; float:{{{1|{{{align}}}}}}; margin:0.5em 0.75em; width:{{{width|33%}}}; {{{style|}}}" |
|||
{{!}}- style="text-align:left; vertical-align:top;" |
|||
# '''Alignment''' (''left'', ''right'', or ''center''). |
|||
| ⚫ | |||
# '''The Quote Text''' |
|||
{{!}} style="padding:0 10px;"{{!}} {{trim quotes|{{{text|{{{content|{{{quotetext|{{{quote|{{{2|<includeonly>{{error|Error: No text given for quotation (or equals sign used in the actual argument to an unnamed parameter)}}</includeonly><noinclude>{{lorem ipsum}}</noinclude>}}}}}}}}}}}}}}}}} |
|||
# '''Source''' (who said it?) |
|||
| ⚫ | |||
# '''Citation''' (where was it said?) |
|||
{{!}}- |
|||
{{!}} class="rquotecite" colspan="3" style="padding-top:10px; font-size:smaller; line-height:normal; text-align:right;"{{!}} {{#if:{{{3|{{{author|{{{4|{{{source|}}}}}}}}}}}}|<cite>— {{{3|{{{author|<noinclude>person quoted</noinclude>}}}}}}{{#if:{{{4|{{{source|}}}}}}|{{#if:{{{3|{{{author|}}}}}}|,}} {{{4|{{{source<noinclude>|cited source</noinclude>}}}}}}}}</cite>}} |
|||
[[Category:Quotation templates|{{PAGENAME}}]][[Category:Templates using ParserFunctions|{{PAGENAME}}]] |
|||
{{!}}} |
|||
| ⚫ | |||
=== Example === |
|||
{{Documentation}} |
|||
</noinclude> |
|||
<nowiki>{{Rquote|left|The Quote Text|Source|Citation}}</nowiki> |
|||
{{Rquote|center|The Quote Text|Source|Citation}} |
|||
[[fr:modèle:citationD]] |
|||
[[ro:Format:CitareText]]</noinclude> |
|||
Latest revision as of 09:01, 16 June 2021
The template appears as follows in article space:
Lorem ipsum dolor sit amet, consectetur adipiscing 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.
and as follows in all other namespaces:
| “ | Lorem ipsum dolor sit amet, consectetur adipiscing 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. | ” |
Lua error in Module:TNT at line 159: Missing JsonConfig extension; Cannot load https://commons.wikimedia.org/wiki/Data:I18n/Uses TemplateStyles.tab.
 | If this template is used in article space, it will suppress the display of decorative curly quote marks, per MOS:BLOCKQUOTE. |
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[edit source]
For quotes, this template, a variant of the {{Cquote}}, results in a floating quote with the article text wrapping around it, like an image. It is intended for relatively short quotes of 50 or 100 words.
Align quote box to the right:
{{Rquote |1=right |2=text of quotation |3=person quoted |4=cited source}}
Align quote box to the left:
{{Rquote |1=left |2=text of quotation |3=person quoted |4=cited source}}
Named parameters may also be used:
{{Rquote |align=right |quote=text of quotation |author=person quoted |source=cited source}}
It is always safest to explicitly number or name the parameters (especially the quoted text, author, and source), since the presence of any = character in it will break the template if the parameter is not named/numbered.
Compact form[edit source]
If you do not want to use numbered/named parameters, you must use compact form, without whitespace between parameters; MediaWiki parses the entire contents of unnamed parameters extremely literally, including whitespace.
Align quote box to the right (compact version):
{{Rquote|right|text of quotation|person quoted|cited source}}
Align quote box to the left (compact version):
{{Rquote|left|text of quotation|person quoted|cited source}}
If any parameter is numbered, all of them must also be numbered.
Parameters[edit source]
Unnamed parameters[edit source]
- Alignment: The first unnamed parameter. "left" or "right" (case-sensitive) are acceptable values. This parameter is mandatory; there is no default.
- Text of quotation: The second unnamed parameter. If the material contains = characters, remember to either replace those characters with {{=}} or use an explicit
|2=. Quotation marks are supplied by the template and should not be included here. Soft hyphens (­) or<wbr />can be used to influence line breaks within the quote text. - Entity being quoted: The third unnamed parameter. This should not be confused with the author of the source who published the quotation. For example, imagine a John Doe publishes a book, in which he attributes a quotation to Albert Einstein. In that case, "Albert Einstein" is what should be put in this parameter, not "John Doe". This parameter is only mandatory when the fourth parameter is also specified.
- Extra identifier: An optional extra identifier that better identifies the location or time of the occurrence of the quotation. It must not be confused with the title of the source. For example, imagine a John Doe publishes a book; in it, he attributes a quotation to Albert Einstein, claiming Einstein said it in a letter to his colleague. What is put in this parameter is "in a letter to his colleague", not the title of John Doe's book. This parameter is fully optional.
A standard <ref>...</ref> citations is normally attached to the second, third or fourth parameter, whichever comes last.
If any parameter is explicitly numbered, they must all be numbered. If none are numbered, do not use any whitespace between them.
Named parameters[edit source]
These parameters are all optional.
|width=- Width of the quote. It should be a number with a CSS unit of length added to it. Default is 33%. Examples: 20em, 300px. Use of the "px" unit is discouraged.
|style=- Additional CSS style for the quote. Use only as a last measure.
Limitations[edit source]
- This template does not always "play nice" and wrap properly when it is on the left, especially when what immediately follows it is a heading or a list.
- If the quoted content is extremely short, this template looks terrible. The content needs to be at least reach to the other side of the template. If the content is shorter than that, use
{{Cquote}}with its|float=option. - As noted above, if any parameter is explicitly numbered, they must all be numbered. If none are numbered, do not use any whitespace between them.
Example[edit source]
Align right →[edit source]
Code[edit source]
{{Rquote |1=right
|2=This is an example quote with the first option set to ''right''.
|3=[[Anonymity|Anonymous]] |4=''Reduced quote template page''
}}
{{str left|{{Lorem ipsum}}|335}}
Result[edit source]
| “ | This is an example quote with the first option set to right. | ” |
| — Anonymous, Reduced quote template page | ||
Lorem ipsum dolor sit amet, consectetur adipiscing 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.
Align left ←[edit source]
Code[edit source]
{{Rquote |1=left
|2=This is another, slightly longer example quote with the first option set to ''left''.
|3=[[Anonymity|Anonymous]] |4=''Reduced quote template page''
}}
{{Lorem ipsum}}
{{Rquote |1=left |2=This is another, slightly longer ex­ample pull­quote with the first option set to ''left'' and two soft hyphens included in the quote text. |3=[[Anonymity|Anonymous]] |4=''Reduced quote template page'' }} {{Lorem ipsum}}
Result[edit source]
| “ | This is another, slightly longer example quote with the first option set to left. | ” |
| — Anonymous, Reduced quote template page | ||
Lorem ipsum dolor sit amet, consectetur adipiscing 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.
| “ | This is another, slightly longer ex­ample pull­quote with the first option set to left and two soft hyphens included in the quote text. | ” |
| — Anonymous, Reduced quote template page | ||
Lorem ipsum dolor sit amet, consectetur adipiscing 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.