Шаблон:Tmbox
Цей шаблон використовується на 97 000+ сторінках і його зміни будуть дуже помітними. Будь ласка, перевіряйте будь-які зміни на підсторінках /пісочниці та /тестів цього шаблону, або у вашому особистому просторі, та зважайте на обговорення змін на сторінці обговорення перед їхнім впровадженням. |
Цей шаблон використовує Lua: |
Меташаблони контейнерів повідомлень | |
---|---|
шаблон | контекст |
{{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, але не використовують параметри зображень, таким чином, вони використовують зображення за замовчуванням для кожного типу.
type=speedy – Шаблони швидкого вилучення. |
type=delete – Шаблони вилучення. |
type=content – Основні застереження та проблеми. |
type=style – Незначні попередження і проблеми. |
type=notice – Сповіщення і повідомлення будь-якого роду, як постійні так і тимчасові. |
type=move – Повідомлення та пропозиції об'єднання, розділення, перейменування та трансвікі. |
type=protection – Шаблони захисту. |
Спеціальні
Деякі інші комбінації параметрів.
Без заданого типу та зображення (стандарт) |
Без заданого типу та image=none – Не використовується зображення, а text використовує весь простір контейнеру повідомлення. |
image = [[Файл:Gnome globe current event.svg|42пкс]] imageright = [[Файл:Nuvola apps bookcase.svg|40пкс]] |
Параметри
Перелік усіх параметрів:
{{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 |
type = style small = yes |
small
- yes = Утворює маленький контейнер повідомлення з правої сторони. Це також робить стандартне зображення меньшим. Зауважте, що будь-які дані розміщені у параметрах smallimage, smallimageright та smalltext використовуються тільки у випадку "small=yes". Для того, щоб ваш шаблон також приймав маленькі параметри, ви можете додати наступний код:
small = {{{small|}}}
small = yes image = [[Файл:Nuvola apps bookcase.svg|40пкс]] smallimage = [[Файл:Nuvola apps bookcase.png|30пкс]] |
smallimage
- No parameter = Якщо параметр smallimage не задано, тоді цей шаблон повертається до використання параметру image. Якщо параметр image також виявляється порожнім, тоді використовується маленьке стандартне зображення.
- An image = Повинен містити зображення зі стандартним описом вікі. Ширини у 30пкс зазвичай вистачає. Наприклад:
smallimage = [[Файл:Crystal package settings.png|30пкс]]
- none = Означає, що зображення не використовується. Це перезаписує будь-яке зображення визначене у image, коли "small=yes".
small = yes imageright = [[Файл:Nuvola apps bookcase.svg|40пкс]] |
small = yes imageright = [[Файл:Nuvola apps bookcase.svg|40пкс]] smallimageright = none |
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> }}
Equal sign = and a start and end brace { } work fine as they are. But here is a pipe | and two end braces }}. And now a pipe and end braces |}}. |
Цей шаблон використовує класи 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}}, простий контейнер, повної ширини, із заданим фоном кольору слонової кістки, призначений для оформлення важливих повідомлень або нагадувань.
Інші сторінки:
- Вікіпедія:Шаблони сторінок обговорення[en] – Настанови, що визначають стилі для шаблонів повідомлень сторінок обговорень.
Банери Вікіпроєктів:
- {{WikiProjectBannerShell}} та {{WPBannerMeta}} – Система для згортання, упаковки та створення банерів Вікіпроєктів.
- {{WikiProjectBanners}} – Ще одна система для згортання банерів Вікіпроєктів.
Документація вище включена з Шаблон:Tmbox/документація. (ред. | історія) Дописувачі можуть експериментувати на підсторінках пісочниці (ред. | різн.) та тести (створити) цього шаблону. Будь ласка, додавайте категорії до підсторінки /документація. Підсторінки цього шаблону. |