Przejdź do zawartości

Szablon:Mbox

Z Wikibooks, biblioteki wolnych podręczników.
 Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]
Spis treści

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 już konieczna), tą przestrzeń można podać opcjonalnie, chociaż ona nie jest wcale wymagana. Szablon powinno się stosować w każdym komunikacie projektu, który jest stosowany w różnych przestrzeniach nazw, np. {{dopracować}}, {{ek}}, czy {{DNU}}.

Przestrzenie nazw

  • {{Imbox}} stosuje w przestrzeniach nazw: Plik.
  • {{Dmbox}} nie jest obsługiwany.

Przestrzeń nazw Media nie jest wspierana z uwagi na jej charakterystykę.

Użycie

Przestrzeń nazw Szablon (używa szablonu {{Ombox}}), czyli bez użycia parametru | nazwa przestrzeni nazw = (szablon sam wykrywa przestrzeń nazw)

Proste użycie:

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

Złożone użycie:

{{Mbox
 | typ     = zawartość
 | tekst   = Tekst wiadomości.
}}

Przestrzeń nazw (główna) (używa szablonu {{Ambox}})

Proste użycie:

{{Mbox
 | tekst = Jakiś tekst.
 | nazwa przestrzeni nazw = (main)
}}

Złożone użycie:

{{Mbox
 | typ     = zawartość
 | tekst   = Tekst wiadomości.
 | nazwa przestrzeni nazw = (main)
}}

Przestrzeń nazw Dyskusja (używa szablonu {{Tmbox}})

Proste użycie:

{{Mbox
 | tekst = Jakiś tekst.
 | nazwa przestrzeni nazw = Talk
}}

Złożone użycie:

{{Mbox
 | typ     = zawartość
 | tekst   = Tekst wiadomości.
 | nazwa przestrzeni nazw = Talk
}}

Przestrzeń nazw Specjalna (używa szablonu {{Fmbox}})

Proste użycie:

{{Mbox
 | tekst = Jakiś tekst.
 | nazwa przestrzeni nazw = Special
}}

Złożone użycie:

{{Mbox
 | typ     = ostrzeżenie
 | tekst   = Tekst wiadomości.
 | nazwa przestrzeni nazw = Special
}}

Przestrzeń nazw Plik (używa szablonu {{Imbox}})

Proste użycie:

{{Mbox
 | tekst = Jakiś tekst.
 | nazwa przestrzeni nazw = File
}}

Złożone użycie:

{{Mbox
 | typ     = zawartość
 | tekst   = Tekst wiadomości.
 | nazwa przestrzeni nazw = File
}}

Przestrzeń nazw Kategoria (używa szablonu {{Cmbox}})

Proste użycie:

{{Mbox
 | tekst = Jakiś tekst.
 | nazwa przestrzeni nazw = Category
}}

Złożone użycie:

{{Mbox
 | typ     = zawartość
 | tekst   = Tekst wiadomości.
 | nazwa przestrzeni nazw = Category
}}

Przestrzeń nazw Wikibooks (używa szablonu {{Ombox}})

Proste użycie:

{{Mbox
 | tekst = Jakiś tekst.
 | nazwa przestrzeni nazw = Project
}}

Złożone użycie:

{{Mbox
 | typ     = zawartość
 | tekst   = Tekst wiadomości.
 | nazwa przestrzeni nazw = Project
}}

typ

 Zobacz więcej na stronie Wikipedia:Szablony komunikatów, w sekcji Odmiany kolorystyczne.

Parametr typ definiuje kolor lewego paska szablonu oraz domyślną ikonę. Typ nie powinien być wybierany ze względów estetycznych, ale powinien być wybierany w zależności od przedstawianego przez komunikat problemu. Dostępne są 4 typy, które przedstawiono poniżej z domyślnymi ikonami.

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

Przykłady użycia szablonu {{Mbox}} w różnych prestrzeniach nazw

Przestrzeń nazw (główna) (używa szablonu {{Ambox}})
Przestrzeń nazw Dyskusja (używa szablonu {{Tmbox}})
Przestrzeń nazw Specjalna (używa szablonu {{Fmbox}})
Przestrzeń nazw Plik (używa szablonu {{Imbox}})
Przestrzeń nazw Kategoria (używa szablonu {{Cmbox}})
Przestrzeń nazw Wikibooks (używa szablonu {{Ombox}})

Parametry graficzne: | grafika = i | grafika prawo = , oraz szablonowe szablonów komunikatów: | poniżej =

