Szablon:Szablon nawigacyjny

Z Wikipedii, wolnej encyklopedii
Przejdź do nawigacji Przejdź do wyszukiwania

[]

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ż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 prefiksu Szablon:. 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, gdzie auto 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. 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 wewnętrzny umieszczony po lewej na osobnym tle od wartości z spisn (jeżeli opisn jest opuszczony, spisn wyświetli się, rozpoczynając od lewej ramki szablonu nawigacyjnego).
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ó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ę 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 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}}
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ó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 elementu spisn. 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 parametr spis1. Każdy element spis jest wyświetlany w osobnym wierszu tabeli i może (ale nie musi) być poprzedzony nagłówkiem opisn.
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

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

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 (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.

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 parametrach styl opisu, styl spisu, styl grafiki i styl 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ż


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