Szablon:Szablon nawigacyjny z kolumnami

Template-info.png Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

Ten szablon służy do tworzenia szablonów nawigacyjnych, dołączanych na dole stron i grupujących je w grupę powiązaną logicznie, która nie może być w prosty sposób ukazana przez kategorie.

UżycieEdytuj

{{Szablon nawigacyjny z kolumnami
|nazwa={{subst:PAGENAME}}
|tytuł=
|grafika=
|góra=
|opis1=
|spis1=
|opis2=
|spis2=
|opis3=
|spis3=
|dół=
|kategoria=
}}

Lista parametrówEdytuj

Parametr opis1 (itd.) jest parametrem opcjonalnym, jak i sekcje nazwane góra czy dół.
Oto podstawowe, najczęściej stosowane parametry (pełen spis znajduje się poniżej):

nazwa – nazwa szablonu, czyli tytuł strony bez prefiksu Szablon:.
tytuł – tekst do wyświetlania w nagłówku (czyli, w tej części szablonu, która pozostaje zawsze widoczna), np. [[Dyskografia Björk]].
zwijanie – auto, rozwinięte, zwinięte: początkowy stan rozwinięcia szablonu, gdzie auto pozostawia go zwiniętego domyślnie, kiedy jest jednym z szeregu szablonów typu navbox występujących w serii, a rozwiniętego, kiedy ukazuje się w odosobnieniu. W przestrzeni "Szablon" wszystkie szablony są domyślnie rozwinięte.
grafika – opcjonalna grafika umieszczona po prawej (zakodowana pełną składnią, np. [[Plik:XX.jpg|70px]]).
grafika lewa – opcjonalna grafika umieszczona po lewej (zakodowana tak samo jak dla parametru grafika).
góra – opcjonalny tekst do wyświetlenia nadpisaniem i z wycentrowaniem, na osobnym tle, nad zawartością ponumerowanych parametrów opis czy spis (np. sekwencja wikilinków).
opisn – nagłówek umieszczony na osobnym tle nad kolumną z wartościami ze spisn (jeżeli opisn jest opuszczony, spisn wyświetli się pod nagłowkiem z kolumny poprzedzającej); nagłówki kolumn nie będą wyświetlane jeśli nie zostanie podany opis1.
spisn – tekst wymieniający wikilinki, generalnie w formacie wypunktowanej wikilisty
dół – opcjonalny tekst, jak góra omówiony wcześniej, tyle że u dołu szablonu. Bardzo wskazane jest umieszczenie szablonu {{Uwagi|=nav}} w celu wyświetlania tu przypisów lub uwag oznaczonych indeksem górnym w treści szablonu, np. "coś tam<ref name="X" group="nav"/>...{{Uwagi|=nav|X=Jestem przypisem.|...}}"
kategoria – parametr pozwalający na automatyczne dodanie szablonu do odpowiedniej podkategorii kategorii Szablony nawigacyjne. Należy podać tu tekst występujący w nazwie kategorii po dywizie.

Detale i raczej bardzo złożone techniczne zastrzeżenia są wyjaśnione poniżej w sekcji Opis parametrów. Alternatywne formatowanie szablonu nawigacyjnego opisane jest w sekcji Układ (kompozycja) tabeli.

Opis parametrówEdytuj

Poniżej znajduje się pełna lista parametrów, jakie mogą być używane z szablonem {{Szablon nawigacyjny z kolumnami}}. W większości przypadków jedynymi wymaganymi parametrami są nazwa, tytuł, i spis1. Podszablony dla Navbox (zagnieżdżone navboksy) nie wymagają użycia jakiegokolwiek parametru w ogóle.

Dla ułatwienia szablon {{Szablon nawigacyjny z kolumnami}} oraz pokrewne szablony {{Szablon nawigacyjny}} i {{Szablon nawigacyjny ze zwijanymi grupami}} posiadają wiele parametrów o identycznych nazwach. Wszystkie parametry oznaczone gwiazdką * są wspólne dla tych trzech szablonów.

Parametry podstawoweEdytuj