Wprowadzenie do grafik i szablonów zagniezdżonych w szablonie

Jeśli ten parametr nie jest 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 zapełnienie tego miesca przez tekst użytą w szablonie.

| grafika = jakaś grafika

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

{{Ikona|pov|35}}
| grafika prawo = jakaś grafika

Po prawej stronie szablonu można umieścić drugą grafikę lub inny obiekt, wprowadzając jego kod jako parametr | grafika prawo = .

Jeśli nie zdefiniowano tego parametru, szablon nie wyświetla żadnej grafiki lub elementu po prawej stronie komunikatu.

Szablon {{Mbox}} - przykłady jego użyć z parametrami graficznymi i w konfiguracji szablon komunikatu w szabblonie komunikatu

Przestrzeń nazw (główna) (używa szablonu {{Ambox}})
Przestrzeń nazw Dyskusja (używa szablonu {{Tmbox}})
Przestrzeń nazw Specjalna (używa szablonu {{Fmbox}})
Przestrzeń nazw Plik (używa szablonu {{Imbox}})
Przestrzeń nazw Kategoria (używa szablonu {{Cmbox}})
Przestrzeń nazw Wikibooks (używa szablonu {{Ombox}})

Parametry alternatywne tekstu: | tekst = albo | treść = bądź | 1 =

Tekst szablonu, lub inne elementy jego zawartości.

Opis parametrów

Lista wszystkich parametrów:

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

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

{{Mbox
 | typ             = <w zależności od przestrzeni, w której znalazł się szablon, to wtedy używa ustalonego dla niej szablonu komunikatu albo ustalane za pomocą zmiennej | nazwa przestrzeni nazw =  (patrz na górze), co przyjmuje ten parametr | typ = >.
 | 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 {{Mbox}} 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.
 | nazwa przestrzeni nazw = Nazwa przestrzeni nazw symulująca podaną przestrzeń, w której ma się znaleźć ten szzablon.
}}

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

Parametry mbox
typ
(opcjonalny)
Typ powiadomienia. Jeśli nie podano parametru typ, przyznawany jest typ w zależności w jakiej przestrzeni szablon się znalazł lub od parametru nazwa przestrzeni nazw.
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 zmiennej: 1, tekst lub treść, i z tego poniżej, jeśli: styl poniżej, nie podano.
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.
styl poniżej
(opcjonalny)
Styl CSS ramki tego spod parametru poniżej.
id
(opcjonalny)
Identyfikator komunikatu ramki z komunikatem.
klasa
(opcjonalny)
Nazwa klasy CSS dla ramki z komunikatem.
styl
(opcjonalny)
Styl CSS dla ramki z komunikatem.
nazwa przestrzeni nazw
(opcjonalny)
Nazwa przestrzeni nazw symulująca podaną przestrzeń, w której ma się znaleźć ten szablon.

Szczególne przypadki

Specjalna składnia

Jeśli masz zamiar wykorzystywać znaki specjalne w parametrze | treść = , musisz zastosować poniższe rozwiązania:

{{Mbox
 | 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: {{!}}{{))}}.}}
}}

Szablon {{Mbox}} ze specjalnymi znakami mechanizmu MediaWiki

Przestrzeń nazw (główna) (używając szablonu {{Ambox}})
Przestrzeń nazw Dyskusja (używając szablonu {{Tmbox}})
Przestrzeń nazw Specjalna (używając szablonu {{Fmbox}})
Przestrzeń nazw Plik (używając szablonu {{Imbox}})
Przestrzeń nazw Kategoria (używając szablonu {{Cmbox}})
Przestrzeń nazw Wikibooks (używając szablonu {{Ombox}})

Budowa tabelkowa obiektów przy pomocy klas i styli, CSS, kaskadowych arkuszy stylów szablonów komunikatów

Ten szablon korzysta z klas CSS, więc łatwo można go zmienić według preferencji użytkowników.

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

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

Ten szablon używa klas CSS mbox styli lokalnych: Szablon:Mbox/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.

Uniwersalny szablon szablonów, stosowany do tworzenia wszelkich komunikatów. Upraszcza kod źródłowy komunikatów, ponieważ automatycznie dostosowuje swój wygląd w zależności od przestrzeni nazw.

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ść i ewentualnie z tego poniżej, jeśli styl poniżej nie podano, 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
styl poniżejstyl poniżej

Ustawia styl kaskadowych arkuszy stylów CSS elementowi wstawianemu pod parametrem poniżej.

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: