Шаблон:Ombox/doc

Материал из Народные Сказки
Версия от 21:41, 30 апреля 2024; Импортёр (обсуждение | вклад) (1 версия импортирована)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Мета-шаблоны
блоков сообщений

{{Ombox}}, название сокращенно от other pages message box — меташаблон различных шаблонов-сообщений в пространствах «Участник», «Википедия», «Шаблон», «Справка», и других, которые не покрываются шаблонами {{Ambox}}, {{Tmbox}}, {{Imbox}} или {{Cmbox}}. Поэтому он не должен использоваться в статьях, страницах обсуждения, файлах и категориях.

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

Параметры

type

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


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

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

image

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

  • Для {{Правило}} указано изображение |image = [[Файл:OOjs UI icon check-constructive.svg|40px|alt=✔|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 сообщает мета-шаблону, что в шаблон-сообщение был установлен в этот день: устанавливается как редакторами, так и ботами. Отображается мелким шрифтов в конце дополнительного сообщения.

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

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

cat

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

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

Например, для шаблона {{Маргинальные теории}} указана категория |cat = РуСказки:Статьи, подозреваемые в наличии оригинальных исследований, и поэтому статья с шаблоном {{Маргинальные теории|date=12 января 2013}} будет помещена в категорию Категория:РуСказки:Статьи, подозреваемые в наличии оригинальных исследований с января 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.

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

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

{{Ombox
| text  = <div>
Здесь знак равенства = открывающая и закрывающая фигурные скобки { }.  
А здесь знак разделения параметров {{!}} и две закрывающие фигурные скобки <nowiki>}}</nowiki>. 
А здесь знак разделения параметров перед двумя закрывающими фигурными скобками <nowiki>|}}</nowiki>.
</div>
}}
  • Этот шаблон использует Ombox CSS-классы в MediaWiki:Common.css влияющие на его внешний вид, то есть он полностью перенастраиваемый.
  • Внутри шаблона для формирования кода таблицы используется язык разметки HTML вместо языка викиразметки. Так делается во всех мета-шаблонах, так как у вики-разметки есть ряд недостатков. Например, она затрудняет использование функций парсера и специальных символов в параметрах.
  • Теги <div>, окружающие текст в приведенном выше примере, обычно не нужны. Но если текст содержит разрыв строки или строк, то иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных списков. Используйте теги <div>, чтобы исправить такое поведение.

Семейство Mbox

В семействе Module:Message box есть семь меташаблонов:

  • {{Ambox}} для сообщений на страницах статей.
  • {{Cmbox}} для сообщений на страницах категорий.
  • {{Imbox}} для сообщений на страницах файлов (изображений).
  • {{Tmbox}} для сообщений на страницах обсуждения.
  • {{Fmbox}} для сообщений верхнего и нижнего интерфейса сайта.
  • {{Ombox}} для сообщений на других типах страниц.
  • {{Mbox}}, для сообщений, которые используются в разных пространствах имён и соответствующим образом изменяют их дизайн.

Тесно связанные меташаблоны:

  • {{Stub-meta}} для сообщений в заготовках статей.
  • {{Неоднозначность}}, для сообщений на страницах устранения неоднозначности.