Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

To jest tmbox (talk page message box) – szablon szablonów. Jest on używany do tworzenia szablonów informacyjnych wstawianych na stronie dyskusji.

Użycie

Najprostsze wywołanie szablonu:

{{Tmbox|tekst = Jakiś tekst, który ma na celu zademonstrowanie działania szablonu.}}

Wyświetla on taki komunikat:

Bardziej złożone wywołanie:

{{Tmbox
 | typ     = zawartość
 | grafika = tu zaleca się podać szablon ikona w wielkości 35px, np. 
 | tekst   = Tekst wiadomości
 }}

Powoduje ono wyświetlenie następującego komunikatu:

Style szablonu

Szablon ma wiele przygotowanych styli główncych, które są przełączane za pomocą parametru typ. Jeśli ten parametr nie został użyty lub została podana inna wartość niż jedna z poniższych, wykorzystywany jest typ „wiadomość”.

Jeśli w wywołaniu szablonu nie zadeklarowano parametru typ, domyślnym ustawieniem jest | typ = wiadomość.

Grafiki

Grafiki w szablonie można dostosować za pomocą parametru grafika. Przykłady:

Jeśli ten parametr nie jestr określony, używana jest domyślna grafika związana z parametrem | typ = (zobacz domyślne obrazki w sekcji typ powyżej).

Jeśli jako parametr podano | grafika = nie, w szablonie nie jest używana grafika, a tekst jest wyrównany do lewej bez pozostawienia pustego miejsca. Jeśli natomiast jako parametr podano | grafika = brak, szablon nie używa żadnej grafiki, ale zostawia puste pole szerokości domyślnego obrazka, co pozwala na wyrównywanie tekstu w kilku szablonach.

Opis parametrów

Lista wszystkich parametrów:

{{Tmbox
 | typ             =
 | grafika         = 
 | grafika prawo   =
 | styl tekstu     = 
 | [tekst|treść|1] = 
 | poniżej         =
 | id              = 
 | klasa           = 
 | styl            =
}}

Przykładowe użycie z opisem parametrów:

{{Tmbox
 | typ             = poważny  / szybko / usuń / styl /zawartość / rozszerz / przeniesienie /  ochrona / integruj / powiadomienie / wiadomość.
 | grafika         = none / nie / brak / {{Plik|plik=Some imagine.svg|rozmiar=40px}}.
 | grafika         = none / nie / brak / {{Plik|plik=Some imagine.svg|rozmiar=40px}}.
 | grafika prawo   = inna grafika: {{Plik|plik=Some imagine.svg|rozmiar=40px}}, lub całkiem inny obiekt.
 | styl tekstu     = Wartośść CSS tekstu zawartości szablonu komunikatów.
 | [tekst|treść|1] = Główna treść wiadomości komunikatu.
 | poniżej         = Więcej elementów, szablonu komunikatów, wiadomości, inne {{Tmbox}} lub inny szablon tego typu.
 | id              = Unikalny identyfikator HTML tabelki komunikatu.
 | klasa           = klasy reguł CSS tabelki komunikatu.
 | styl            = Wartości CSS kaskadowych arkuszy stylów tabelki komunikatów.
}}

Uwaga: Jedynym wymaganym parametrem jest | tekst = lub | treść = bądź | 1 = .

