Шаблон:Ambox
 |
Дакумэнтацыя
Ambox (англ. Article Message BOX) — базавы шаблон для розных шаблонаў-паведамленняў у прасторы артыкулаў Вікікніг.
Ён прапануе некалькі розных колераў, выкрыстоўвае выявы па змоўчванні, калі параметр выявы не дадзены і ён мае іншыя ўласцівасці. Класы таксама могуць выкарыстоўвацца напрамую ў вікітабліцы, калі патрабуецца адмысловая функцыянальнасць. Глядзіце гэта ў пакрокавым кіраўніцтве.
Выкарыстанне
{{ambox
|text = Загаловак паведамлення.
}}
| Загаловак паведамлення. |
Складаны прыклад:
{{ambox
|type=style
| small = left
| image = [[Image:Emblem-question-yellow.svg|40px]]
| smallimage = [[Image:Emblem-question-yellow.svg|20px]]
| textstyle = color: red; font-weight: bold; font-style: italic;
| text = Тэкст для вялікага поля, угары артыкулаў.
| smalltext = Тэкст для размяшчэння ўгары секцый артыкулаў.
}}
 | Тэкст для размяшчэння ўгары секцый артыкулаў. |
Але вы не абавязкова павінны выкарыстоўваць чырвоны паўтлусты курсіўны тэкст.
Тыпы старонак палёў паведамленняў
Наступныя прыклады выкарыстоўваюць розныя тыпы параметраў, але не выкарыстоўваюць параметры выяў, так што яны выкарыстоўваюць выявы па змоўчванні для кожнага тыпу.
 | type=хутка – Выпадкі хуткага выдалення. |
Абарона
{{ambox
|type=protection
|text=Загаловак паведамлення.
}}
 | Загаловак паведамлення. |
Праблемы са зместам
 | type=змест – Праблемы са зместам. |
Праблемы са стылем
 | type=стыль – Праблемы са стылем. |
Выдаленне
{{ambox
|type=delete
|text=Загаловак паведамлення.
}}
| Загаловак паведамлення. |
| type=паведамленне – Паведамленні на старонках. |
 | type=Перамясціць – Прапановы аб’яднання, раздзялення ці зрабіць што-небудзь у іншых вікі. |
Іншыя выявы
Выявы па змоўчванні паказаныя вышэй прызначаныя пераважна для зручнасці. У шмат якіх выпадках пасуюць больш асаблівыя выявы. Гэтыя выпадкі выкарыстоўваюць параметр image, каб пазначыць выяву не па змоўчванні.
 | type = content image = [[Image:Unbalanced scales.svg|40px]] Гэтая выява часта выкарыстоўваецца для прыцягення ўвагі да пытання нейтральнасці ці падобных выпадкаў. |
 | type = move image = [[Image:Merge-arrows.svg|50px]] Гэтая выява выкарыстоўваецца для аб’яднання і г. д. |
Больш прыкладаў
Некаторыя спалучэнні параметраў.
| Без тэксту і выявы (default) |
Няма тыпу і image=none – Выява не выкарыстоўваецца, а text выкарыстоўвае ўсю плошчу паведамлення. |
 | image = [[Image:Gnome globe current event.svg|42px]] imageright = [[Image:Nuvola apps bookcase.svg|40px]] |  |
Параметры
Спіс усіх параметраў:
{{ambox
| type = speedy / delete / content / style / notice / move / protection
| image = none / [[Image:Some image.svg|40px]]
| imageright = [[Image:Some image.svg|40px]]
| style = CSS values
| textstyle = CSS values
| text = Тэкст асноўнай часткі паведамлення.
| small = {{{small|}}} / left
| smallimage = none / [[Image:Some image.svg|20px]]
| smallimageright = none / [[Image:Some image.svg|20px]]
| smalltext = Карацейшы тэкст паведамлення.
}}
type
- Калі параметр type не пазначаны, па змоўчванні выкарыстоўваецца тып notice. Гэта абазначае, што колер бакавой панэлі будзе блакітным.
image
- No parameter = Калі параметр image не пададзены, шаблон выкарыстоўвае выяву па змоўчванні. Якая выява выкарыстоўваецца па змоўчванні, залечыць ад параметра type.
- An image = Павінен быць выявай са звычайным запісам вікі. Звычайна падыходзіць шырыня 40пкс - 50пкс у залежнасці ад вышыні выявы і суадносінаў шырыні і вышыні. (Выявы шырынёй больш за 52 пікселяў прыводзяць да праблем з палямі.) Напрыклад:
image = [[Image:Unbalanced scales.svg|40px]]
- none = Абазначае, што выява не выкарыстоўваецца.
blank= Гэты параметр зараз не выкарыстоўваецца. Калі вы бачыце, што ён выкарыстоўваецца, змяніце яго на "image=none".
imageright
- No parameter = Калі не пазначаны параметр imageright, то выява справа не паказваецца.
- An image = Павінна быць выявай са звычайным запісам вікі. Звычайна падыходзіць шырыня 40пкс - 50пкс у залежнасці ад вышыні выявы і суадносінаў шырыні і вышыні. (Выявы больш за 52 пікселяў шырынёй будуць прыводзіць да праблем з палямі.) Напрыклад:
imageright = [[Image:Nuvola apps bookcase.png|40px]]
- Anything = Любы іншы аб’ект, які вы хочаце паказаць справа.
style
- Неабавязковыя значэнні CSS выкарыстоўваюцца поўнай табліцай вакна паведамлення. Без двухкоссяў
" ", але з кропкай з коскай напрыканцы;. Напрыклад:style = margin-bottom: 0.5em;
textstyle
- Неабавязковыя значэнні CSS выкарыстоўваюцца тэкставай ячэйкай. Напрыклад:
textstyle = text-align: center;
text
- Цела тэксту паведалення.
Малыя параметры
Малыя вокны паведамленняў у артыкулах прызначаныя для верху секцый. Звычайна яны павінны толькі ўтрымліваць адзін ці два радкі тэксту.
 | small = yes |
 | type = style small = left |
