Редактирование: Шаблон:Врезка/doc

{{docpage}}
{{OnTS|Шаблон:Врезка/styles.css}}

Шаблон предназначен для добавления в статьи врезок с текстом и (опционально) заголовком. Такие врезки могут «плавать» сбоку от основного текста.

{{днш|quote box|quotebox|панель}}

== Использование ==
Шаблону можно придавать следующие параметры:
* '''выравнивание''' (необязателен)&nbsp;— расположение врезки относительно основного текста. Может принимать значения <code>right</code> (врезка «плавает» справа), <code>left</code> (врезка «плавает» слева), {{code|center}} (врезка выравнивается по центру) или {{code|none}} (врезка не будет «плавающей»). Значение по умолчанию — {{code|right}}.
* '''ширина''' (необязателен; см. также параметр '''без разрывов''')&nbsp;— ширина врезки в формате [[CSS]] (например, <code>20em</code>). Не указывайте в пикселях — при изменении размера шрифта не будет происходить изменений ширины, что может быть неудобно. По умолчанию значение не задано, и вместо этого параметра работает параметр '''макс. ширина'''.
* '''макс. ширина''' (необязателен)&nbsp;— максимальная ширина врезки; врезка будет у́же, если её содержание не требует всей доступной ширины (в отличие от параметра '''ширина''', при указании которого ширина врезки не зависит от её содержания). По умолчанию значение параметра равно <code>auto</code>. Если параметр '''ширина''' указан, то параметр '''макс. ширина''' игнорируется.
* '''высота''', '''макс. высота''' (необязательны)&nbsp;— аналогично параметрам ширины (см.&nbsp;выше).
* '''размер шрифта''' (необязателен)&nbsp;— размер шрифта основного текста врезки в формате [[CSS]] (например, <code>1.1em</code>, <code>12pt</code>). По умолчанию значение параметра равно <code>90%</code>.
* '''фон''' (необязателен)&nbsp;— цвет фона в формате CSS (например, <code>#EEE9D9</code>). По умолчанию значение параметра равно <tt>#F8F9FA</tt>: {{легенда|#F8F9FA||inline|solid thin}}. Чтобы сделать фон прозрачным, укажите <code>transparent</code>; чтобы использовать тот же цвет, что у родительского элемента HTML, укажите <code>inherit</code>.
* '''без разрывов''' (необязателен; любое значение, например «1»)&nbsp;— запретить разрывы строк в содержании, особенно подходит для стихотворений. По сути, альтернативный способ задания ширины («та ширина, которая нужна»).
* '''заголовок''' (необязателен)&nbsp;— текст заголовка, который отображается крупным шрифтом над основным текстом врезки и отделяется от него чертой. Если заголовок не указан, черта не отображается (остаётся только основной текст врезки).
* '''содержание'''&nbsp;— собственно текст врезки.
* '''заголовок снизу''' (необязателен; любое значение, например «1»)&nbsp;— поместить заголовок не сверху текста врезки, а снизу.
* '''подпись''' (необязательна)&nbsp;— текст, выводящийся в отдельной строке под содержанием.
* '''автор''' (необязательна)&nbsp;— автор цитаты, выводится под содержанием, только если не задан параметр '''подпись'''.
* '''источник''' (необязательна)&nbsp;— источник цитаты, выводится под содержанием, только если не задан параметр '''подпись'''.
* '''выравн. подписи''' (необязательно)&nbsp;— выравнивание ([[Выключка (типографика)|выключка]]) текста подписи: по умолчанию <code>right</code> (вправо), возможны также значения <code>left</code> (влево) и <code>center</code> (по центру).
* '''оригинал'''&nbsp;— если подпись является переводом, то в этом параметре можно указать текст на оригинальном языке.
* '''язык оригинала'''&nbsp;— двух- или трёхбуквенный код языка по стандарту [[ISO 639]].
* '''источник оригинала'''&nbsp;— источник оригинального текста.

== Код для вставки ==
<pre>
{{Врезка
| выравнивание = right
| ширина       = 23em
| заголовок    = 
| содержание   = 
| источник     = 
}}
</pre>

<pre>
{{Врезка
| выравнивание       = <!-- left, right или не указывать -->
| ширина             = 
| макс. ширина       = <!-- не работает, если указана «ширина» -->
| высота             = 
| макс. высота       = <!-- не работает, если указана «высота» -->
| размер шрифта      = 
| фон                = 
| без разрывов       = 
| заголовок          = 
| заголовок снизу    = 
| содержание         = 
| подпись            = 
| автор              = 
| источник           = 
| выравн. подписи    = <!-- left/center/right -->
| оригинал           = 
| язык оригинала     = 
| источник оригинала = <!-- <ref>…</ref> -->
}}
</pre>

== Примеры ==
Ниже показаны примеры кода для вызова данного шаблона и получающиеся результаты.

{| class="wide"
 ! Код
 ! Результат
|-
| style="vertical-align: top" |
<pre>{{Врезка
| выравнивание       = right
| ширина             = 260px
| заголовок          = Тептар
| заголовок снизу    = 1
| содержание         = '''Тептар''' — свободная энциклопедия.
| оригинал           = ''Wikipedia, the free encyclopedia''
| язык оригинала     = en
| источник оригинала = <ref>[https://en.wikipedia.org/wiki/Wikipedia:About Wikipedia:About]</ref>.
}}</pre>
| style="vertical-align: top" |
{{Врезка
| выравнивание       = right
| ширина             = 260px
| заголовок          = Тептар
| заголовок снизу    = 1
| содержание         = '''Тептар''' — свободная энциклопедия.
| оригинал           = ''Wikipedia, the free encyclopedia''
| язык оригинала     = en
| источник оригинала = <ref>[https://en.wikipedia.org/wiki/Wikipedia:About Wikipedia:About]</ref>.
}}{{-}}
{{примечания}}
|-
| style="vertical-align: top" |
<pre>{{Врезка
| выравнивание = right
| без разрывов = 1
| заголовок    = Александр Блок
| содержание   = <poem>
Ночь, улица, фонарь, аптека,
Бессмысленный и тусклый свет.
Живи ещё хоть четверть века —
Все будет так. Исхода нет.
</poem>
| подпись      = ''10 октября 1912''
}}</pre>
| style="vertical-align: top" |
{{Врезка
| выравнивание = right
| без разрывов = 1
| заголовок    = Александр Блок
| содержание   = <poem>
Ночь, улица, фонарь, аптека,
Бессмысленный и тусклый свет.
Живи ещё хоть четверть века —
Все будет так. Исхода нет.
</poem>
| подпись      = ''10 октября 1912''
}}
|-
| style="vertical-align: top" |
<pre>{{Врезка
| выравнивание = right
| без разрывов = 1
| содержание   = <poem>
Ночь, улица, фонарь, аптека,
Бессмысленный и тусклый свет.
Живи ещё хоть четверть века —
Все будет так. Исхода нет.
</poem>
| автор      = Александр Блок
}}</pre>
| style="vertical-align: top" |
{{Врезка
| выравнивание = right
| без разрывов = 1
| содержание   = <poem>
Ночь, улица, фонарь, аптека,
Бессмысленный и тусклый свет.
Живи ещё хоть четверть века —
Все будет так. Исхода нет.
</poem>
| автор      = Александр Блок
}}
|}

== См. также ==
<!-- в алфавитном порядке -->
* {{tl|Кратное изображение}}
* {{tl|Панорама}}
* {{tl|Рамка в стиле миниатюры}}
* {{tl|Файл с описанием}}
* {{tl|Фотоколонка}}
* {{tl|Фотоколонка+}}
* {{tl|Фотомонтаж}}
* {{tl|Фоторяд}}<includeonly>

[[Категория:Шаблоны:Блоки и панели]]
[[Категория:Шаблоны:Цитирование]]
</includeonly>