Үлгі:Мбох

[едіт] [] Темплате доцұментатіон

Тһіс іс тһе {{мбох}} ор мессаге бох мета-темплате.

Ыт іс ұсед то бұілд мессаге бох темплатес сұцһ ас Темплате:сецұрітy. Ыт офферс северал діфферент цолоұрс, ұсес дефаұлт імагес іф но імаге параметер іс гівен анд іт һас соме отһер феатұрес.

Тһіс мета-темплате ұсес тһе мбох ЦСС цлассес ін МедіаУікі:Цоммон.цсс. Тһе цлассес цан алсо бе ұсед дірецтлy ін а уікітабле іф спеціал фұнцтіоналітy іс неедед. Сее тһе һоу-то гұіде фор тһат.

Ұсаге

Сімпле ұсаге ехампле:

{{mbox | text = Some text.}}

Цомплех ехампле:

{{mbox
| type       = style
| small      = left
| image      = [[File:GeoGebra_48.png|40px|alt=Question mark]]
| smallimage = [[File:GeoGebra_48.png|20px|alt=Question mark]]
| textstyle  = color: red; font-weight: bold; font-style: italic;
| text       = Text for a big box, for the top of articles.
| smalltext  = Text for the top of article sections.
}}

Бұт ёұ аре нот реаллy сұппосед то ұсе ред болд італіц техт.

Мессаге бох тyпес

Тһе фоллоуінг ехамплес ұсе діфферент тyпе параметерс бұт ұсе но імаге параметерс тһұс тһеy ұсе тһе дефаұлт імагес фор еацһ тyпе.

Отһер імагес

Тһе дефаұлт імагес сһоун абове аре мостлy фор цонвеніенце. Ын манy цасес іт іс море аппропріате то ұсе море спеціфіц імагес. Тһесе ехамплес ұсе тһе імаге параметер то спеціфy ан імаге отһер тһан тһе дефаұлт імагес.

Море ехамплес

Соме отһер параметер цомбінатіонс.

Параметерс

Ліст оф алл параметерс:

{{mbox
| type  = critical / serious / warning / notice / / move / protection
| image = none / [[File:...|40px|...]]
| imageright = [[File:...|40px|...]]
| style = CSS values
| textstyle = CSS values
| text  = The message body text.
| small = {{{small|}}} / left
| smallimage = none / [[File:...|20px|...]]
| smallimageright = none / [[File:...|20px|...]]
| smalltext  = A shorter message body text.
}}

тyпе

Ыф но тyпе параметер іс гівен тһе темплате һас а 'бланк' стyле.

імаге

Но параметер = Ыф но імаге параметер іс гівен тһе темплате ұсес а дефаұлт імаге. Уһіцһ дефаұлт імаге іт ұсес депендс он тһе тyпе параметер.

Ан імаге = Сһоұлд бе ан імаге уітһ ұсұал уікі нотатіон. Уідтһс оф 40пх - 50пх аре ұсұаллy абоұт рігһт. (Ымагес овер 52 піхелс уіде уілл цаұсе паддінг проблемс.)

Офтен ан іцон іс пұрелy децоратіве ін тһе У3Ц сенсе тһат іт репеатс тһе техт. То імпрове аццессібілітy, іт іс десірабле то нот һаве іт бе анноұнцед бy у:сцреен реадерс, ас уелл ас то авоід іт лінкінг то ан іррелевант паге. Ыф (анд онлy іф) тһе імаге ліценсе аллоус тһіс, іт цан бе маркед уітһ "|лінк=|алт=". Фор ехампле:

image = [[File:Unbalanced scales.svg|40px|link=|alt=]]

Цонверселy, ан іцон тһат доес нот ұсе "|лінк=|алт=", анд уһіцһ тһерефоре іс анноұнцед то вісұаллy імпаіред реадерс, сһоұлд ұсе ан "|алт=алт техт" параметер тһат десцрібес тһе іцон. Уітһ но |лінк= параметер (ұсінг тһе дефаұлт лінк), тһе алт техт сһоұлд десцрібе тһе іцон'с вісұал аппеаранце. Фор ехампле:

image = [[File:Gnome globe current event.svg|40px|alt=Clock over a larger globe]]

Уітһ а нонемптy "|лінк=Паге" тһе алт техт сһоұлд десцрібе тһе іцон'с фұнцтіон. Фор ехампле:

image = [[File:Purple question mark.svg|40px|link=Special:Random|alt=Random article]]

Ан іцон уһосе ліценсе реқұірес аттрібұтіон маy һаве алт техт, бұт мұст кееп тһе дефаұлт лінк. Алтһоұгһ пұбліц домаін імагес до нот реқұіре а лінк, манy ліценсес до реқұіре оне. Плеасе сее Пұрелy децоратіве імагес фор море інформатіон абоұт ліценсінг.

ноне = Меанс тһат но імаге іс ұсед.

бланк = Тһіс параметер іс ноу депрецатед. Ыф ёұ сее іт ін ұсе, цһанге іт то "імаге=ноне".

імагерігһт

Но параметер = Ыф но імагерігһт параметер іс гівен тһен но імаге іс сһоун он тһе рігһт сіде.

Ан імаге = Сһоұлд бе ан імаге уітһ ұсұал уікі нотатіон. 40пх - 50пх уідтһ аре ұсұаллy абоұт рігһт депендінг он тһе імаге һеігһт то уідтһ ратіо. (Ымагес овер 52 піхелс уідтһ уілл цаұсе паддінг проблемс.) Фор ехампле:

imageright = [[File:Nuvola apps bookcase.png|40px|alt=Three stacked books]]

Анyтһінг = Анy отһер обжецт тһат ёұ уант то сһоу он тһе рігһт сіде.

стyле

Оптіонал ЦСС валұес ұсед бy тһе ентіре мессаге бох табле. Уітһоұт құотатіон маркс " " бұт уітһ тһе ендінг семіцолонс ;. Фор ехампле:

style = margin-bottom: 0.5em;

техтстyле

Оптіонал ЦСС валұес ұсед бy тһе техт целл. Фор ехампле:

textstyle = text-align: center;

техт

Тһе мессаге бодy техт.

Тһе смалл параметерс

Тһе смалл артіцле мессаге бохес аре меант фор тһе топ оф сецтіонс. Нормаллy тһеy сһоұлд онлy цонтаін оне ор туо лінес оф техт.

смалл

лефт = Макес іт а смаллер лефт алігнед мессаге бох. Тһіс алсо макес тһе дефаұлт імагес смаллер. Ноте тһат анy дата фед то тһе смаллімаге, смаллімагерігһт анд смаллтехт параметерс іс онлy ұсед іф "смалл=лефт". То маке іт со ёұр темплате алсо ұндерстандс тһе смалл параметер ёұ цан ұсе тһіс цоде:

small = {{{small|}}}

смаллімаге

Но параметер = Ыф но смаллімаге параметер іс гівен тһен тһіс темплате фаллс бацк то ұсе тһе імаге параметер. Ыф тһе імаге параметер алсо іс емптy тһен а смалл дефаұлт імаге іс ұсед.

Ан імаге = Сһоұлд бе ан імаге уітһ ұсұал уікі нотатіон. 20пх уідтһ іс ұсұаллy абоұт рігһт фор бохес уітһ оне ліне оф техт, уһіле 25пх уідтһ іс ұсұаллy абоұт рігһт фор бохес уітһ туо лінес оф техт. Фор ехампле:

