Šablonu:Tmbox

Документация

[kaččelemine] [korjata] [juttukorjuaminen] [tarkailla] [uvvistua]

, название сокращенно от talk page message box — меташаблон различных шаблонов-сообщений для страниц обсуждений, таких как шаблон . Он предлагает несколько различных цветов, изображений и некоторых других функций.

Похож на шаблон и использует такие же параметры.

Обратите внимание: класс tmbox работает как и класс ambox и нестандартно отображается в мобильной версии.

Параметры

type

Типы меняют внешний вид шаблона:

Комбинация параметров

Этот параметр позволяет изменить картинку шаблона:

image

Вы можете выбрать уникальное изображение для шаблона, используя параметр image. Значение параметра |image= должно иметь тот же синтаксис, как и при вставке изображения в статью (Рувики:Иллюстрирование#Вставка файла в статью). В стандарте, ширина — 40-50px. Например:

• Для указано изображение |image=[[Файл:Crystal Clear app lists.png|50px|Оставлено|link=]]:

Пожалуйста, учтите:

• Если изображение не указано, то оно будет зависеть от параметра type. (Смотрите о параметре #type выше.)
• Если указано |image=none, то никакое изображение выводиться не будет, а текст займёт всю площадь шаблона.
• Если изображение выполняет чисто декоративную функцию, а также находится в общественном достоянии, удобство и доступность использования шаблоны может быть улучшена с помощью подавления ссылки на файл с помощью добавления параметров |link= и |alt=, как показано выше.

text и text-small

Параметр text передает основной текст в шаблон. Постарайтесь сделать его как можно более кратким и понятным.

Параметр text-small показывает текст маленьким шрифт, не рекомендуем его использовать для файлов.

talk

Некоторые шаблоны-сообщения содержат ссылку на страницу обсуждения, и позволяют редактору уточнить заголовок необходимой секции для ссылки. Чтобы добиться такой функциональности, просто укажите при создании шаблона |talk={{{talk|}}}.

Примеры использования параметра редакторами:

• |talk=ЗАГОЛОВОК СЕКЦИИ — ссылка отправит читателя в необходимую секцию на странице обсуждения статьи. Пример — |talk=Foo.
• |talk=ПОЛНОЕ НАЗВАНИЕ СТРАНИЦЫ ОБСУЖДЕНИЯ — шаблон выдаст ссылку на указанную страницу обсуждения (может содержать ссылку на секцию), например |talk=Обсуждение:Banana#Foo.

Примечания:

• При использовании этого параметра при создании шаблона, то ссылка на страницу обсуждения будет появляться и в самом шаблоне (для того, чтобы продемонстрировать функциональность), но на страницах она будет отображаться, только если параметр фактически указан.
• Чтобы быть уверенным, что ссылка на страницу обсуждения постоянно показывается, вы можете использовать следующую конструкцию: |talk={{{talk|#}}}.
• Строка не будет отображаться если страницы обсуждения статьи, или указанной страницы обсуждения не существует, и неважно что вы укажете в параметре.

date

Установка параметра date сообщает мета-шаблону, что в шаблон-сообщение был установлен в этот день: устанавливается как редакторами, так и ботами. Отображается мелким шрифтов в конце дополнительного сообщения.

Обратите внимание, возможны только следующие виды дат:

• 2022-05-14 (предпочтительно)
• 1 мая 2015
• 01 мая 2015
• Стандартные англоязычные даты для обработки {{#time: }}

Также указание этого параметра включает категоризацию по времени, если параметр #cat определен.

cat

Этот параметр определяет по-месячную категорию для статей. Если |cat=КАТЕГОРИЯ тогда:

• статьи будут помещены в категорию Категория: КАТЕГОРИЯ с ДАТЫ если |date=ДАТА указан.
• статьи будут помещены в категорию Категория: КАТЕГОРИЯ если дата не указана.

Например, для шаблона указана категория |cat=Рувики:Статьи, подозреваемые в наличии оригинальных исследований, и поэтому статья с шаблоном будет помещена в категорию Kategourii:RUWIKI:Kirjutukset, kudamil vikse on originualututkimus pakkaskuus 2013.

В параметре cat не должно быть ссылок, и префикса Category: или Категория:.

all

Параметр all определяет категорию, в которую должны быть включены все статьи не зависимо от даты.

В параметре all не должно быть ссылок, и префикса Category: или Категория:.

Дополнительные параметры

Параметры

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

imageright

С помощью этого параметра можно указать изображение в правой части сообщения. Синтаксис такой же, как и для параметра |image=, за исключением того, что по умолчанию изображение отсутствует.

class

Пользовательские классы CSS для применения к сообщению. Если вы добавляете несколько классов, они должны быть разделены пробелом.

style and textstyle

Дополнительные значения CSS могут быть определены без кавычек " ", но с завершающими точками с запятой ;.

• |style= — определяет стиль, используемый всей таблицей окна сообщений. Это можно использовать для таких вещей, как изменение ширины окна.
• |textstyle= — относится к текстовой ячейке.

issue and fix

Вместо указания |text= и |text-small= можно использовать параметр |issue=.

Индивидуальный текст для малого формата может быть определен с помощью |fix=.

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

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.

plainlinks

Обычно в Рувики внешние ссылки отмечены значком стрелки рядом с ними, например: Example.com. Однако в окнах сообщений значок стрелки по умолчанию скрыт, например: Example.com. Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте |plainlinks=no.

cat2, cat3, all2, and all3

• |cat2= и |cat3= предусматривают дополнительные помесячные категории; см. #cat.
• |all2= и |all3= предусматривают дополнительные категории, в которые помещаются все статьи, как и в #all.

Отображение в мобильной версии

Разработчики MediaWiki постоянно проводят исследования читабельности шаблонов-сообщений для статей в мобильной версии Рувики. На текущий момент, на мобильную версию не влияет наш дизайн и макет, там происходит свое формирование функционала нашего шаблона. Для получения дополнительной информации см. mw:Reading/Web/Projects/Mobile Page Issues.

Технические детали

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

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

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

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

• Теги <div>, окружающие текст в приведенном выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги <div>, чтобы исправить такое поведение.

Семейство Mbox

Ei kuvausta.

Mallineen parametrit

Parametri		Kuvaus	Tyyppi	Stuatussu
тип	тип type	ei kuvausta	Tuntematon	valinnainen
image	image	ei kuvausta	Tuntematon	valinnainen
текст	текст text	ei kuvausta	Tuntematon	valinnainen
text-small	text-small	ei kuvausta	Tuntematon	valinnainen
talk	talk	ei kuvausta	Tuntematon	valinnainen
date	date	ei kuvausta	Tuntematon	valinnainen
cat	cat	ei kuvausta	Tuntematon	valinnainen
all	all	ei kuvausta	Tuntematon	valinnainen
imageright	imageright	ei kuvausta	Tuntematon	valinnainen
class	class	ei kuvausta	Tuntematon	valinnainen
style	style	ei kuvausta	Tuntematon	valinnainen
textstyle	textstyle	ei kuvausta	Tuntematon	valinnainen
issue	issue	ei kuvausta	Tuntematon	valinnainen
fix	fix	ei kuvausta	Tuntematon	valinnainen
small	small	ei kuvausta	Tuntematon	valinnainen
smallimage	smallimage	ei kuvausta	Tuntematon	valinnainen
smallimageright	smallimageright	ei kuvausta	Tuntematon	valinnainen
smalltext	smalltext	ei kuvausta	Tuntematon	valinnainen
plainlinks	plainlinks	ei kuvausta	Tuntematon	valinnainen
cat2	cat2	ei kuvausta	Tuntematon	valinnainen
cat3	cat3	ei kuvausta	Tuntematon	valinnainen
all2	all2	ei kuvausta	Tuntematon	valinnainen
all3	all3	ei kuvausta	Tuntematon	valinnainen

Во избежание поломок страниц, использующих этот шаблон, экспериментируйте в песочнице (создать | зеркало) или своём личном пространстве.
Пожалуйста, добавляйте категории на подстраницу /doc. Подстраницы этого шаблона.