View source for Template:Quote frame/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES WHERE INDICATED AT THE END OF THIS PAGE -->__NOTOC__
{{tsh|qf|}}
{{Quote/doc/boilerplate}}

== Usage ==
{{hatnote|Compatibility warning: This template uses {{para|title}} for the italicized title of a major work, not for a heading above the quotation as some other templates do.}}
This template provides a quotation in a bordered box, on a light grey background, and spanning the page width by default. {{strong|Do not put quotation marks around the quoted material.}}

{{Markup
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki> |quote=Quoted material |author=Author |title=Title |source=other details}}</nowiki>

<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material|Author|Title|other details}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|Author|Title|other details}}
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki> |quote=Quoted material |author=Author |source="Article Title", ''Newspaper Name'', date}}</nowiki>

<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material|Author||"Article Title", ''Newspaper Name'', date}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|Author||"Article Title", ''Newspaper Name'', date}}In the short syntax, the 3rd parameter (which auto-italicizes) has been included but left empty to skip it, and we use the 4th to manually apply italics where needed.
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki> |quote=Quoted material |author=Author |title=Title}}</nowiki>

<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material|Author|Title}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|Author|Title}}
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki> |quote=Quoted material}}</nowiki>

<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material}}
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki> |quote=Quoted material |source="Article Title", ''Newspaper Name'', date}}</nowiki>

<nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material|||"Article Title", ''Newspaper Name'', date}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|||"Article Title", ''Newspaper Name'', date}}In the short syntax, we skip two parameters by giving them empty.
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material |align=center}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|align=center}}
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material |align=right}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|align=right}}
| <nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|Quoted material |align=right |width=33%}}</nowiki>
| {{ {{BASEPAGENAME}}|Quoted material|align=right|width=33%}}
}}

The {{para|width}} parameter takes any valid CSS width value, such as {{kbd|33%}} or {{kbd|25em}}. This should not be specified in fixed pixel sizes (like {{!mxt|100px}}).  As shown in the table above, the width is relative to the size of the container not the entire page, so the displayed width will be smaller if used inside a table.

=== The equal sign (<kbd>=</kbd>) ===

If any of the parameters' content include an equal sign (<code>=</code>) in its input, this will make the template not recognize the parameter properly unless:
* The parameters are named or numbered:
{{in5}}{{tlx|{{BASEPAGENAME}} |quote{{=}}Einstein's equation, {{var|E}}{{=}}{{var|m}}{{var|c}}{{sup|2}}, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.&nbsp;|author{{=}}Abdul Kalam}}<br />
{{in5}}{{tlx|{{BASEPAGENAME}} |1{{=}}Einstein's equation, {{var|E}}{{=}}{{var|m}}{{var|c}}{{sup|2}}, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.&nbsp;|2{{=}}Abdul Kalam}}
* The <code>=</code> in the content is escaped with the {{tlx|{{=}}}} template:
{{in5}}{{tlx|{{BASEPAGENAME}}|Einstein's equation, {{var|E}}<nowiki>{{=}}</nowiki>{{var|m}}{{var|c}}{{sup|2}}, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|Abdul Kalam}}
* The <code>=</code> in the content is escaped with the <code>&amp;#61;</code> character reference:
{{in5}}{{tlx|{{BASEPAGENAME}}|Einstein's equation, {{var|E}}&amp;#61;{{var|m}}{{var|c}}{{sup|2}}, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|Abdul Kalam}}

== TemplateData ==
{{TemplateData header}}

<templatedata>
{
  "description": "insert description here",
  "params": {
    "1": {
      "label": "Quoted material",
      "description": "",
      "type": "string",
      "required": true
    },
    "2": {
      "label": "Author",
      "description": "",
      "type": "string",
      "required": false
    },
    "3": {
      "label": "Title",
      "description": "",
      "type": "string",
      "required": false
    },
    "4": {
      "label": "Publication",
      "description": "Use <ref>and {{Cite book}} etc.",
      "type": "string",
      "required": false
    },
    "align": {
      "label": "Alignment",
      "description": "Alignment of the quote box on the page—left / right / center / none. Defaults to none alignment.",
      "type": "string",
      "required": false
    },
    "width": {
      "label": "Width",
      "description": "Fixed width of the quote box, in a valid CSS value. Defaults to no fixed width.",
      "type": "string",
      "required": false
    }
  }
}
</templatedata>

== Bugs ==
*{{as of|2015|11|28}} using {{tl|quote frame}} in a discussion that will later be archived with {{tl|archive top}} and {{tl|archive bottom}} will cause problems if the line in which the template is used in is intended with colons.  In other words, avoid doing this if you expect the discussion to be archived using the "archive top" and "archive bottom" templates:
*:<nowiki>:{{quote frame|quoted material}}</nowiki>

Example of bug:
<pre>
{{archive top}}
Some text here.
:{{quote frame|quoted text}}
More text here.
{{archive bottom}}
</pre>
results in:

{{archive top}}
Some text here.
:{{quote frame|quoted text}}
More text here.
{{archive bottom}}

== Redirects ==
{{Special:WhatLinksHere/Template:Quote frame|hidetrans=1|hidelinks=1}}

== See also ==
* [[Wikipedia:Quotations and neutrality]]
{{Quotation templates}}

<includeonly>{{Sandbox other||
<!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Enhanced quote templates]]
}}</includeonly>