nazwa*
Nazwa szablonu potrzebna do prawidłowego wyświetlania linków "p • d • e" ("podgląd • dyskusja • edytuj") na wszystkich stronach używających szablonów. Możesz użyć {{subst:PAGENAME}} dla tej wartości.
zwijanie* [auto, rozwinięte, zwinięte, zwykłe, wyłączone]
  • Domyślna wartość: auto. Szablon nawigacyjny z wartością auto zostanie wyświetlony zwinięty, jeśli na danej stronie występują co najmniej dwie tabele używające zwijania. Dla zorientowanych technicznie: MediaWiki:Common.js (wartość auto ustawia klasę CSS autocollapse.
  • Przykład: szablon {{Ośmiotysięczniki}} ma ustawiony domyślnie stan auto. Artykuł K2 zawiera dołączony ten szablon i jest to jedyny szablon nawigacyjny – dlatego pokazuje się on rozwinięty. W artykule Mount Everest szablon Ośmiotysięczniki jest jednym z dwóch szablonów nawigacyjnych, więc pokazuje się zwinięty.
  • Wartość rozwinięte powoduje, że szablon będzie zawsze rozwinięty.
  • Przykład: szablon en:Template:Historical currencies of Hungary na angielskojęzycznej Wikipedii ma ustawiony domyślnie stan rozwinięte (uncollapsed). Wszystkie strony, do których jest dołączony, pokazują domyślnie jego zawartość.
  • Wartość zwinięte powoduje, że szablon będzie zawsze zwinięty.
  • Przykład: w hipotetycznym artykule, który zawierałby przy wywołaniu szablonu parametr zwijanie = zwinięte, zawartość byłaby schowana.
  • Wartość zwykłe powoduje, że szablon będzie zawsze rozwinięty, a po prawej nie zostanie wyświetlony link [ukryj]. Przy tej opcji tytuł zawsze będzie wyśrodkowany (linki p • d • e zostaną przesunięte za pomocą paddingu).
  • Wartość wyłączone powoduje, że szablon będzie zawsze rozwinięty, a po prawej nie zostanie wyświetlony link [ukryj]. Przy tej opcji tytuł nie będzie wyśrodkowywany za pomocą paddingu. Ta opcja jest przeznaczona do zaawansowanych ustawień, bezpieczniej jest korzystać z zwykłe, jeśli chcemy schować link [ukryj].
  • Jakiekolwiek wartości inne niż auto, zwinięte, zwykłe lub wyłączone (w tym rozwinięte) powodują, że szablon będzie zawsze rozwinięty oraz będzie wyświetlony link [ukryj].
Aby wyświetlić cały szablon na jego stronie w przestrzeni Szablon, a przy tym automatycznie zwijać zawartość w artykułach, należy wstawić wartość zwinięte wewnątrz znaczników <includeonly>:
  • zwijanie = <includeonly>zwinięte</includeonly>
Często zachodzi potrzeba ustawienia domyślnego stanu zwinięcia, który mógłby zostać nadpisany w konkretnym haśle. Można to zrobić w następujący sposób:
  • Utwórz w danym szablonie, utworzonym na podstawie Navbox, dodatkowy parametr o nazwie zwijanie – w ten sposób:
  • | zwijanie = {{{zwijanie<includeonly>|wybrany domyślny stan</includeonly>}}}
  • Kod <includeonly>| sprawi, że na stronie szablonu będzie on rozwinięty.
  • Na konkretnej stronie do wywołania danego szablonu dodaj parametr zwijanie z wybraną opcją, np. {{Weryfikacja treści|zwijanie = zwinięte}}
kategoria
Parametr pozwala na automatyczne dodanie szablonu do odpowiedniej podkategorii kategorii Szablony nawigacyjne. Należy podać tu tekst występujący w nazwie kategorii po dywizie, czyli np. aby umieścić szablon w kategorii Kategoria:Szablony nawigacyjne - astronautyka, należy podać parametr kategoria = astronautyka. Jeśli nie chcemy dodawać do szablonu żadnej kategorii wpisujemy kategoria = nie.
kategoria2, kategoria3
Jeśli chcemy umieścić szablon w więcej niż jednej kategorii, należy wykorzystać te parametry w sposób analogiczny jak kategoria.

KomórkiEdytuj

tytuł*
Tekst, który pojawia się wyśrodkowany w górnym pasku tabeli. Zazwyczaj zawiera temat szablonu, np. zwięzły opis jego zawartości. Tekst powinien zajmować pojedynczą linię, jednak możliwe jest użycie większej liczby linii przy użyciu {{-}} do prawidłowego wyśrodkowania. Ten parametr z technicznego punktu widzenia nie jest obowiązkowy, ale używanie szablonów nawigacyjnych bez tytułu jest dość bezsensowne.
opisn*
(np. opis1, opis2 itd.) Zawartość nagłówka nad kolumną o numerze n. Zobacz przykłady poniżej.
spisn*
(np. spis1, spis2 itd.) Zawartość kolumny o numerze n, zazwyczaj lista linków. Wymagany jest co najmniej jeden parametr spis1. Każdy element spis jest wyświetlany w osobnej kolumnie i może (ale nie musi) być poprzedzony nagłówkiem opisn. Jeśli to możliwe to zawartość każdego spisu jest prezentowana jako układ wielokolumnowy, a zalecana szerokość kolumny w tym układzie jest ustalona na 24em.
grafika*
Grafika, która zostanie wyświetlona w komórce pod paskiem tytułowym i na prawo od list. Aby obrazek pokazywał się prawidłowo, należy wpisać też parametr spis1. Parametr grafika może zawierać standardowy wikikod, aby wyświetlić obrazek, np.
grafika = [[Plik:Przykład.jpg|100px]]
grafika lewa*
Grafika, która zostanie wyświetlona w komórce pod paskiem tytułowym i na lewo od list. Aby obrazek pokazywał się prawidłowo, należy wpisać też parametr spis1 oraz nie wpisywać parametrów opisn. Parametr grafika lewa może zawierać standardowy wikikod, aby wyświetlić obrazek, np.
grafika lewa = [[Plik:Przykład.jpg|100px]]
góra*
Komórka zajmująca całą szerokość tabeli, znajdująca się pomiędzy paskiem tytułowym oraz pierwszą listą, czyli nad główną zawartością szablonu (grupami, listami i grafiką). W szablonie bez grafiki parametr góra zachowuje się podobnie jak parametr spis1 bez parametru opis1.
dół*
Komorka zajmująca całą szerokość tabeli, znajdująca się pod główną zawartością szablonu (grupami, listami i grafiką). W szablonie bez grafiki parametr dół zachowuje się podobnie jak ostatni parametr spisn bez parametru opisn. Przykład użycia: szablon {{Podział Karpat}}.

Parametry stylów CSSEdytuj

Aby zachować spójność pomiędzy szablonami i stronami Wikipedii, nie zaleca się używania stylów CSS w szablonach. Istnieje jednak opcja zmiany wyglądu poprzez CSS.

klasa*
Zobacz zaawansowane parametry niżej.
parzystość [zamień, parzyste, nieparzyste, brak]
Wartość zamień powoduje, że kolejność kolorowania parzystych i nieparzystych numerów wierszy jest odwrócona. Normalnie (bez zmiany kolorów np. przez styl nieparzystych) parzyste wiersze są szare, a nieparzyste białe. Przy użyciu tego parametru wiersze nieparzyste stają się szare, a parzyste białe. Ustawienie parzyste lub nieparzyste powoduje, że wszystkie wiersze mają ten sam kolor tła, odpowiednio domyślny dla parzystych i nieparzystych wierszy. Ustawienie wartości brak wyłącza automatyczne kolorowanie wierszy. Ten zaawansowany parametr powinien być używany jedynie w celu naprawy problemów przy zagnieżdżaniu szablonów, kiedy paski mogą się nie dopasować. Przykłady i szczegółowy opis znajdują się w sekcji o zagnieżdżaniu poniżej.
Uwaga: nie działa w szablonach zagnieżdżonych.

Zaawansowane parametryEdytuj

klasa
Dodaje dodatkową treść do atrybutu class wygenerowanego szablonu nawigacyjnego. Zbiór dopuszczalnych wartości obejmuje:
  • ll-script włącza automatyczne skrypty
  • ll-script-dl-hlist wskazuje automatyczny skrypt do wykonania MediaWiki:Gadget-ll-script-dl-hlist.js
  • kz-linia włącza obsługę szablonów {{KZ-linia}}
  • nav-teams zmienia formatowanie wybranych szablonów drużyn sportowych
  • hnowrap-ul-ul zmienia formatowanie w specyficznych sytuacjach
  • medaliści koloruje nagłówki pól opis1, opis2 i opis3 na złoto, srebro i brąz.
  • hwrap zezwala na łamanie linii w treści elementu listy
  • pionowy włącza tryb pionowy, który jest podobny do infoboksu
przestrzeń
Przestarzały parametr do zmiany przestrzeni, w której znajduje się szablon. Domyślnie: Szablon.

PrzykładyEdytuj

Układ kolumnowy z jednym spisem i opisami u góry i na doleEdytuj

{{Szablon nawigacyjny z kolumnami
|nazwa = {{subst:PAGENAME}}
|tytuł = Członkowie [[East Asia Summit|East Asia Summit (EAS)]]

|góra =
* ''To jest wartość pola {{{góra}}}.''

|spis1 =
* {{Państwo|AUS}}
* {{Państwo|BRN}}
* {{Państwo|KHM}}
* {{Państwo|IND}}
* {{Państwo|IDN}}
* {{Państwo|JPN}}
* {{Państwo|LAO}}
* {{Państwo|MYS}}
* {{Państwo|MMR}}
* {{Państwo|NZL}}
* {{Państwo|CHN}}
* {{Państwo|PHL}}
* {{Państwo|SGP}}
* {{Państwo|KOR}}
* {{Państwo|THA}}
* {{Państwo|VNM}}

|dół =
; Potencjalni przyszli członkowie
: {{Państwo|TLS}}
: {{Państwo|RUS}}
}}

Z kolumnami i opisami u góry i na doleEdytuj

{{Szablon nawigacyjny z kolumnami
|nazwa = {{subst:PAGENAME}}
|tytuł = Członkowie [[East Asia Summit|East Asia Summit (EAS)]]

|góra =
* ''To jest wartość pola {{{góra}}}.''

|spis1 =
* {{Państwo|AUS}}
* {{Państwo|BRN}}
* {{Państwo|KHM}}
* {{Państwo|IND}}
* {{Państwo|IDN}}
* {{Państwo|JPN}}
* {{Państwo|LAO}}
* {{Państwo|MYS}}

|spis2 =
* {{Państwo|MMR}}
* {{Państwo|NZL}}
* {{Państwo|CHN}}
* {{Państwo|PHL}}
* {{Państwo|SGP}}
* {{Państwo|KOR}}
* {{Państwo|THA}}
* {{Państwo|VNM}}

|dół =
; Potencjalni przyszli członkowie
: {{Państwo|TLS}}
: {{Państwo|RUS}}
}}

Relacje z innymi szablonami nawigacyjnymiEdytuj

Szablon nawigacyjny został stworzony wspólnie z dwoma pokrewnymi szablonami: {{Szablon nawigacyjny z kolumnami}} i {{Szablon nawigacyjny ze zwijanymi grupami}}. Wszystkie trzy szablony mają wspólne parametry (oznaczone powyżej gwiazdkami), aby ułatwić ich używanie. Każdy z tych trzech szablonów może być użyty jako podszablon innego.

Zagnieżdżanie różnych szablonów nawigacyjnychEdytuj

Ten przykład pokazuje, jak szablony {{szablon nawigacyjny}}, {{szablon nawigacyjny ze zwijanymi grupami}} i {{szablon nawigacyjny z kolumnami}} tworzą jeden duży szablon. Przyciśnij przycisk edycji tej sekcji, aby zobaczyć kod (jest dość długi).

Szczegóły techniczneEdytuj

  • Szablon używa klas CSS, więc jego wygląd jest w pełni modyfikowalny.
  • Na potrzeby wewnętrzne ten szablon używa składni HTML zamiast wikikodu. W ten sposób są tworzone też inne skomplikowane szablony, ponieważ wikikod ma wady. Np. użycie funkcji parsera lub znaków specjalnych w parametrach jest trudniejsze do wykonania przy użyciu wikikodu.

Zawiłe drobiazgiEdytuj

Zobacz teżEdytuj


  • {{Grupa szablonów}} – szablon do tworzenia szablonów nawigacyjnych zawierających grupy szablonów nawigacyjnych