Szablon:Szablon nawigacyjny
[]
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życie
{{Szablon nawigacyjny |nazwa={{subst:PAGENAME}} |tytuł= |zwijanie= |grafika= |góra= |opis1= |spis1= |opis2= |spis2= |opis3= |spis3= ... |dół= |kategoria= }}
Lista parametrów
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 prefiksuSzablon:
. Można wstawić szablon{{subst:PAGENAME}}
.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, gdzieauto
pozostawia go zwiniętego domyślnie, kiedy jest jednym z szeregu szablonów nawigacyjnych występujących w serii, a rozwiniętego, kiedy ukazuje się w odosobnieniu. Uwaga: w przestrzeni artykułów wszystkie szablony są domyślnie zwinięte, natomiast w miejscu ich definicji (zwykle w przestrzeni "Szablon") 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 parametrugrafika
).
góra
– opcjonalny tekst do wyświetlenia nadpisaniem i z wycentrowaniem, na osobnym tle, nad zawartością ponumerowanych parametrówopis
czyspis
(np. sekwencja wikilinków).
opisn
– nagłówek wewnętrzny umieszczony po lewej na osobnym tle od wartości zspisn
(jeżeliopisn
jest opuszczony,spisn
wyświetli się, rozpoczynając od lewej ramki szablonu nawigacyjnego).spisn
– tekst wymieniający wikilinki, generalnie w formacie wypunktowanej wikilistydół
– opcjonalny tekst, jakgó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ów
Poniżej znajduje się pełna lista parametrów, jakie mogą być używane z szablonem {{Szablon nawigacyjny}}. W większości przypadków jedynymi wymaganymi parametrami są nazwa
, tytuł
, i spis1
.
Dla ułatwienia szablon {{Szablon nawigacyjny}} oraz pokrewne szablony {{Szablon nawigacyjny z kolumnami}} 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
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ę CSSautocollapse
.
- 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.
- Przykład: szablon {{Ośmiotysięczniki}} ma ustawiony domyślnie stan
- 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ść.
- Przykład: szablon en:Template:Historical currencies of Hungary na angielskojęzycznej Wikipedii ma ustawiony domyślnie stan
- 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.
- Przykład: w hipotetycznym artykule, który zawierałby przy wywołaniu szablonu parametr
- 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ć zzwykłe
, jeśli chcemy schować link [ukryj]. - Jakiekolwiek wartości inne niż
auto
,zwinięte
,zwykłe
lubwyłączone
(w tymrozwinię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 szablonu nawigacyjnego, 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}}
- Utwórz w danym szablonie, utworzonym na podstawie szablonu nawigacyjnego, dodatkowy parametr o nazwie
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 wpisujemykategoria = 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órki
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.) Jeśli użyty jest ten parametr, tekst w nim zawarty pojawia się w komórce nagłówkowej po lewej stronie elementuspisn
. Jeśli parametr zostanie ominięty,spisn
zajmie całą szerokość wiersza tabeli.
spisn*
- (np.
spis1
,spis2
itd.) Główna część szablonu, zazwyczaj lista linków. Domyślnie format ustawiony jest na inline (w jednej linii), jednak tekst może być wpisywany w kilku liniach, jeśli zostanie otoczony znacznikiem<span> </span>
lub<div> </div>
. Wymagany jest co najmniej jeden parametrspis1
. Każdy elementspis
jest wyświetlany w osobnym wierszu tabeli i może (ale nie musi) być poprzedzony nagłówkiemopisn
.
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
. Parametrgrafika
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ówopisn
. Parametrgrafika 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 parametrspis1
bez parametruopis1
.
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 parametrspisn
bez parametruopisn
. Przykład użycia: szablon {{Podział Karpat}}.
Parametry stylów CSS
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. przezstyl nieparzystych
) parzyste wiersze są szare, a nieparzyste białe. Przy użyciu tego parametru wiersze nieparzyste stają się szare, a parzyste białe. Ustawienieparzyste
lubnieparzyste
powoduje, że wszystkie wiersze mają ten sam kolor tła, odpowiednio domyślny dla parzystych i nieparzystych wierszy. Ustawienie wartościbrak
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
klasa
- Dodaje dodatkową treść do atrybutu
class
wygenerowanego szablonu nawigacyjnego. Zbiór dopuszczalnych wartości obejmuje:ll-script
włącza automatyczne skryptyll-script-dl-hlist
wskazuje automatyczny skrypt do wykonania MediaWiki:Gadget-ll-script-dl-hlist.jskz-linia
włącza obsługę szablonów {{KZ-linia}}nav-teams
zmienia formatowanie wybranych szablonów drużyn sportowychhnowrap-ul-ul
zmienia formatowanie w specyficznych sytuacjachmedaliści
koloruje nagłówki pólopis1
,opis2
iopis3
na złoto, srebro i brąz.hwrap
zezwala na łamanie linii w treści elementu listypionowy
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.
Przypisy lub uwagi
Dla przypisów lub uwag przeznaczona została dedykowana grupa o nazwie nav
. Tworzy ona odnośniki za pomocą dużych liter tj. [A] [B] [C]. Sekcję z listą zawierającą treść odnośników należy wprowadzać szablonem {{przypisy|=nav}} lub {{uwagi|=nav}} w polu dół
.
Układ (kompozycja) tabeli
Tabela wygenerowana przez {{Szablon nawigacyjny}} bez parametrów grafika
, góra
oraz dół
:
Tabela wygenerowana przez {{Szablon nawigacyjny}} z parametrami grafika
, góra
oraz dół
:
Tabela wygenerowana przez {{Szablon nawigacyjny}} z parametrami grafika
, grafika lewa
oraz spisn
, ale bez parametrów opisn
, góra
oraz dół
:
Przykłady
Bez obrazka
{{Szablon nawigacyjny |nazwa = {{subst:PAGENAME}} |tytuł = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]{{-}}''bez grafiki'' |opis1 = Centrum |spis1 = * [[Cyberjaya]] |opis2 = Teren |spis2 = * [[Klang Valley]] |opis3 = Ważne miejsca |spis3 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] * [[Technology Park Malaysia]] * [[Putrajaya]] * [[Cyberjaya]] * [[Kuala Lumpur International Airport]] |opis4 = Infrastruktura |spis4 = * [[Express Rail Link]] * [[KL-KLIA Dedicated Expressway]] |opis5 = Inne |spis5 = * [[EGovernment]] * [[MyKad]] }}
Z obrazkiem, bez grup
{{Szablon nawigacyjny |nazwa = {{subst:PAGENAME}} |tytuł = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]] |grafika = {{flaga|Malezja|rozmiar=80px}} |spis1 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] * [[Technology Park Malaysia]] * [[Putrajaya]] * [[Cyberjaya]] * [[Kuala Lumpur International Airport]] }}
Z dwoma obrazkami, bez grup, kilka list
{{Szablon nawigacyjny |nazwa = {{subst:PAGENAME}} |tytuł = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]] |grafika = {{flaga|Malezja|rozmiar=80px}} |grafika lewa = {{flaga|Malezja|rozmiar=80px}} |spis1 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] • [[Kuala Lumpur Sentral]] |spis2 = * [[Express Rail Link]] * [[KL-KLIA Dedicated Expressway]] |spis3 = * [[EGovernment]] * [[MyKad]] |spis4 = * [[Klang Valley]] }}
Z obrazkiem, grupami i dodatkowym opisem u dołu i góry
{{Szablon nawigacyjny |nazwa = {{subst:PAGENAME}} |tytuł = [[Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]] |grafika = {{flaga|Malezja|rozmiar=80px}} |góra = * To jest miejsce na górny tekst |opis1 = Centrum |spis1 = * [[Cyberjaya]] |opis2 = Teren |spis2 = * [[Klang Valley]] |opis3 = Ważne miejsca |spis3 = * [[Petronas Twin Towers]] * [[Kuala Lumpur Tower]] * [[Kuala Lumpur Sentral]] * [[Technology Park Malaysia]] * [[Putrajaya]] * [[Cyberjaya]] * [[Kuala Lumpur International Airport]] |opis4 = Infrastruktura |spis4 = * [[Express Rail Link]] * [[KL-KLIA Dedicated Expressway]] |opis5 = Inne |spis5 = * [[EGovernment]] * [[MyKad]] |dół = * Strona internetowa: [http://www.msc.com.my/ www.msc.com.my] }}
Zagnieżdżone navboksy
{{Szablon nawigacyjny |nazwa = {{subst:PAGENAME}} |tytuł = Przykład wielokrotnych podgrup |zwijanie = auto |góra = Nagłówek |opis1 = Grupa 1 |spis1 = Lista 1 |opis2 = Grupa 2 |spis2 = {{Szablon nawigacyjny |opis1 = Grupa 2.1 |spis1 = Lista 2.1 |opis2 = Grupa 2.2 |spis2 = Lista 2.2 |opis3 = Grupa 2.3 |spis3 = Lista 2.3 }} |opis3 = Grupa 3 |spis3 = Lista 3 |opis4 = Grupa4 |spis4 = {{Szablon nawigacyjny |opis1 = Grupa 4.1 |spis1 = Lista 4.1 |opis2 = Grupa 4.2 |spis2 = Lista 4.2 |opis3 = Grupa 4.3 |spis3 = Lista 4.3 }} |grafika = {{flaga|Stany Zjednoczone|rozmiar=100px}} |dół = Stopka |kategoria = Nazwa kategorii }}
Przykład podgrup
Relacje z innymi szablonami nawigacyjnymi
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
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 techniczne
- 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.
- Szczegóły techniczne można sprawdzić m.in. w plikach MediaWiki:Common.css i MediaWiki:Common.js.
Zawiłe drobiazgi
- Dwupikselowa ramka pomiędzy grupami i listami jest tworzona przez właściwość
border-left
komórki listy. Jeśli chcesz zmienić kolor tła szablonu (np.styl ogólny = background:purple;
), w tym samym kolorze ustaw kolor tej ramki (np.styl spisu = border-left-color:purple;
). Jeśli chcesz mieć ramkę wokół każdej listy, ta dwupikselowa ramka zniknie – aby ją zachować, pokombinuj trochę z kodem.
- Pierwotna szerokość list jest równa 100%. Jeśli chcesz ustawić ręcznie szerokość komórek grup, musisz też ustawić parametr
styl spisu
tak, aby zawierałwidth:auto
. Jeśli chcesz zmienić szerokość grupy oraz użyć obrazków, musisz odpowiednio poustawiać CSS w parametrachstyl opisu
,styl spisu
,styl grafiki
istyl grafiki lewej
. Przykład ustawienia szerokości grup:
styl opisu = width:10em;
styl spisu = width:auto;
- Sąsiadujące ze sobą navboksy mają pomiędzy sobą ramkę o szerokości 1px (poza IE6, który nie obsługuje odpowiedniego CSS). Jeśli ustawisz dolny lub górny margines w
styl
/styl ogólny
, to nie zadziała.
Błędy
Błędy należy zgłaszać na stronie Wikipedia:Kawiarenka/Kwestie techniczne.
Kolory w szablonach nawigacyjnych
Kolorowanie szablonów nawigacyjnych zostało wycofane po dyskusji w kawiarence.
Zobacz też
- Wikipedia:Szablony nawigacyjne - zalecenia edycyjne
- {{Szablon nawigacyjny}} – podstawowy szablon nawigacyjny
- {{Szablon nawigacyjny z kolumnami}} – pozwala na tworzenie kolumn zamiast grup/list
- – ostrożnie ze stosowaniem navboksu z kolumnami: nie twórz nawigacji, która nie zmieści się w mniejszych okienkach, np. 500 px
- {{Szablon nawigacyjny ze zwijanymi grupami}} – inna wersja
- {{Grupa szablonów}} – szablon do tworzenia szablonów nawigacyjnych zawierających grupy szablonów nawigacyjnych
- Kategoria:Szablony nawigacyjne – nieznane parametry (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 17 elementów)
- Kategoria:Szablony nawigacyjne – spisy do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 5209 elementów)
- Kategoria:Szablony nawigacyjne – spisy bez linków (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 15 elementów)
- Kategoria:Szablony nawigacyjne – tylko 1 link (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 32 elementów)
- Kategoria:Szablony nawigacyjne – tylko 2 linki (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 807 elementów)
- Kategoria:Szablony nawigacyjne – tylko 3 linki (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 1477 elementów)
- Kategoria:Szablony nawigacyjne – tylko 4 linki (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 1606 elementów)
- Kategoria:Szablony nawigacyjne – ponad 500 pozycji (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 21 elementów)
- Kategoria:Szablony nawigacyjne ze stylami (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 8 elementów)
- Kategoria:Szablony nawigacyjne ze złym parametrem nazwa (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 4 elementów)
Kategorie należy dodawać do podstrony /opis. Zobacz podstrony tego szablonu.