Dzmuh в 16:57, 3 июня 2021

2021-06-03T16:57:14Z

← Предыдущая версия		Версия от 16:57, 3 июня 2021
Строка 1:		Строка 1:
	{{docpage}}		{{docpage}}
	<~~!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE --~~>		<includeonly>
			{{Шаблон из википедии\|Tmbox}}
			</includeonly>
	{{Mbox templates\|nocat=1}}		{{Mbox templates\|nocat=1}}
	Этот мета-шаблон ('''t'''alk page '''m'''essage '''box''') используется для формирования информационных сообщений на страницах обсуждения. Этот шаблон вызывается другими шаблонами и определяет общую структуру и внешний вид сообщений, используемых на страницах обсуждения проекта. Его можно использовать непосредственно на странице обсуждения, чтобы показать однократное сообщение в том же формате, что и другие шаблонные сообщения, но это скорее исключение (если сообщение является достаточно важным, чтобы отображаться в таком виде, лучше подумать о создании отдельного шаблона, чтобы он был легко доступен для других редакторов).		Этот мета-шаблон ('''t'''alk page '''m'''essage '''box''') используется для формирования информационных сообщений на страницах обсуждения. Этот шаблон вызывается другими шаблонами и определяет общую структуру и внешний вид сообщений, используемых на страницах обсуждения проекта. Его можно использовать непосредственно на странице обсуждения, чтобы показать однократное сообщение в том же формате, что и другие шаблонные сообщения, но это скорее исключение (если сообщение является достаточно важным, чтобы отображаться в таком виде, лучше подумать о создании отдельного шаблона, чтобы он был легко доступен для других редакторов).