Parametry Tmbox
typ
(opcjonalny)
Typ powiadomienia. Jeśli nie podano parametru typ, przyznawany jest typ = wiadomość.
grafika
(opcjonalny)
Ikona komunikatu.
Brak parametru = Używana jest domyślna grafika związana z parametrem typ.
Jakaś grafika = Użyta szerokość powinna mieścić się w granicach 40-50px. Na przykład:
{{Plik|plik=Unbalanced scales.svg|rozmiar=40px}}
nie = Nie używa grafiki, jej puste miejsce jest zapełniane przez tekst wraz z miejscem na grafikę.
brak = Zostawia puste miesce, gdzie powinna być grafika, nieużywana przez tekst.
grafika prawo
(opcjonalny)
Ikona komunikatu.
Brak parametru = Nie wyświetla grafiki po prawej
Jakaś grafika = Jak wyżej. Na przykład:
{{Plik|plik=Nuvola apps bookcase.png|rozmiar=40px}}
Cokolwiek = Dowolny obiekt, który chcesz po prawej stronie.
styl tekstu
(opcjonalny)
Styl CSS dla tekstu ramki.
nazwa zmiennej: tekst albo treść bodź 1
(wymagany)
Treść komunikatu ramki.
poniżej
(opcjonalny)
Wywołanie szablonu {{Mbox}} lub jego kolegów innych ramek komunikatów.
id
(opcjonalny)
Identyfikator komunikatu ramki z komunikatem.
klasa
(opcjonalny)
Nazwa klasy CSS dla ramki z komunikatem.
styl
(opcjonalny)
Styl CSS dla ramki z komunikatem.

Techniczne szczegóły

Jeśli musisz użyć znaków specjalnych w parametrze | treść = , musisz je zabezpieczyć w następujący sposób:

{{Tmbox
 | tekst  = {{Div|Znak równości {{=}} i klamerki {{(}} {{)}} działają dobrze bez żadnych niepotrzebnych zabiegów.
Ale oto nie idzie kreska pionowa {{!}} i dwie zamykające klamerki {{))}}. 
A teraz zarówno kreska pionowa, jak i klamerki: {{!}}{{))}}.}}
}}

Klasy CSS mogą być użyte także bezpośrednio w tabelkach:

{{Tabelka|klasa=mbox mbox-content tmbox tmbox-content box-mobilne|<!--
 -->{{Wiersz|<!--
     -->{{Komórka|klasa=mbox-image tmbox-image|{{Ikona|pomuwaga|35}} }}<!--
     -->{{Komórka|Jakiś tekst}}<!--
  -->}}<!--
-->}}
Jakiś tekst

Ten szablon używa klas CSS tmbox styli lokalnych: Szablon:Tmbox/styles.css, więc jest w pełni skórkowalny.

Wewnętrznie ten meta-szablon używa znaczników wiki zamiast znaczników HTML dla kodu tabeli. To jest niezwykły sposób, w jaki tworzymy meta-szablony, ponieważ znaczniki wiki mają kilka wad. Na przykład utrudniają używanie funkcji parsera i znaków specjalnych w parametrach, więc do tego celu użyto je w postaci szablonów, gdzie ich tam użyto w takiej postaci, więc do tego celu w nich użyto instrukcje warunkowe ucinające białe znaki na ich końcach.

Domyślne obrazy dla tego meta-szablonu są w formacie png zamiast svg. Głównym powodem jest to, że niektóre starsze przeglądarki internetowe mają problemy z przezroczystym tłem, które MediaWiki renderuje dla obrazów svg. Obrazy png tutaj mają ręcznie zoptymalizowany przezroczysty kolor tła, więc wyglądają dobrze we wszystkich przeglądarkach. Należy zauważyć, że ikony svg wyglądają nieco źle tylko w starych przeglądarkach, więc taka ręczna optymalizacja jest warta zachodu tylko w przypadku bardzo powszechnie używanych ikon.

Więcej szczegółów technicznych znajdziesz na stronie dyskusji. Ponieważ ten szablon działa niemal podobnie, jak i inne szablony komunikatów: „Szablony komunikatów mbox”, jak również ich strony dyskusji i powiązane strony mogą również zawierać więcej szczegółów.

Błędy

Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.

Szablon do użycia na stronach dyskusji w przestrzeniach dyskusji w poszczególnych przestrzeniach przedmiotowych.

Parametry szablonu[Zarządzaj danymi szablonu]

