Шаблон:Tmbox

{{i}} Документація шаблону[перегляд] [редагувати] [історія] [очистити кеш]



Меташаблони
контейнерів повідомлень
шаблонконтекст
{{Ambox}}стаття
{{Cmbox}}категорія
{{Imbox}}зображення
{{Tmbox}}обговорення
{{Fmbox}}верхній/нижній
колонтитул
{{Ombox}}інші сторінки
{{Mbox}}автовизначення
{{Asbox}}стаб статті
{{Dmbox}}неоднозначність

Це меташаблон {{Tmbox}} (англ. [T]alk page [m]essage [box]). Цей шаблон викликається іншими шаблонами, щоб отримати послідовну структуру і зовнішній вигляд шаблонних повідомлень, які використовуються на сторінках обговорення у проєкті. Він може викликатись безпосередньо на сторінці обговорення з метою створення одноразового повідомлення у форматі стандартних, але це виняток (якщо повідомлення є досить важливим, щоб бути представленим в такому вигляді, ви повинні розглянути питання про створення окремого шаблону, таким чином, щоб воно було легко доступне для інших редакторів). Tmbox пропонує декілька різних кольорів для різних завдань, забезпечує стандартні зображення, у випадках коли не було задано іншого параметром, та має інші зручні функції. Цей шаблон працює подібно до {{Ambox}} та використовує такі ж параметри.

Цей шаблон не слід використовувати для банерів Вікіпроєктів. Такі банери мають спеціальні обмеження програмування, які заслуговують свої власні мета-шаблони. Дивіться розділ "Див. також" задля посилань.

Рекомендовані стандарти стилів

Типи контейнерів повідомлень для сторінок обговорення слідують такій же політиці, як і для всіх інших просторів назв, але тип конкретного контейнера повідомлення для якоїсь конкретної сторінки обговорення може бути не настільки очевидним, як у інших просторах назв. Коли ви вирішуєте який тип використовувати для конкретного контейнеру, будь ласка, слідуйте наступним настановам:

  • speedy повинен використовуватись тільки для шаблонів швидкого вилучення.
  • delete повинен використовуватись тільки для шаблонів пов'язаних із поточними обговореннями видалення. Будь ласка, не використовуйте цей тип, тільки для того, щоб отримати червону рамку для повідомлення.
  • content та style повинні використовуватись для попереджень та оповіщень. використовуйте content (який має жовтогарячу рамку) для біль важливих і невідкладних попереджень, та style (жовта рамка) для менш важливих попереджень. Контейнери повідомлень цих типів, в ідеалі, мають бути тимчасовими: вони не повинні залишатися на сторінках обговорень постійно.
  • move та protection повинні використовуватись тільки для контейнерів повідомлень, пов'язаних із переміщенням, об'єднанням та захистом сторінок відповідно.
  • Тип notice повинен використовуватись для більшості контейнерів повідомлень для сторінок обговорення; ті, які призначені для передачі інформації або підбиття підсумку. Якщо контейнер повідомлення для сторінок обговорення не є очевидним випадком інших типів, то це скоріше за все контейнер типу notice.

Використання

Прості приклади використання:

{{tmbox | text = Деякий текст.}}

Складний приклад:

{{tmbox
| type      = style
| image     = [[Файл:Emblem-question-yellow.svg|40пкс]]
| style     = width: 400пкс; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = Текст тіла повідомлення.
}}

Типи контейнерів повідомлень сторінок обговорення

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

Спеціальні

Деякі інші комбінації параметрів.

Параметри

Перелік усіх параметрів:

{{tmbox
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[Файл:Some image.svg|40пкс]]
| imageright = [[Файл:Some image.svg|40пкс]]
| style = CSS значення
| textstyle = CSS значення
| text  = Тіло тексту повідомлення. 
| small = {{{small|}}} / yes
| smallimage = none / [[Файл:Some image.svg|30пкс]]
| smallimageright = none / [[Файл:Some image.svg|30пкс]]
| smalltext  = Коротше тіло тексту повідомлення.
}}

type

Якщо параметр type не задано, шаблон приймає тип notice. Це означає, що він матиме сіру рамку.

image

No parameter = Якщо параметр image не задано, шаблон використовує стандартне зображення. Яке стандартне зображення буде використано, залежить від параметру type.
An image = Повинно бути зображенням із звичайним описом вікі. Ширина у 40пкс - 50пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру). Наприклад:
image = [[Файл:Crystal package settings.png|40пкс]]
none = Означає, що зображення не використовується.

imageright

