Шаблон:Ombox/Документация: различия между версиями

интервики перенесены в Викиданные; актуализация, викификация, оформление
(Раздел "Технические детали": поправка неточности.)
(интервики перенесены в Викиданные; актуализация, викификация, оформление)
<noinclude>{{docpage}}</noinclude>
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
{{Mbox templates|nocat=1}}
Этот мета-шаблон (other'''o'''ther pages message'''m'''essage '''box''') используется для формирования информационных сообщений в пространствах "«Участник"», "«Википедия"», "«MediaWiki"», "«Шаблон"», "«Справка"», и других, которые не покрываются шаблонами {{шаблон|ambox}}, {{шаблон|tmbox}}, {{шаблон|imbox}} или {{шаблон|cmbox}}. Поэтому он '''не должен''' использоваться на страницах словарных статей, страницах обсуждения, страницах изображений и страницах категорий.
 
Этот шаблон подобен шаблону {{шаблон|ambox}} и использует большинство его параметров.
 
=== Использование ===
 
<pre>
{{ombox | text = SomeОбычный textтекст. }}
</pre>
 
{{ombox | text = SomeОбычный textтекст. }}
{{clear}}
 
{{ombox
| type = style
| image = [[ImageФайл:Emblem-question-yellow.svg|40px]]
| style = width: 400px;
| textstyle = color: red; font-weight: bold; font-style: italic;
{{ombox
| type = style
| image = [[ImageФайл:Emblem-question-yellow.svg|40px]]
| style = width: 400px;
| textstyle = color: red; font-weight: bold; font-style: italic;
{{ombox
| type = content
| text = type=<u>content</u> – Важныеважные предупреждения о предостережения.
}}
{{ombox
| type = style
| text = type=<u>style</u> – Обычныеобычные предупреждения о предостережения.
}}
{{ombox
{{ombox
| type = move
| text = type=<u>move</u> – Сообщениясообщения о перемещении, слиянии и разделении.
}}
{{ombox
| type = protection
| text = type=<u>protection</u> – Сообщениясообщения о защите страницы.
}}
 
 
=== Примеры использования ===
Примеры использования в сообщениях типа "«notice"».
 
{{ombox
}}
{{ombox
| image = [[ImageФайл:Gnome globe current event.svg|42px]]
| imageright = [[ImageФайл:Nuvola apps bookcase.svg|40px]]
| text = image = <nowiki>[[ImageФайл:Gnome globe current event.svg|42px]]</nowiki> <br> imageright = <nowiki>[[ImageФайл:Nuvola apps bookcase.svg|40px]]</nowiki>
}}
{{ombox
| type = notice
| image = [[ImageФайл:Yes_check.svg|30px]]
| imageright =
| text = '''Эта страница является частью [[:Категория:Википедия:Правила и руководства|правил и руководств]] русской Википедии.'''<br>
{{ombox
| type = notice
| image = [[ImageФайл:Nutshell.png|30px]]
| text =
'''В двух словах:''' Этот шаблон используется для отображения информационного сообщения на странице '''не являющихся''' словарной статьёй, страницей обсуждения, страницей описания изображения и странице категории.
{{ombox
| 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 = The message body text.
| small = {{{small|}}} / yes
| smallimage = none / [[ImageФайл:Some image.svg|30px]]
| smallimageright = none / [[ImageФайл:Some image.svg|30px]]
| smalltext = A shorter message body text.
}}
 
'''type'''
: '''нет параметра''' = если параметр '''type''' не задан, то используется значение по умолчанию '''notice''' (голубой фон).
 
'''image'''
: '''нет параметра''' = если параметр '''image''' не задан, то используется значок по умолчанию в зависимости от того что задано в параметре '''type'''.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Размер подгоняется под 40px - — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
:: <code><nowiki>image = [[ImageФайл:Sub-arrows.svg|40px]]</nowiki></code>
: '''none''' = обозначает, что не нужно отображать значок.
 
'''imageright'''
: '''нет параметра''' = если параметр '''imageright''' не задан, то значок справа не показывается.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Размер подгоняется под 40px - — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
:: <code><nowiki>imageright = [[ImageФайл:Nuvola apps bookcase.png|40px]]</nowiki></code>
: '''одругое''' = все что вы хотите отобразить справа.
 
'''style'''
: Дополнительный параметр стиля CSS для всей таблицы. Например:
:: <code>style = margin-bottom: 0.5em;</code>
 
'''textstyle'''
: Дополнительный параметр стиля CSS для текстовой ячейки. Например:
:: <code>textstyle = text-align: center;</code>
 
'''text'''
: Текст сообщения.
 
==== Параметры миниатюризации ====
}}
'''small'''
: '''yes''' = Создает маленькое окно сообщения прикрепляющееся к правому краю страницы. Этот параметр также уменьшает значок по умолчанию. Обратите внимание, что данные переданные в параметрах '''smallimage''', '''smallimageright''' и '''smalltext''' используются только если "«small=yes"». Чтобы производный шаблон понимал параметр small используйте следующий код:
:: <code><nowiki>small = {{{small|}}}</nowiki></code>
 
{{ombox
| small = yes
| image = [[ImageФайл:Replacement filing cabinet.svg|50px]]
| smallimage = [[ImageФайл:Replacement filing cabinet.svg|32px]]
| text =
small = yes <br> image = <nowiki>[[ImageФайл:Replacement filing cabinet.svg|50px]]</nowiki> <br> smallimage = <nowiki>[[ImageФайл:Replacement filing cabinet.svg|32px]]</nowiki>
}}
'''smallimage'''
: '''нет параметра''' = если параметр '''smallimage''' не задан, то опять используется параметр '''image'''. Если параметр '''image''' также пустой, то используется маленький значок по умолчанию.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Обычно около 20px для сообщений в одну строку и до 25px в ширину для двух строк текста. Например:
:: <code><nowiki>smallimage = [[FileФайл:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]</nowiki></code>
: '''none''' = обозначает, что не нужно отображать значок. Переопределяет заданное в параметре '''image''', когда "«small=left"».
 
{{ombox
| small = yes
| imageright = [[ImageФайл:Nuvola apps bookcase.png|50px]]
| smallimageright = none
| text =
small = yes <br> imageright = <nowiki>[[ImageФайл:Nuvola apps bookcase.png|50px]]</nowiki> <br> smallimageright = none
}}
'''smallimageright'''
: '''нет параметра''' = если параметр '''smallimageright''' не задан, то о пять используется параметр '''imageright'''. Если параметр '''imageright''' также пустой, то используется значок справа не показывается.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Около 30px в ширину. Например:
:: <code><nowiki>smallimageright = [[FileФайл:Nuvola apps bookcase.png|30px|alt=Three stacked books]]</nowiki></code>
: '''одругое''' = все что вы хотите отобразить справа.
: '''none''' = обозначает, что не нужно отображать значок справа. Переопределяет заданное в параметре '''imageright''', когда "«small=yes"».
 
'''smalltext'''
: Краткий вариант текста сообщения. Если параметр '''smalltext''' не задан, то пять используется параметр '''text'''.
 
=== Технические детали ===
Если вам необходимо использовать специальные символы внутри параметра '''text''', то вам необходимо заменять их ESC-последовательностями :
 
<pre>
 
 
Этот шаблон использует <code>ombox</code> [[w:CSS|CSS]] -классы в [[MediaWiki:Common.css]] влияющие на его внешний вид, т.е.то есть он полностью перенастраиваемый.
 
Шаблон вызывает {{шаблон|ombox/core}} содержит весь исполняемый код для {{шаблон|ombox}}, когда как сам {{шаблон|ombox}} занимается предварительной обработкой параметров, тем самым упрощая {{шаблон|ombox/core}}.
 
Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, т.к.так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование [[mВП:Help:ParserFunctionsПАРС|функций парсера]] и специальных символов в параметрах.
 
Файлы значков по умолчанию для этого мета-шаблона имеют формат png, а не svg. Основная причина в том, что у некоторых старых браузеров есть проблемы с отображением прозрачного фона, который подставляет MediaWiki движок для svg изображений. Все png изображение оптимизированы вручную и имеют прозрачный фон чтобы одинаково хорошо отображаться во всех браузерах. Обратите внимание, что svg значки выглядят плохо только в старых браузерах, поэтому такая ​​ручная оптимизация сделана только для наиболее часто использующихся иконок.
 
<!--
=== См. также ===
{{Mbox templates see also}}
-->
 
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Категория:Шаблоны:Для шаблонов|{{PAGENAME}}]]
 
[[dsb:Pśedłoga:Ombox]]
[[dv:ފަންވަތް:Ombox]]
[[el:Πρότυπο:Πλαίσιο μηνύματος]]
[[en:Template:Ombox]]
[[ar:قالب:صندوق رسالة أخرى]]
[[ba:Ҡалып:Ombox]]
[[bjn:Citakan:Ombox]]
[[ca:Plantilla:Metacaixa d'avís projecte]]
[[chr:Template:Ombox]]
[[cy:Nodyn:Ombox]]
[[fa:الگو:Ombox]]
[[gd:Teamplaid:Ombox]]
[[gu:ઢાંચો:Ombox]]
[[ha:Template:Ombox]]
[[hi:साँचा:Ombox]]
[[hsb:Předłoha:Ombox]]
[[hy:Կաղապար:Ombox]]
[[ia:Patrono:Ombox]]
[[ja:Template:Ombox]]
[[jv:Cithakan:Ombox]]
[[km:ទំព័រគំរូ:Ombox]]
[[ko:틀:Ombox]]
[[lad:Xablón:Ombox]]
[[lt:Šablonas:Ombox]]
[[map-bms:Cithakan:Ombox]]
[[mhr:Кышкар:Ombox]]
[[min:Templat:Ombox]]
[[mk:Шаблон:Ombox]]
[[mn:Загвар:Ombox]]
[[mr:साचा:Ombox]]
[[ms:Templat:Ombox]]
[[mt:Mudell:Ombox]]
[[mwl:Modelo:Ombox]]
[[ne:ढाँचा:Ombox]]
[[or:ଛାଞ୍ଚ:Ombox]]
[[pam:Template:Ombox]]
[[pl:Szablon:Ombox]]
[[pt:Predefinição:Ombox]]
[[rm:Model:Ombox]]
[[ro:Format:Meta-casetămap]]
[[si:සැකිල්ල:Ombox]]
[[sl:Predloga:Polje za ostale strani]]
[[su:Citakan:Ombox]]
[[tpi:Template:Ombox]]
[[tr:Şablon:Ombox]]
[[uk:Шаблон:Ombox]]
[[ur:سانچہ:Ombox]]
[[yo:Àdàkọ:Ombox]]
[[zh:Template:Ombox]]
</includeonly>
142

правки