Dla tego szablonu preferowane jest formatowanie parametrów w bloku.

ParametrOpisTypStatus
typtyp

Tyo danego komunikatu oznaczony domyślnym rysunkiem i stylami.

Ciąg znakówsugerowany
styl tekstustyl tekstu

Styl tekstu, w zmiennej 1, tekst albo treść, kaskadowych arkuszy stylów CSS.

Ciąg znakówopcjonalny
teksttekst 1 treść

Tekst komunikatu

Treśćwymagany
grafikagrafika

Lewa grafika

Przykład
{{ikona|pov|35}}
Niezbalansowany wikitekstsugerowany
grafika prawografika prawo

Grafika po prawej stronie komunikatu.

Niezbalansowany wikitekstopcjonalny
idid

Unikalny identyfikator tabelki komunikatów.

Ciąg znakówopcjonalny
klasaklasa

Klasa kaskadowych arkuszy stylów CSS tabelki komunikatów.

Ciąg znakówopcjonalny
stylstyl

Style tabelki komunikatu kaskadowych arkuszy stylów CSS tabelki komunikatów.

Ciąg znakówopcjonalny
poniżejponiżej

Inne wywołanie szablonu komunikatu w danym komunikacie.

Ciąg znakówopcjonalny

Zobacz też

Złożone szablony komunikatów:
  • {{Ambox}} - szablon do tworzenia komunikatów stosowany w artykułach w przestrzeni nazw (główna) i Wikijunior,
  • {{Tmbox}} - szablon do tworzenia pól wiadomości informacyjnych dla stron dyskusji,
  • {{Fmbox}} - szablon do tworzenia pól wiadomości komunikatów systemowych w przestrzeniach nazw: MediaWiki i Specjalna,
  • {{Imbox}} - szablon do tworzenia pól wiadomości dla stron obrazów (plików) dla przestrzeni nazw: Plik,
  • {{Cmbox}} - szablon do tworzenia pól komunikatów dla stron kategorii dla przestrzeni nazw: Kategoria,
  • {{Ombox}} - szablon do tworzenia pól wiadomości informacyjnych i ostrzegawczych - odpowiednik dla pozostałych przestrzeni nazw.
Szablony zbudowane w oparciu o złożone szablony komunikatów:
Szablony komunikatów - kombajny:
  • {{Mbox}} - szablon komunikatów kombajn wywołyjący, złożone szablony komunikatów, w zależności od ustawionej przestrzeni nazw od szablonów {{#invoke:Pudełko}} lub w jakiej przestrzeni się znalazł, szablon wykorzystywany w różnych przestrzeniach nazw, automatycznie wybiera odpowiedni szablon komunikatów dla danej przestrzeni nazw.
Szablony stron ujednoznaczniających i przekierowań na inne szczegółowe strony ze stron ogólnych:
  • {{Dmbox}} - szablon komunikatów umieszczany na tych stronach,
  • {{Ujednoznacznienie}} - szablon umieszczany na stronach ujednoznaczniających, zwyczajowo na górze strony,
  • {{Przekierowanie}} - szablon wstawiany na samej górze do stron głównych książek, do których istnieje przekierowanie, które z kolei posiada jeszcze własną stronę ujednoznaczniającą,
  • {{Inne znaczenia}} - szablon stron ujednoznaczniających kierujących do innych znaczeń danego pojęcia,
  • {{Nie mylić z}} - szablon ostrzega przed myleniem jakiegoś pojęcia z innym,
  • {{Linki niejednoznaczne}} - szablon używany, gdy nie udało się wybrać właściwego znaczenia spośród dostępnych na stronie ujednoznaczniające.
Inne szablony - kombajny:
  • {{Mbox-strona}} - szablon komunikatów taki jak: {{Mbox}}, z wiadomością, tylko, że jest to ramka pływająca umieszczona z prawej strony.
Szczególne stronicowe szablony komuniaktów:
Inne: