Szablon:Imbox/opis
| |||||||||||||||||||||||||||||||
To jest {{Mbox}} lub meta-box dla komunikatów graficznych. Format {{Imbox}} jest tutaj przemyślany. Słowo 'box' oznacza Image message box, a słowo 'imbox pochodzi od nazwy formatu w języku angielskim – która pochodzi od Image message box.
Służy do budowania szablonów pól wiadomości dla stron obrazów (plików). Oferuje kilka różnych kolorów, używa domyślnych ustawień, jeśli nie podano parametru szablonu, i ma kilka innych funkcji.
Ten szablon działa prawie dokładnie tak samo jak {{Ambox}} i używa tych samych parametrów.
Implementacja (wdrażanie)!
[edytuj]Szablon może swobodnie konwertować pola wiadomości używane na stronach obrazów (plików), aby używały tego szablonu komunikatów. Jeśli znajdziesz jakieś trudne przypadki, wypisz je na stronie dyskusji tego szablonu, a otrzymasz pomoc.
Użycie
[edytuj]Prosty przykład użycia:
{{Imbox | tekst = Tekst komunikatu.}}
 |
Tekst komunikatu. |
Kompleksowy przykład:
{{Imbox
| typ = styl
| grafika = {{Plik|plik=Emblem-question-yellow.svg|rozmiar=40px}}
| styl = width: 400px;
| styl tekstu = color: red; font-weight: bold; font-style: italic;
| treść = Wiadomości o obrazach (plikach).
}}
 |
Wiadomości o obrazach (plikach). |
Poniższe przykłady wykorzystują różne parametry | typ = , ale nie wykorzystują parametrów | grafika = , dlatego też wykorzystują domyślne obrazy dla każdego typu.
 |
| typ = poważny – Poważne problemy, jak: {{NPA}} i {{NPAfrgm}}.
|
 |
| typ = szybko – Szybkie szablony usuwania, takie jak: {{Screenshot}}.
|
 |
| typ = usuń – Szablony usuwania, takie jak: {{DNU}}, {{SdU}} i {{SdUwynik}}.
|
 |
| typ = styl – Drobne ostrzeżenia i problemy, takie jak: {{Kasowanie po przeniesieniu}} i {{Zgłoś błąd}}.
|
 |
| typ = zawartość – Ważne ostrzeżenia i problemy, takie jak: {{Dopracować|POV}}.
|
 |
| typ = rozszerz – Problemy z zawartością o małej treści, należy ją rozszrzerzyć, takie jak: {{Info|POV}}.
|
 |
| typ = przeniesienie – Przenoszenie i zmiana nazw plików i propozycje, takich jak: {{Integrowanie}}, {{Integruj z}} i {{Integruj do}}.
|
 |
| typ = ochrona – Szablony ochrony, takie jak: {{Wysokie ryzyko}} i {{Skomplikowany}}, wyświetlane na stronie pliku.
|
 |
| typ = integruj – integracja, dzielenie i propozycje transwiki, jak {{Integracja}}.
|
 |
| typ = licencja – Szablony licencji, takie jak: {{Cc-by-sa-4.0}}.
|
 |
| typ = jakość – Wyróżnione szablony plików, takie jak: {{Plik}}, {{Rysunek}} i {{MapaObrazu}}.
|
 |
| typ = powiadomienie – Powiadomienia i wiadomości wszelkiego rodzaju, zarówno stałe, jak i tymczasowe.
|
|
| typ = wiadomość – informacje o artykule, jak {{Aktualne}} i {{W edycji}}.
|
Inne pliki
[edytuj]Domyślne obrazy pokazane powyżej są głównie dla wygody. W wielu przypadkach bardziej odpowiednie jest użycie bardziej szczegółowych obrazów. Te przykłady używają parametru | grafika = , aby określić obraz inny niż domyślne obrazy.
 |
| typ = styl | grafika = {{Plik|plik=Gnome-dev-camera.svg|rozmiar=42px}} Takie szablony używane jak: {{Dopracować}}. |
 |
