Szablon:Cmbox
| |||||||||||||||||||||||||||||||
To jest meta-szablon {{cmbox}} lub pole wiadomości kategorii.
Jest używany do budowania szablonów pól wiadomości dla stron kategorii, takich jak: {{mbox-strona}}, itd. Oferuje kilka różnych kolorów, używa domyślnych wyobrażeń, jeśli nie podano parametru wyobrażenia 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żamy)!
Po długiej dyskusji na stronie dyskusji tego szablonu i w innych miejscach w końcu wdrażamy ten szablon. Możesz swobodnie konwertować dowolne pola wiadomości używane na stronach kategorii, aby używały tego meta-szablonu. Jeśli znajdziesz jakieś trudne przypadki, wypisz je na stronie dyskusji tego szablonu, a otrzymasz pomoc.
Kiedy ten szablon jest używany do budowania pól wiadomości kategorii, pola te powinny zawierać wyjaśniające wiadomości, tak jak poprzednio. (Te same wiadomości co poprzednio lub nowe, ulepszone wiadomości.) Jeśli w polach znajdują się bardziej szczegółowe obrazy lub znasz lepszy obraz, użyj ich zamiast domyślnych obrazów pokazanych tutaj.
Użycie
Prosty przykład użycia:
{{Cmbox | treść = Jakaś wiadomość.}}
 |
Jakaś wiadomość. |
Złożony przykład:
{{Cmbox
| 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ść = Treść ciała wiadomości.
}}
 |
Treść ciała wiadomości. |
Wskazówki dotyczące pola wiadomości kategorii
Poniższe przykłady wykorzystują różne parametry typ, ale nie zawierają parametru: | grafika = , dlatego dla każdego wywołania stosują domyślne grafiki.
 |
| 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 = 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 = styl – Drobne ostrzeżenia i problemy, takie jak: {{Kasowanie po przeniesieniu}} i {{Zgłoś błąd}}.
|
 |
| typ = przeniesienie – Przenoszenie, scalanie i dzielenie wiadomości i propozycji, takich jak: {{Integrowanie}}, {{Integruj z}} i {{Integruj do}}.
|
 |
| typ = integruj – integracja, dzielenie i propozycje transwiki, jak {{Integracja}}.
|
 |
| typ = ochrona – Szablony ochrony, takie jak: {{Wysokie ryzyko}} i {{Skomplikowany}}, wyświetlane na stronie pliku.
|
 |
| 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}}.
|
Jeśli w wywołaniu szablonu nie zadeklarowano parametru typ, domyślnym ustawieniem jest | typ = wiadomość.
Inne grafiki
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 image, aby określić obraz inny niż domyślne obrazy.
 |
| typ = styl | grafika = {{Plik|plik=Sub-arrows.svg|rozmiar=40px}} Ten obraz jest używany do: {{Opis kategorii}} i {{Opis kategorii 2}}. |
 |
| typ = przeniesienie | grafika = {{Plik|plik=Redirect arrow.svg|rozmiar=52px}} Ten obraz jest używany do: {{Podziel}}, {{Wydziel}} i {{Softredirect}}. |
Specjalne
Kilka innych kombinacji parametrów.
|
Nie podano typu i obrazu (domyślne) | poniżej = {{Cmbox|typ=zawartość|treść=Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek!}}
| ||
| |||
Brak typu i | grafika = none – Obrazek nie jest używany, a | treść = zajmuje cały obszar pola wiadomości. | poniżej = {{Cmbox|typ=zawartość|Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek!}}
| |||
| |||
 |
Brak typu i | grafika = brak – Obrazek nie jest używany, a | treść = zajmuje cały obszar pola wiadomości bez miejsca na grafiki. | poniżej = {{Cmbox|typ=zawartość|Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek!}}
| ||
| |||
 |
| grafika = {{Plik|plik=Gnome globe current event.svg|rozmiar=42px}} | grafika prawo = {{Plik|plik=Nuvola apps bookcase.svg|rozmiar=40px}} | poniżej = {{Cmbox|typ=zawartość|treść = Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek! }}
|
 | ||
| ||||
|
Ta kategoria zawiera artykuły o bieżących i niedawnych lotach kosicznych. Kategoria ta jest wypełniana przez szablon {{Wolumin}}. | poniżej = {{Cmbox|typ=zawartość|Ten szablon jest w osobnym wierszu, z atomatycznie ustawioną liczbą scalonych komórek!}}
|
 | ||
| ||||
Opis parametrów
Lista wszystkich parametrów:
{{Cmbox
| typ =
| grafika =
| grafika prawo =
| styl tekstu =
| [tekst|treść|1] =
| poniżej =
| id =
| klasa =
| styl =
}}
Przykładowe użycie z opisem parametrów:
{{Cmbox
| 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 {{Cmbox}} 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 cmbox | |
|---|---|
| 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) |
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:
{{Cmbox
| 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 cmbox cmbox-content box-mobilne|<!--
-->{{Wiersz|<!--
-->{{Komórka|klasa=mbox-image cmbox-image|{{Ikona|pomuwaga|35}} }}<!--
-->{{Komórka|Jakiś tekst}}<!--
-->}}<!--
-->}}
|
Jakiś tekst |
Ten szablon używa klas CSS cmbox styli lokalnych: Szablon:Cmbox/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 kategoriach w przestrzeni nazw Kategoria.
| 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ż
- 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:
|
Powyższy opis jest dołączany ze strony Szablon:Cmbox/opis. (edytuj | historia)
Kategorie należy dodawać do podstrony /opis. Zobacz podstrony tego szablonu. |