Template:Quote frame/doc

From PBBG Wiki, The enyclopedia of Persistent Browser-Based Games
< Template:Quote frame
Revision as of 01:08, 10 October 2019 by FoohonPie (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


The Manual of Style guidelines for block quotations recommend formatting block quotations using the {{Quote}} 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}} provides a borderless quote with decorative quotation marks, and {{Quote frame}} provided a bordered quote. Both span the page width.
  • For very short quotes, {{Rquote}} (with decorative quotation marks) 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

This template provides a quotation in a bordered box, on a light grey background, and spanning the page width by default. Do not put quotation marks around the quoted material.

Markup Renders as
{{Quote frame |quote=Quoted material |author=Author |title=Title |source=other details}}

{{Quote frame|Quoted material|Author|Title|other details}}
Quoted material — Author, Title, other details
{{Quote frame |quote=Quoted material |author=Author |source="Article Title", ''Newspaper Name'', date}}

{{Quote frame|Quoted material|Author||"Article Title", ''Newspaper Name'', date}}
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.
{{Quote frame |quote=Quoted material |author=Author |title=Title}}

{{Quote frame|Quoted material|Author|Title}}
Quoted material — Author, Title
{{Quote frame |quote=Quoted material}}

{{Quote frame|Quoted material}}
Quoted material
{{Quote frame |quote=Quoted material |source="Article Title", ''Newspaper Name'', date}}

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

The |width= parameter takes any valid CSS width value, such as 33% or 25em. This should not be specified in fixed pixel sizes (like 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 (=)

If any of the parameters' content include an equal sign (=) in its input, this will make the template not recognize the parameter properly unless:

  • The parameters are named or numbered:

     {{Quote frame |quote=Einstein's equation, E=mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it. |author=Abdul Kalam}}
     {{Quote frame |1=Einstein's equation, E=mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it. |2=Abdul Kalam}}

  • The = in the content is escaped with the {{=}} template:

     {{Quote frame|Einstein's equation, E{{=}}mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|Abdul Kalam}}

  • The = in the content is escaped with the &#61; character reference:

     {{Quote frame|Einstein's equation, E&#61;mc2, has to reach everywhere. Science is a beautiful gift to humanity, we should not distort it.|Abdul Kalam}}

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly error report for this template.

TemplateData for Quote frame

<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 Template: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 28 November 2015 using {{quote frame}} in a discussion that will later be archived with {{archive top}} and {{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:
    :{{quote frame|quoted material}}

Example of bug:

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

results in:

The following discussion is closed. Please do not modify it. Subsequent comments should be made on the appropriate discussion page. No further edits should be made to this discussion.

Some text here.

quoted text

More text here.


The discussion above is closed. Please do not modify it. Subsequent comments should be made on the appropriate discussion page. No further edits should be made to this discussion.

Redirects


See also