Difference between revisions of "Шаблон:Quote box"

From WikiSofia
Jump to: navigation, search
(Создана пустая страница)
 
Line 1: Line 1:
 
+
<div class="quotebox pullquote {{#switch: {{lc:{{{align|}}}}}
 +
        | center = centered
 +
        | left = floatleft
 +
        | none =
 +
        | floatright
 +
    }} {{{class|}}}" style="
 +
    {{#if:{{{width|}}} |width:{{{width}}};}}
 +
    {{#ifeq:{{{border}}}|none|border:none;|{{#if:{{{border|}}}|border-width: {{{border}}}}};}}
 +
    {{#if:{{{fontsize|}}}|font-size: {{{fontsize}}};}}
 +
    {{#if:{{{bgcolor|}}}|background-color: {{#ifeq:{{{bgcolor|}}}|none|transparent|{{{bgcolor}}}}};}}
 +
    {{{style|}}}"><templatestyles src="Template:Quote_box/styles.css" />
 +
{{#if:{{{title|}}}
 +
    |<div class="quotebox-title {{{tclass|}}}" style="
 +
        {{#if:{{{title_bg|{{{bgcolor|}}}}}}|background-color: {{#ifeq:{{{title_bg|{{{bgcolor}}}}}}|none|transparent|{{{title_bg|{{{bgcolor}}}}}}}};}}
 +
        {{#if:{{{title_fnt|}}}|color: {{{title_fnt}}};}}
 +
        {{{tstyle|}}}">{{{title}}}</div>
 +
}}
 +
<div class="quotebox-quote {{#if:{{{quoted|}}}|quoted}} {{#switch: {{lc:{{{qalign|{{{halign|left}}}}}}}}
 +
        |right = right-aligned
 +
        |center = center-aligned
 +
        |left-aligned
 +
    }} {{{qclass|}}}" style="
 +
    {{{qstyle|}}}"><!--
 +
-->{{{text|{{{content|{{{quotetext|{{{quote|{{{1|<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>}}}}}}}}}}}}}}}<!--
 +
--></div>
 +
{{#if:{{{author|{{{source|}}}}}}{{{2|}}}{{{3|}}}|<cite class="{{#switch: {{lc:{{{salign|{{{qalign|{{{halign|left}}} }}} }}} }}
 +
        |right = right-aligned
 +
        |center = center-aligned
 +
        |left-aligned
 +
    }}" style="{{{sstyle|}}}"><!--Manually inserted dashes will need to be removed from uses of the template first, I guess, then enable this:--><!--—&thinsp;-->{{{author|{{{2|}}}}}}{{#if:{{{author|}}}{{{2|}}}|{{#if:{{{source|}}}{{{3|}}}|<!--Display comma-space only if both cite parameters are present.-->,&#32;}}}}{{{source|{{{3|}}}}}}</cite>}}
 +
</div><noinclude>
 +
{{Documentation}}
 +
</noinclude>

Revision as of 20:53, 15 August 2019

Template-specific style sheet:

[просмотр] [править] [история] [обновить]
(i) Документация

Шаблон:Documentation subpage

Шаблон:Tsh Шаблон:High-risk Шаблон:Uses TemplateStyles {{Quote boxШаблон:\sandbox |width=30em |title=Title |quote=Шаблон:Lorem ipsum |author=Author Name |source=source in "Quotes" or Italics as needed}}

This template can be used for block quotations (long quotes set off from the main text). However, this use is not advised Шаблон:Em. 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 article width. (However, do not use {{Cquote}} for block quotations in articles.)
  • 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

For actual quotes, and poems, this template (a variant of {{Quote frame}}) can be used to present a title, quote, author, and source in a box such as that shown opposite, with options to customise its bordering, background, alignment and other aspects. The box itself is floating div, which, like images, can appear on the right or left or across the entire page. Article text will wrap around the div in the first two cases. This is useful in articles that are short on images and need some graphic-like element, or where an important or interesting quote wants to be presented in a way that sets it off from the surrounding text.

Caution: This is a div-based template, so it may malfunction if indented using wikitext syntax. This is a current limitation of the Wikipedia HTML parsing software.

When used with a poem, it is convenient to wrap the poem's content in Шаблон:Tag tags; these preserve line breaks without having to manually insert Шаблон:Tag markup.

Template-specific style sheet:

To be or not to be ...

Parameters

Basic parameters

  • title = Optional title to appear at the top of the quote box.
  • quote = The quote or other text to be displayed in the box.
  • author = Optional name of the author. A Шаблон:Tag reference citation can be added at the end.
  • source = Optional source of the quote ("Quoted" or Italic work title, and other publication data). A Шаблон:Tag reference citation can be added at the end.

Main box styling

  • align: Alignment of the quote box on the page—left / right / center / none. Defaults to right alignment. Using align=none will remove word wrapping.
  • width: The width of the quote box. Defaults to the width of the quote included, unless Шаблон:Para where the width will default to 100%.
  • border: The width of the quote box border. Defaults to 1px. Remember to include 'px' or 'em' to specify the correct width.
  • fontsize: The fontsize of the quote box text. Defaults to 88%.
  • bgcolor: The RGB background color of the box. Defaults to #F9F9F9 (light gray).
  • style: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding parameters.

Title styling

  • title_bg: The RGB background color of the title. Defaults to #F9F9F9 (light gray).
  • title_fnt: The title font color. Defaults to black.
  • tstyle: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding title parameters.

Quote styling

  • qalign: Alignment of the quote element—left / right / center. Defaults to left.
  • qstyle: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding quote parameters.
  • quoted: If this parameter evaluates to true (is not 0, false, or empty) the quote box will enclose the quote in fat-quotes. Use judiciously; do not use in mainspace (articles) per MOS:QUOTE.

Source styling These affect the entire Шаблон:Para and Шаблон:Para block, below the quotation.

  • salign: Alignment of the source element—left / right / center. Defaults to the value of qalign.
  • sstyle: A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding source parameters.

Full syntax

{{Quote box
 |class = <!-- Advanced users only.  See the "Custom classes" section below. -->
 |title = 
 |quote = 
 |author = 
 |source = 
 |align = 
 |width = 
 |border = 
 |fontsize = 
 |bgcolor = 
 |style = 
 |title_bg = 
 |title_fnt = 
 |tstyle = 
 |qalign = 
 |qstyle = 
 |quoted = 
 |salign = 
 |sstyle = 
}}

Examples

Various example codes and their results. For more intricate examples see Template:Quote_box/examples. In the examples the {{lorem ipsum}} template merely generates several lines of sample text without meaning, and is not part of the quote syntax.

Floating and wrapping

Minimal code, defaults to floating right and minimal width:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
}}
{{Lorem ipsum}}

Template-specific style sheet:

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:Lorem ipsum
 

Floating right:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |width  = 50%
 |align  = right
}}
{{Lorem ipsum}}

Template-specific style sheet:

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:Lorem ipsum
 

Floating left:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |width  = 50%
 |align  = left
}}
{{Lorem ipsum}}

Template-specific style sheet:

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:Lorem ipsum
 

Centered, not floating:

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |width  = 50%
 |align  = center
}}
{{Lorem ipsum}}

Template-specific style sheet:

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:Lorem ipsum Шаблон:-

Fat-quotes

{{Quote box
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |quoted = 1
}}

Template-specific style sheet:

Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:-

Alignment of text in box

{{Quote box
 |title = Centered quote
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |qalign = center
}}

Template-specific style sheet:

Centered quote
Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:-

{{Quote box
 |title = Left title, right quote
 |tstyle = text-align: left;
 |quote  = Cry "Havoc", and let slip the dogs of war.
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.
 |qalign = right
}}

Template-specific style sheet:

Left title, right quote
Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.

Шаблон:-

Custom classes

This parameter should only be used by editors who fully understand how this template works.

The "class=" parameter can be used add a generic CSS class to this template. Some classes are not compatible with other options or require specific options be set to be useful or look good.

Letterhead custom class

The "letterhead" class should be used with Шаблон:Para, Шаблон:Para, and Шаблон:Para either not used or set to "none". Since the upper-left-corner will have a white background, it should only be used on pages with a white background.

Care should be taken that neither the title nor the text extends into the "left corner" portion of the box. To use a blank line for a title, use Шаблон:Para. To provide a blank line at the bottom of the letterhead, add <br /><br /> to the end of the Шаблон:Para parameter (or Шаблон:Para, if Шаблон:Para was not used).

{{Quote box
 |class = letterhead
 |title = &nbsp;
 |tstyle = text-align: right;
 |title_bg = none
 |border=none
 |author = [[William Shakespeare]]
 |source = ''[[Julius Caesar (play)|Julius Caesar]]'', Act III, Scene I.<br /><br />
 |qalign = right
}}

Template-specific style sheet:

 
Cry "Havoc", and let slip the dogs of war.

William Shakespeare, Julius Caesar, Act III, Scene I.


 

Collapsing text

Sections of text can be collapsed by use of {{hidden begin}} and {{hidden end}}.

Шаблон:Markup

Note that, although Шаблон:Para, the centering is reset after the {{hidden begin}}, since that template applies its own styling. This can be resolved by using Шаблон:Para in {{hidden begin}} with appropriate markup; in this case:

{{hidden begin |ta2=center|contentstyle=margin: 1em auto;}}

Шаблон:Markup

TemplateData

Шаблон:TemplateData header

Put a quote, and its source, inside a box, with flexible control over bordering, background color, alignment, and other features

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
CSS classclass

Optional CSS class to modify or override the default class ''quotebox''. Care should be used when using this parameter. Consider using other templates instead. See the ''Custom classes'' section of this document for more information.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Titletitle

Optional title to appear at the top of the quote box.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Quotequote

The quote or text to be displayed in the box.

Default
empty
Example
empty
Auto value
empty
Stringrequired
Sourcesource

Optional source of the quote (author, publication, etc.).

Default
empty
Example
empty
Auto value
empty
Stringoptional
Alignmentalign

Alignment of the quote box on the page—left / right / center / none. Defaults to right alignment. Using align=none will remove word wrapping.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Widthwidth

The width of the quote box. Defaults to the width of the quote included, unless align=center where the width will default to 100%. Use CSS lengths eg. 50% or 400px

Default
empty
Example
empty
Auto value
empty
Stringoptional
Border widthborder

The width of the quote box border. Defaults to 1px. Remember to include 'px' or 'em' to specify the correct width.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Font sizefontsize

The fontsize of the quote box text. Defaults to 88%.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Background colorbgcolor

The RGB background color of the box. Defaults to #F9F9F9 (light gray).

Default
empty
Example
empty
Auto value
empty
Stringoptional
CSS stylestyle

A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding parameters.

Default
empty
Example
empty
Auto value
empty
Stringoptional
TItle background colortitle_bg

The RGB background color of the title. Defaults to #F9F9F9 (light gray).

Default
empty
Example
empty
Auto value
empty
Stringoptional
Title font colortitle_fnt

The title font color. Defaults to black.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Title CSS styletstyle

A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding title parameters.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Quote alignmentqalign

Alignment of the quote element—left / right / center. Defaults to left.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Quote CSS styleqstyle

A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding quote parameters.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Add quotes?quoted

If this parameter evaluates to true (is not 0, false, or empty) the quote box will enclose the quote in fat-quotes. Use judiciously, and read the Manual of Style.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Source alignmentsalign

Alignment of the source element—left / right / center. Defaults to the value of qalign.

Default
empty
Example
empty
Auto value
empty
Stringoptional
Source CSS stylesstyle

A generic CSS style parameter. Entries in this parameter supersede any duplicates in the preceding source parameters.

Default
empty
Example
empty
Auto value
empty
Stringoptional


Шаблон:Quotation templatessv:Mall:Citatbox

Во избежание поломок страниц, использующих данный шаблон, желательно экспериментировать в своём личном пространстве.