small
- left = Робіць вакно паведамлення меншым і размяшчае яго злева. Гэта таксама робіць выявы па змоўчванні меншымі. Звярніце ўвагу, што любыя дадзеныя, якія перадаюцца параметрам smallimage, smallimageright і smalltext выкарыстоўваюцца толькі калі "small=left". Каб шаблон таксама разумеў малыя параметры, вы можаце зрабіць з дапомогай наступнага коду:
small = {{{small|}}}
| small = left image = [[Image:Replacement filing cabinet.svg|50px]] smallimage = [[Image:Replacement filing cabinet.svg|25px]] |
smallimage
- No parameter = Калі параметр smallimage не пазначаны, што гэты шаблон будзе выкарыстоўваць параметр image, як звычайна. Калі параметр image таксама пусты, тады будзе выкарыстоўвацца малая выява па змоўчванні.
- An image = Павінна быць выява са звычайным запісам вікі. Звычайна для вакенцаў з адным радком тэксту падыходзіць шырыня каля 20пкс, а для вакенцаў з двума радкамі тэксту шырыня каля 25пкс. Напрыклад:
smallimage = [[File:Gnome globe current event.svg|20px]]
- none = Абазначае, што выява не выкарыстоўваецца. Гэта абыходзіць любыя выявы, пазначаныя ў параметры image, калі "small=left".
| small = yes imageright = [[File:Gnome globe current event.svg|50px]] smallimageright = none |
smallimageright
- No parameter = Калі параметр smallimageright не пазначаны, што гэты шаблон будзе выкарыстоўваць параметр imageright. Калі параметр imagerightтаксама пусты, тады выява справа не будзе паказвацца.
- An image = Павінна быць выява са звычайным запісам вікі. Звычайна падыходзіць шырыня каля 20пкс - 25пкс. Напрыклад:
smallimageright = [[Image:Nuvola apps bookcase.png|20px]]
- Anything = Толькі іншы аб’ект, які вы хочаце паказаць справа.
- none = Абазначае, што выява справа не выкарыстоўваецца. Гэта абыходзіць любую выяву, перададзеную параметру imageright, тады "small=left".
smalltext
- Карацейшая версія тэксту цела паведамлення. Калі параметр smalltext не пададзены, то гэты шаблон выкарыстоўвае параметр text як звычайна.
Тэхнічныя падрабязнасці
Калі вам трэба выкарыстаць спецыяльныя сімвалы ў тэксце параметраў, гэта можна зрабіць наступным чныам:
{{ambox
| text = <div>
Equal sign = and a start and end brace { } work fine as they are.
But here is a pipe | and two end braces <nowiki>}}</nowiki>.
And now a pipe and end braces <nowiki>|}}</nowiki>.
</div>
}}
| Equal sign = and a start and end brace { } work fine as they are. But here is a pipe | and two end braces }}. And now a pipe and end braces |}}. |
Тэгі <div>, якія акружаюць тэкст у прыкладзе вышэй, звычайна не патрэбныя. Але калі тэкст утрымлівае пераносы радкоў, тады часам мы атрымліваем дзіўныя вышыні радкоў. Асабліва гэта здараецца, калі выкарыстоўваюцца ненумараваныя спісы. Тады выкарыстоўвайце тэгі div, каб выправіць гэта.