Szablon:Ombox

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

To jest ombox (other messages box) – szablon szablonów. Jest on używany do tworzenia szablonów informacyjnych i ostrzegawczych. Oferuje on obrazki oraz ramki, które pozwalają dopasować go do sytuacji.

Użycie

Najprostsze wywołanie szablonu:

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

Wyświetla on taki komunikat:

Style szablonu

Szablon ma przygotowane 4 style główne, 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ść”.

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:

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

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

{{Ombox
 | 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 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 {{Ombox}} 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 ombox
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 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.

Techniczne szczegóły

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

{{Ombox
 | 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 ombox ombox-content box-mobilne|<!--
 -->{{Wiersz|<!--
     -->{{Komórka|klasa=mbox-image ombox-image|{{Ikona|pomuwaga|35}} }}<!--
     -->{{Komórka|Jakiś tekst}}<!--
  -->}}<!--
-->}}

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

Parametry szablonu (strukturyzacja Wizualnego Edytora)

Szablon do użycia w przestrzeniach nazw: projektu (Wikibooks), Pomoc, Wikipeddysta, Szablon i Moduł.

Parametry szablonu[Zarządzaj danymi szablonu]

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

Parametr		Opis	Typ	Status
typ	typ	Tyo danego komunikatu oznaczony domyślnym rysunkiem i stylami.	Ciąg znaków	sugerowany
styl tekstu	styl 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ów	opcjonalny
tekst	tekst 1 treść	Tekst komunikatu	Treść	wymagany
grafika	grafika	Lewa grafika Przykład {{ikona|pov|35}}	Niezbalansowany wikitekst	sugerowany
grafika prawo	grafika prawo	Grafika po prawej stronie komunikatu.	Niezbalansowany wikitekst	opcjonalny
id	id	Unikalny identyfikator tabelki komunikatów.	Ciąg znaków	opcjonalny
klasa	klasa	Klasa kaskadowych arkuszy stylów CSS tabelki komunikatów.	Ciąg znaków	opcjonalny
styl	styl	Style tabelki komunikatu kaskadowych arkuszy stylów CSS tabelki komunikatów.	Ciąg znaków	opcjonalny
poniżej	poniżej	Inne wywołanie szablonu komunikatu w danym komunikacie.	Ciąg znaków	opcjonalny
styl poniżej	styl poniżej	Ustawia styl kaskadowych arkuszy stylów CSS elementowi wstawianemu pod parametrem poniżej.	Ciąg znaków	opcjonalny

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:

• {{AmboxProsty}} - prosty szablon komunikatów informacyjny, używający klas szablonu {{Ambox}}, stosowany w artykułach w przestrzeni nazw (główna) i Wikijunior.

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:

• {{Wymaga znajomości}} - szablon komunikatów zbudowany w oparciu o: {{Mbox-strona}}, z parametrem: | typ = notatki, linkujący do artykułu.

Inne:

• Wikipedia:Szablony komunikatów.