| typ = przenoszenie | grafika = {{Plik|plik=To Commons.svg|rozmiar=52px}} Takie szablony używane jak {{Integrowanie}}, {{Integruj z}} i {{Integruj do}}. |
 |
| typ = licencja | grafika = {{Plik|plik=Heckert GNU white.svg|rozmiar=48px}} Ten obraz jest używany do szablonów licencji GFDL, takich jak: {{GFDL}}. |
Specjalne
[edytuj]Kilka innych kombinacji parametrów.
|
Brak typu i brak podanego pliku (domyślnie) | poniżej = {{Imbox|typ=zawartość|treść = Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek! }}
| ||
| |||
brak grafiki, czyli: | grafika = none albo | grafika = nie (jeśli ten parametr ma inną wartość, to wtedy mamy jakąś grafikę), ale jeśli nie użyto żadnego | grafika = , to ona jest grafiką ustalaną, przy ustawionym | typ = , przez ten parametr, a jeśli nawet tego nie podano, wtedy mamy obraz domyślny, a treść wykorzystuje cały obszar pola wiadomości. | poniżej = {{Imbox|typ=zawartość|treść = Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek! }}
| |||
| |||
 |
brak grafiki, czyli: | grafika = brak, czyli wtedy powstaje wolne miejsce, tak jakby tam była widoczna grafika, a dla zawartości, określone parametrem | treść = , jest wypełniona przestrzeń poza tym miejscem. | poniżej = {{Imbox|typ=zawartość|treść = Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek! }}
| ||
| |||
  |
| typ = licencja | grafika = {{Plik|plik=Imbox licență.svg|rozmiar=40px}} {{Br}} {{Plik|plik=Ambox warning yellow.svg|rozmiar=40px}} | grafika prawo = {{Plik|plik=Shuttle.svg|rozmiar=30px}} | poniżej = {{Imbox|typ=zawartość|treść = Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek! }}
|
 | ||
| ||||
|
Ten plik jest w public domain ponieważ został stworzony przez NASA.
|
| ||
| ||||
|
| typ = licencja | grafika = {{Plik|plik=Imbox licență.svg|rozmiar=40px}} | poniżej = {{Imbox|typ=zawartość|treść = Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek! }}
| ||
| |||
Opis parametrów
[edytuj]Lista wszystkich parametrów:
{{Imbox
| typ =
| grafika =
| grafika prawo =
| styl tekstu =
| [tekst|treść|1] =
| poniżej =
| id =
| klasa =
| styl =
}}
Przykładowe użycie z opisem parametrów:
{{Imbox
| typ = poważny / szybko / usuń / styl / zawartość / rozszerz / przeniesienie / ochrona / integruj / licencja / jakość / 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 {{Imbox}} 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 imbox | |
|---|---|
| typ (opcjonalny) |
Typ powiadomienia. Jeśli nie podano parametru typ, przyznawany jest typ = wiadomość. |
| grafika (opcjonalny) |
Ikona komunikatu.
|
| grafika prawo (opcjonalny) |
Ikona komunikatu.
|
| 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) |
Styl CSS dla tekstu ramki zmienne: tekst, treść lub 1, i z tego poniżej, jeśli: styl poniżej, nie podano. |
| 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
[edytuj]Jeśli musisz użyć znaków specjalnych w parametrze | treść = , musisz je zabezpieczyć w następujący sposób:
{{Imbox
| 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: {{!}}{{))}}.}}
}}
|
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 imbox imbox-content box-mobilne|<!--
-->{{Wiersz|<!--
-->{{Komórka|klasa=mbox-image ambox-image|{{Ikona|pomuwaga|35}} }}<!--
-->{{Komórka|Jakiś tekst}}<!--
-->}}<!--
-->}}
|
Jakiś tekst |
Ten szablon używa klas CSS imbox styli lokalnych: Szablon:Imbox/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
[edytuj]Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.
Parametry szablonu (strukturyzacja Wizualnego Edytora)
[edytuj]Szablon do użycia na stronach plików w przestrzeni nazw: "Plik".
| 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
| 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ż
[edytuj]- 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: