Шаблон:Ombox/Дакументацыя

Дакументацыя да шаблона Ombox.

Мета-шаблоны вокан паведамленняў

{{ambox}} (t)

{{cmbox}} (t)

{{mbox}} (t)

{{ombox}} (t)

{{tmbox}} (t)

{{fmbox}} (t)

Гэты мета-шаблон (other pages message box) выкарыстоўваецца для фарміравання інфармацыйных паведамленняў у прасторах «Удзельнік», «Вікіпедыя», «MediaWiki», «Шаблон», «Даведка», і іншых, якія не пакрываюцца шаблонамі {{ambox}}, {{tmbox}}, {{imbox}} або {{cmbox}}. Таму ён не павінен выкарыстоўвацца на старонках слоўнікавых артыкулаў, старонках абмеркавання, старонках малюнкаў і старонках катэгорый.

Гэты шаблон падобны шаблону {{ambox}}і выкарыстоўвае большасць яго параметраў.

Выкарыстанне

Простае выкарыстанне:

{{ombox | text = Звычайны тэкст. }}

Складанае выкарыстанне:

{{ombox
| type      = style
| image     = [[Файл:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = The message body text.
}}

Тыпы паведамленняў на іншых старонках

Наступныя прыклады выкарыстоўваюць розныя значэнні параметру type, але не змяняюць параметры адлюстравання значка (абразкі), таму ўсюды адлюстроўваецца карцінка па змаўчанні.

Прыклады выкарыстання

Прыклады выкарыстання ў паведамленнях тыпу «notice».

Параметры

Спіс усіх параметраў:

{{ombox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[Файл:Some image.svg|40px]]
| imageright = [[Файл:Some image.svg|40px]]
| style = CSS values
| textstyle = CSS values
| text  = The message body text. 
| small = {{{small|}}} / yes
| smallimage = none / [[Файл:Some image.svg|30px]]
| smallimageright = none / [[Файл:Some image.svg|30px]]
| smalltext  = A shorter message body text.
}}

type

няма параметра = калі параметр type не зададзены, то выкарыстоўваецца значэнне па змаўчанні notice (блакітны фон).

image

няма параметра = калі параметр image не зададзены, то выкарыстоўваецца значок па змаўчанні ў залежнасці ад таго што зададзена ў параметры type.

файл выявы = спасылка на файл якая выкарыстоўвае вікі разметку. Памер падганяецца пад 40px — 50px у шырыню ў залежнасці ад суадносін бакоў у арыгінале. (Але можна задаць і адвольны памер). Напрыклад:

image = [[Файл:Sub-arrows.svg|40px]]

none = пазначае, што не трэба адлюстроўваць значок.

imageright

няма параметра = калі параметр imageright не зададзены, то значок справа не паказваецца.

файл выявы = спасылка на файл якая выкарыстоўвае вікі разметку. Памер падганяецца пад 40px — 50px у шырыню ў залежнасці ад суадносін бакоў у арыгінале. (Але можна задаць і адвольны памер). Напрыклад:

imageright = [[Файл:Nuvola apps bookcase.png|40px]]

іншае = усё што вы хочаце адлюстраваць справа.

style

Дадатковы параметр стылю CSS для ўсёй табліцы. Напрыклад:

style = margin-bottom: 0.5em;

textstyle

Дадатковы параметр стылю CSS для тэкставай ячэйкі. Напрыклад:

textstyle = text-align: center;

text

Тэкст паведамлення.

Параметры мініяцюрызацыі

small

yes = Стварае маленькае акно паведамлення якое прымацоўваецца да правага краю старонкі. Гэты параметр таксама памяншае значок па змаўчанні. Звярніце ўвагу, што дадзеныя пераданыя ў параметрах smallimage, smallimageright і smalltext выкарыстоўваюцца толькі калі «small=yes». Каб вытворны шаблон разумеў параметр small выкарыстоўвайце наступны код:

small = {{{small|}}}

smallimage

няма параметра = калм параметр smallimage не зададзены, то зноў выкарыстоўваецца параметр image. Калі параметр image таксама пусты, то выкарыстоўваецца маленькі значок па змаўчанні.

файл выявы = спасылка на файл якая выкарыстоўвае вікі разметку. Звычайна каля 20px для паведамленняў у адзін радок і да 25px у шырыню для дзвюх радкоў тэксту. Напрыклад:

smallimage = [[Файл:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]

none = пазначае, што не трэба адлюстроўваць значок. Перавызначаем зададзенае ў параметры image, калі «small=left».

smallimageright

няма параметра = калі параметр smallimageright не зададзены, то зноў выкарыстоўваецца параметр imageright. Калі параметр imageright таксама пусты, то выкарыстоўваецца значок справа не з'явіцца.

файл выявы = спасылка на файл якая выкарыстоўвае вікі разметку. Каля 30px у шырыню. Напрыклад:

smallimageright = [[Файл:Nuvola apps bookcase.png|30px|alt=Three stacked books]]

іншае = усё што вы хочаце адлюстраваць справа.

none = пазначае, што не трэба адлюстроўваць значок справа. Перавызначаем зададзенае ў параметры imageright, когда «small=yes».

smalltext

Кароткі варыянт тэксту паведамлення. Калі параметр smalltext не зададзены, то зноў выкарыстоўваецца параметр text.

Тэхнічныя дэталі

Калі вам неабходна выкарыстоўваць спецыяльныя сімвалы ўнутры параметру text, то вам неабходна замяняць іх ESC-паслядоўнасцямі:

{{ombox
| text  = <div>
Тут знак роўнасці = адчыняе і зачыняе фігурныя дужкі { }.  
А тут знак падзелу параметраў {{!}} і дзве зачыняючыя фігурныя дужкі <nowiki>}}</nowiki>. 
А тут знак падзелу параметраў перад дзвюма зачыняючымі фігурнымі дужкамі <nowiki>|}}</nowiki>.
</div>
}}

Гэты шаблон выкарыстоўвае ombox CSS-класы ў MediaWiki:Common.css што ўплываюць на яго знешні выгляд, гэта значыць ён цалкам пераналаджваецца.

Унутры шаблону для фарміравання кода табліцы выкарыстоўваецца мова разметкі HTML замест мовы вікі-разметкі. Так робіцца ва ўсіх мета-шаблонах, так як у вікі-разметкі ёсць шэраг недахопаў. Напрыклад, яна ўскладняе выкарыстанне функцый парсера і спецыяльных знакаў у параметрах.