Szablon:Ambox

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

To jest {{Ambox}} (skrót od article message box) — szablon szablonów.

Szablon ten jest używany do tworzenia komunikatów stosowanych w artykułach (przestrzeni głównej), takich jak {{Dopracować}}. Oferuje on różne kolory i obrazki, odpowiednie do rodzaju problemu wskazywanego przez tworzony komunikat.

Użycie

Proste użycie:

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

Złożone użycie:

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

typ

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ść.

grafika i poniżej

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

{{Ikona|pov|35}}

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.

grafika prawo

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.

tekst

Tekst szablonu, lub inne elementy jego zawartości.

Opis parametrów

Lista wszystkich parametrów:

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

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

{{Ambox
 | 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 {{Ambox}} 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 ambox
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.

Szczególne przypadki

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

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

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

Ten szablon używa klas CSS ambox styli lokalnych: Szablon:Ambox/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 artykułach w przestrzeni nazw (główna) i Wikijunior.

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.