Dzmuh: Новая страница: «{{docpage}} {{Mbox templates|nocat=1}} Этот мета-шаблон ('''t'''alk page '''m'''essage '''...»

2021-04-25T20:16:32Z

Новая страница: «{{docpage}}  {{Mbox templates|nocat=1}} Этот мета-шаблон ('''t'''alk page '''m'''essage '''...»

Новая страница

{{docpage}}

{{Mbox templates|nocat=1}}
Этот мета-шаблон ('''t'''alk page '''m'''essage '''box''') используется для формирования информационных сообщений на страницах обсуждения. Этот шаблон вызывается другими шаблонами и определяет общую структуру и внешний вид сообщений, используемых на страницах обсуждения проекта. Его можно использовать непосредственно на странице обсуждения, чтобы показать однократное сообщение в том же формате, что и другие шаблонные сообщения, но это скорее исключение (если сообщение является достаточно важным, чтобы отображаться в таком виде, лучше подумать о создании отдельного шаблона, чтобы он был легко доступен для других редакторов).

Этот шаблон подобен шаблону {{шаблон|ambox}} и использует большинство его параметров.

=== Использование ===
Простое использование:
<pre>
{{tmbox | text = Обычный текст. }}
</pre>

{{tmbox | text = Обычный текст. }}

Сложное использование:

<pre>
{{tmbox
| 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.
}}
</pre>

{{tmbox
| 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''', но не меняют параметры отображения значка (иконки), поэтому везде отображается картинка по умолчанию.

{{tmbox
| type = speedy
| text = type=speedy — в шаблонах быстрого удаления категории.
}}
{{tmbox
| type = delete
| text = type=delete — в шаблонах удаления категории.
}}
{{tmbox
| type = content
| text = type=content — важные предупреждения и предостережения.
}}
{{tmbox
| type = style
| text = type=style — обычные предупреждения и предостережения.
}}
{{tmbox
| type = notice
| text = type=notice — информационные сообщения, постоянные и временные.
}}
{{tmbox
| type = move
| text = type=move — сообщения о перемещении, слиянии и разделении.
}}
{{tmbox
| type = protection
| text = type=protection — сообщения о защите страницы.
}}

=== Дополнительно ===
Примеры использования других параметров и их комбинаций.

{{tmbox
| text = Не заданы параметры type и image (по умолчанию)
}}
{{tmbox
| image = none
| text = Не заданы параметр type и '''image=none''' – Значок не показывается и текст занимает всю ширину окна сообщения.
}}
{{tmbox
| image = [[Файл:Gnome globe current event.svg|42px]]
| imageright = [[Файл:Nuvola apps bookcase.svg|40px]]
| text = image = <nowiki>[[Файл:Gnome globe current event.svg|42px]]</nowiki> imageright = <nowiki>[[Файл:Nuvola apps bookcase.svg|40px]]</nowiki>
}}

=== Параметры ===
Список всех параметров:

<pre>
{{tmbox
| type = speedy / delete / content / style / notice / move / protection
| image = none / [[Файл:Картинка.svg|40px]]
| imageright = [[Файл:Картинка.svg|40px]]
| style = Дополнительные параметры оформления.
| textstyle = Дополнительные параметры оформления сообщения.
| text = Заголовок сообщения.
| text-small = Текст меньшего шрифта под заголовком.
| small = {{{small|}}} / yes
| smallimage = none / [[Файл:Картинка.svg|30px]]
| smallimageright = none / [[Файл:Картинка.svg|30px]]
| smalltext = A shorter message body text.
}}
</pre>

'''type'''
: '''нет параметра''' = если параметр '''type''' не задан, то используется значение по умолчанию '''notice''' (голубой фон).

'''image'''
: '''нет параметра''' = если параметр '''image''' не задан, то используется значок по умолчанию в зависимости от значения параметра '''type'''.
: '''файл изображения''' = ссылка на файл, использующая вики разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
:: <code><nowiki>image = [[Файл:Sub-arrows.svg|40px]]</nowiki></code>
: '''none''' = обозначает, что не нужно отображать значок.

'''imageright'''
: '''нет параметра''' = если параметр '''imageright''' не задан, то значок справа не показывается.
: '''файл изображения''' = ссылка на файл, использующая вики разметку. Размер подгоняется под 40px — 50px в ширину в зависимости от соотношения сторон в оригинале. (Но можно задать и произвольный размер.) Например:
:: <code><nowiki>imageright = [[Файл: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'''
: Текст сообщения, можно использовать как заголовок сообщения при заданном параметре <code>text-small</code>

'''text-small'''
: Текст сообщения.

==== Параметры миниатюризации ====

{{tmbox
| small = yes
| text = small = yes
}}
{{tmbox
| type = style
| small = yes
| text = type = style small = yes
}}
'''small'''
: '''yes''' = Создаёт маленькое окно сообщения, прикрепляющееся к правому краю страницы. Этот параметр также уменьшает значок по умолчанию. Обратите внимание, что данные, переданные в параметрах '''smallimage''', '''smallimageright''' и '''smalltext''', используются, только если «small=yes». Чтобы производный шаблон понимал параметр small, используйте следующий код:
:: <code><nowiki>small = {{{small|}}}</nowiki></code>

{{tmbox
| small = yes
| image = [[Файл:Nuvola apps bookcase.png|40px]]
| smallimage = [[Файл:Nuvola apps bookcase.png|30px]]
| text =
small = yes image = <nowiki>[[Файл:Nuvola apps bookcase.png|40px]]</nowiki> smallimage = <nowiki>[[Файл:Nuvola apps bookcase.png|30px]]</nowiki>
}}
'''smallimage'''
: '''нет параметра''' = если параметр '''smallimage''' не задан, то опять используется параметр '''image'''. Если параметр '''image''' также пустой, то используется маленький значок по умолчанию.
: '''файл изображения''' = ссылка на файл использующая вики разметку. Обычно около 20px для сообщений в одну строку и до 25px в ширину для двух строк текста. Например:
:: <code><nowiki>smallimage = [[Файл:Gnome globe current event.svg|20px|alt=Clock over a larger globe]]</nowiki></code>
: '''none''' = обозначает, что не нужно отображать значок. Переопределяет заданное в параметре '''image''', когда «small=left».

{{tmbox
| small = yes
| imageright = [[Файл:Nuvola apps bookcase.png|40px]]
| text =
small = yes imageright = <nowiki>[[Файл:Nuvola apps bookcase.png|40px]]</nowiki>
}}
{{tmbox
| small = yes
| imageright = [[Файл:Nuvola apps bookcase.png|30px]]
| smallimageright = none
| text =
small = yes imageright = <nowiki>[[Файл:Nuvola apps bookcase.png|40px]]</nowiki> smallimageright = none
}}
'''smallimageright'''
: '''нет параметра''' = если параметр '''smallimageright''' не задан, то опять используется параметр '''imageright'''. Если параметр '''imageright''' также пустой, то используется значок справа не показывается.
: '''файл изображения''' = ссылка на файл, использующая вики разметку. Около 30px в ширину. Например:
:: <code><nowiki>smallimageright = [[Файл:Nuvola apps bookcase.png|30px|alt=Three stacked books]]</nowiki></code>
: '''одругое''' = всё, что вы хотите отобразить справа.
: '''none''' = обозначает, что не нужно отображать значок справа. Переопределяет заданное в параметре '''imageright''', когда «small=yes».

'''smalltext'''
: Краткий вариант текста сообщения. Если параметр '''smalltext''' не задан, то используется параметр '''text'''.

=== Технические детали ===
Если вам необходимо использовать специальные символы внутри параметра '''text''', то вам необходимо заменять их ESC-последовательностями:

<pre>
{{tmbox
| text = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
</pre>

{{tmbox
| text = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>.
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}

Этот шаблон использует <code>tmbox</code> [[CSS]]-классы в [[MediaWiki:Common.css]] влияющие на его внешний вид, то есть он полностью перенастраиваемый.

Шаблон вызывает {{шаблон|tmbox/core}}, который содержит весь исполняемый код для {{шаблон|tmbox}}, тогда как сам {{шаблон|tmbox}} занимается предварительной обработкой параметров, тем самым упрощая {{шаблон|tmbox/core}}.

Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование [[m:Help:ParserFunctions|функций парсера]] и специальных символов в параметрах.

<includeonly>

[[Категория:Шаблоны:Для шаблонов]]
</includeonly>

Шаблон:Tmbox/doc - История изменений

Dzmuh в 16:57, 3 июня 2021

Dzmuh: Новая страница: «{{docpage}} {{Mbox templates|nocat=1}} Этот мета-шаблон ('''t'''alk page '''m'''essage '''...»