No parameter = Якщо параметр imageright не задано, зображення з правого боку не буде.
An image = Повинно бути зображенням із звичайним описом вікі. Ширина у 40пкс - 50пкс зазвичай підходить, але залежить від співвідношення сторін зображення (але контейнер повідомлення може приймати зображення будь-якого розміру). Наприклад:
imageright = [[Файл:Nuvola apps bookcase.png|40пкс]]
Anything = Будь-який інший об'єкт, який ви бажаєте розмістити з правої сторони.

style

Необов'язкове значення CSS , що використовується для усієї таблиці контейнера повідомлення. Без лапок " " але з закінченням крапкокомою ;. Наприклад:
style = margin-bottom: 0.5em;

textstyle

Необов'язкове значення CSS , що використовується для комірки тексту. Наприклад:
textstyle = text-align: center;

text

Тіло тексту повідомлення.

Параметри small

small

yes = Утворює маленький контейнер повідомлення з правої сторони. Це також робить стандартне зображення меньшим. Зауважте, що будь-які дані розміщені у параметрах smallimage, smallimageright та smalltext використовуються тільки у випадку "small=yes". Для того, щоб ваш шаблон також приймав маленькі параметри, ви можете додати наступний код:
small = {{{small|}}}

smallimage

No parameter = Якщо параметр smallimage не задано, тоді цей шаблон повертається до використання параметру image. Якщо параметр image також виявляється порожнім, тоді використовується маленьке стандартне зображення.
An image = Повинен містити зображення зі стандартним описом вікі. Ширини у 30пкс зазвичай вистачає. Наприклад:
smallimage = [[Файл:Crystal package settings.png|30пкс]]
none = Означає, що зображення не використовується. Це перезаписує будь-яке зображення визначене у image, коли "small=yes".

smallimageright

No parameter = Якщо параметр smallimageright не визначено, тоді шаблон повертається до використання параметру imageright. Якщо параметр imageright також відсутній, то зображення з правої сторони буде відсутнім.
An image = Повинен містити зображення у звичайні формі опису вікі. Ширини у 30пкс зазвичай вистачає. Наприклад:
smallimageright = [[Файл:Nuvola apps bookcase.png|30пкс]]
Anything = Будь-який інший об'єкт, який ви хочете, щоб з'являвся з правої сторони.
none = Означає, що зображення з правої сторони не використовується. Це перезаписує будь-яке зображення визначене у imageright, коли "small=yes".

smalltext

Коротша версія тіла тексту контейнера. Якщо параметр smalltext не задано, тоді цей шаблон повертається до використання параметру text.

Технічні подробиці

Якщо вам необхідно використовувати спеціальні символи у тексті параметрів, вам необхідно робити це таким чином:

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

Цей шаблон використовує класи tmbox CSS у MediaWiki:Common.css для більшості свого оформлення, таким чином, він повністю підтримує скіни.

Внутрішньо цей меташаблон використовує для табличного коду розмітку HTML замість вікірозмітки. Це звичайний спосіб для створення меташаблонів, оскільки вікіпрозмітка має декілька недоліків. Наприклад, вона ускладнює використання парсерних функцій та спеціальних символів у параметрах.

Стандартні зображення цього меташаблону мають формат png замість svg. Основною причиною є те, що деякі старіші браузери мають проблеми із прозорим фоном, що утворює MediaWiki для svg зображень. Зображення png у цьому випадку мають гарну оптимізацію кольору прозорого фону, і таким чином вони добре виглядають у всіх браузерах. Зауважте, що svg іконки програють у рендері тільки у старих браузерах, таким чином, така ручна оптимізація потрібна тільки для іконок найширшого використання.

Задля більшої кількості технічних подробиць дивіться сторінку обговорення. Оскільки шаблон працює майже так само як й інші mboxes, їх сторінки обговорення також можуть містити корисну інформацію, дивіться розділ "Див. також" нижче.

Див. також

Подібні шаблони:

До сімейства меташаблонів Модуль:Message box входить сім шаблонів:

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

Тісно пов'язані меташаблони:

  • {{Asbox}}, для контейнерів повідомлень на сторінках стабів статей.
  • {{Dmbox}}, для контейнерів повідомлень на сторінках неоднозначностей або визначеного індексу.
  • {{Ivmbox}}, простий контейнер, повної ширини, із заданим фоном кольору слонової кістки, призначений для оформлення важливих повідомлень або нагадувань.

Інші сторінки:

Банери Вікіпроєктів:

  • {{WikiProjectBannerShell}} та {{WPBannerMeta}} – Система для згортання, упаковки та створення банерів Вікіпроєктів.
  • {{WikiProjectBanners}} – Ще одна система для згортання банерів Вікіпроєктів.