Szablon:Mbox/opis

To jest podstrona dokumentacji dla strony Szablon:Mbox.
Zawiera ona informacje na temat użycia tej strony, jej kategoryzację i inną zawartość niebędącą częścią oryginalnej strony.

To jest mbox (skrót od message box) – uniwersalny szablon szablonów, stosowany do tworzenia komunikatów przeznaczonych dla wielu przestrzeni nazw. Upraszcza kod źródłowy komunikatów, ponieważ automatycznie dostosowuje swój wygląd w zależności od przestrzeni nazw (funkcja parsera typu {{#switch: {{NAMESPACE}}...}} nie jest konieczna). Szablon powinno się stosować w każdym komunikacie projektu, który jest stosowany w różnych przestrzeniach nazw, np. {{ek}}, {{reklama}} czy {{SdU}}.

Przestrzenie nazw

{{Ambox}} stosuje w przestrzeni głównej.

{{Tmbox}} stosuje w przestrzeniach nazw: Dyskusja, Dyskusja Wikinews, Dyskusja pomocy, Dyskusja wikireportera, Dyskusja kategorii, Dyskusja pliku, Dyskusja MediaWiki, Dyskusja szablonu, Dyskusja portalu, Dyskusja wikiprojektu, Dyskusja modułu.

{{Fmbox}} stosuje w przestrzeniach nazw MediaWiki i Specjalna.

{{Ombox}} stosuje w przestrzeniach nazw: Wikinews, Pomoc, Wikireporter, Kategoria, Plik, Szablon, Portal, Wikiprojekt.

Przestrzenie nazw Moduł i Media nie są wspierane z uwagi na ich charakterystykę.

Użycie

Proste użycie:

{{mbox | tekst = Jakiś tekst.}}

Jakiś tekst.

Złożone użycie:

{{mbox
| typ     = zawartość
| grafika = {{ikona|pomostrzeżenie|35}}
| grafika prawo = {{ikona|POV|35}}
| tekst   = '''Tekst wiadomości.'''<br /><small>Inny tekst objaśniający.</small>
}}

Tekst wiadomości.
Inny tekst objaśniający.

Domyślne obrazki

Poniższe przykłady pokazują użycie różnych wartości dla argumentu typ, nie korzystając z parametru obrazka.

typ=poważny – Poważne problemy, jak {{SdU}} i {{NPA}}.

typ=zawartość – Problemy z zawartością, jak {{Reklama}}.

typ=wiadomość – informacje o artykule, jak {{Aktualne}} i {{WEdycji}}.

Inne grafiki

Domyślne grafiki w wielu przypadkach można zastąpić bardziej odpowiednimi. Poniższe przykłady pokazują użycie parametru grafika.

typ = zawartość
grafika = {{ikona|pov|35}}
Ta grafika jest używana w szablonie {{Kontrowersja}} i podobnych.

Opis parametrów

Nie w każdej przestrzeni nazw będą wspierane parametry specjalne, grafika = nie lub grafika = brak.

Lista wszystkich podstawowych parametrów:

{{mbox
| typ     = poważny / zawartość / integruj / wiadomość
| grafika = {{ikona|jakaś ikona|35}} / nie / brak
| grafika prawo = {{ikona|jakaś ikona|35}} / cokolwiek
| tekst   = Tekst szablonu
}}

typ

Jeśli nie podano parametru typ, przyznawany jest typ wiadomość.

grafika

Brak parametru = Używana jest domyślna grafika związana z parametrem typ.

Jakaś grafika = Powinien zostać użyty szablon {{ikona}} z szerokością 35px. Na przykład:

{{ikona|pov|35}}

nie = Nie używa grafiki

brak = Nie używa żadnej grafiki, ale zostawia puste pole szerokości domyślnego obrazka, co pozwala na wyrównywanie tekstu w kilku szablonach. (Zobacz przykłady-"specjały" powyżej)

tekst

Tekst szablonu.

grafika prawo

Grafika, która ma się pojawić po prawej stronie komunikatu.

brak parametru - nie wyświetla grafiki po prawej

jakaś grafika - jak wyżej. Przykład:

{{ikona|pt|35}}

cokolwiek - dowolny obiekt, który ma się pojawić po prawej stronie

tekst

Tekst szablonu.