smallimage = [[File:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]

ноне = Меанс тһат но імаге іс ұсед. Тһіс оверрідес анy імаге фед то імаге, уһен "смалл=лефт".

смаллімагерігһт

Но параметер = Ыф но смаллімагерігһт параметер іс гівен тһен тһіс темплате фаллс бацк то ұсе тһе імагерігһт параметер. Ыф тһе імагерігһт параметер алсо іс емптy тһен но імаге іс сһоун он тһе рігһт сіде.

Ан імаге = Сһоұлд бе ан імаге уітһ ұсұал уікі нотатіон. 20пх - 25пх уідтһ іс ұсұаллy абоұт рігһт. Фор ехампле:

smallimageright = [[File:Nuvola apps bookcase.png|20px|alt=Three stacked books]]

Анyтһінг = Анy отһер обжецт тһат ёұ уант то сһоу он тһе рігһт сіде.

ноне = Меанс тһат но рігһт сіде імаге іс ұсед. Тһіс оверрідес анy імаге фед то імагерігһт, уһен "смалл=лефт".

смаллтехт

А сһортер версіон оф тһе мессаге бодy техт. Ыф но смаллтехт параметер іс гівен тһен тһіс темплате фаллс бацк то ұсе тһе техт параметер.

Тецһніцал детаілс

Ыф ёұ неед то ұсе спеціал цһарацтерс ін тһе техт параметер тһен ёұ неед то есцапе тһем ліке тһіс:

{{mbox
| text  = <div>
Equal sign = and a start and end brace { } work fine as they are.
But here is a pipe &#124; and two end braces <nowiki>}}</nowiki>.
And now a pipe and end braces <nowiki>|}}</nowiki>.
</div>
}}

Тһе <div> тагс тһат сұрроұнд тһе техт ін тһе ехампле абове аре ұсұаллy нот неедед. Бұт іф тһе техт цонтаінс ліне бреакс тһен сометімес уе гет уеірд ліне спацінг. Тһіс еспеціаллy һаппенс уһен ұсінг вертіцал доттед лістс. Тһен ұсе тһе дів тагс то фіх тһат.

Тһіс темплате ұсес ЦСС цлассес ін МедіаУікі:Цоммон.цсс фор мост оф ітс лоокс, тһұс іт іс фұллy скіннабле.

Тһіс темплате цаллс {{мбох/цоре}} уһіцһ һолдс мост оф тһе цоде фор {{мбох}}, уһіле {{мбох}} ітселф доес параметер препроцессінг.

Ынтерналлy тһіс мета-темплате ұсес ҺТМЛ уікімаркұп інстеад оф уікімаркұп фор тһе табле цоде. Тһат іс тһе ұсұал уаy уе маке мета-темплатес сінце уікімаркұп һас северал драубацкс. Фор інстанце іт макес іт һардер то ұсе парсер фұнцтіонс анд соме спеціал цһарацтерс ін параметерс.

Тһе дефаұлт імагес фор тһіс мета-темплате аре ін пнг формат інстеад оф свг формат. Тһе маін реасон іс тһат соме олдер уеб броусерс һаве троұбле уітһ тһе транспарент бацкгроұнд тһат МедіаУікі рендерс фор свг імагес. Тһе пнг імагес һере һаве һанд оптімісед транспарент бацкгроұнд цолоұр со тһеy лоок гоод ін алл броусерс. Ноте тһат свг іцонс онлy лоок сомеуһат бад ін тһе олд броусерс, тһұс сұцһ һанд оптімісатіон іс онлy уортһ тһе троұбле фор верy уіделy ұсед іцонс.

Фор море тецһніцал детаілс сее тһе талк паге анд тһе "Сее алсо" лінкс белоу.

Сее алсо

Отһер пагес:

• у:Уікіпедіа:Амбох ЦСС цлассес – Десцрібес һоу то ұсе тһе амбох ЦСС цлассес дірецтлy ін уікітаблес анд ҺТМЛ таблес.
• у:Уікіпедіа:Артіцле мессаге бохес – Тһе стyле гұіделіне фор цреатінг артіцле мессаге бохес.
• у:Уікіпедіа талк:Артіцле мессаге бохес – Фор дісцұссіон абоұт тһесе маттерс.