 | Ten szablon wykorzystuje skomplikowane elementy mechanizmu MediaWiki.
Aby uniknąć uszkodzenia szablonu, wszystkie eksperymenty należy przeprowadzać w swoim brudnopisie lub na stronach testowych. Przetestowane zmiany powinny być dodawane w jednej edycji. Proszę przedyskutować każdą zmianę przed jej wprowadzaniem. Osoba dokonująca zmian w tym szablonie powinna być przygotowana do naprawienia niepożądanych efektów ubocznych swoich działań. |
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.
{{Szablon nawigacyjny z kolumnami
|nazwa={{subst:PAGENAME}}
|tytuł=
|grafika=
|góra=
|opis1=
|spis1=
|opis2=
|spis2=
|opis3=
|spis3=
|dół=
|kategoria=
}}
{{{tytuł}}} |
---|
{{{góra}}}
|
{{{opis1}}} | {{{opis2}}} |
---|
{{{spis1}}}
|
{{{spis2}}}
|
{{{spis3}}} bez parametru {{{opis3}}}
|
| {{{grafika}}} |
{{{dół}}}
|
|
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.
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 podstawowe[edytuj kod]
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
.
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 CSS[edytuj kod]
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 parametry[edytuj kod]
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.
Układ kolumnowy z jednym spisem i opisami u góry i na dole[edytuj kod]
{{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 dole[edytuj kod]
{{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 nawigacyjnymi[edytuj kod]
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 nawigacyjnych[edytuj kod]
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).
Szablon nawigacyjny, Szablon nawigacyjny z kolumnami i Szablon nawigacyjny ze zwijanymi grupami – wesoła gromadka |
---|
|
|
|
Szablon nawigacyjny z kolumnami zagnieżdżony w sobie samym |
---|
nagłowek 1 | nagłówek 2 | nagłowek 3 |
---|
nagłówek 1.1 | nagłówek 1.2 |
---|
kolumna 1.1
|
kolumna 1.2
|
|
|
kolumna 2
|
nagłówek 3.1 | nagłówek 3.2 | nagłówek 3.3 |
---|
kolumna 3.1
|
kolumna 3.2
|
kolumna 3.3
|
|
|
|
|
|
Szczegóły techniczne[edytuj kod]
- 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.
 | Tę sekcję należy dopracować:Tę sekcję trzeba napisać. Po wyeliminowaniu niedoskonałości należy usunąć szablon {{Dopracować}} z tej sekcji. |
- {{Grupa szablonów}} – szablon do tworzenia szablonów nawigacyjnych zawierających grupy szablonów nawigacyjnych