Szablon:Szablon nawigacyjny/opis
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, gdzieautopozostawia 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 parametrugrafika).
góra– opcjonalny tekst do wyświetlenia nadpisaniem i z wycentrowaniem, na osobnym tle, nad zawartością ponumerowanych parametrówopisczyspis(np. sekwencja wikilinków).
opisn– nagłówek wewnętrzny umieszczony po lewej na osobnym tle od wartości zspisn(jeżeliopisnjest opuszczony,spisnwyświetli się, rozpoczynając od lewej ramki szablonu nawigacyjnego).spisn– tekst wymieniający wikilinki, generalnie w formacie wypunktowanej wikilistydół– opcjonalny tekst, jakgóraomó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ąautozostanie 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śćautoustawia 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ętepowoduje, ż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ętepowoduje, ż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łepowoduje, ż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łączonepowoduje, ż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łelubwyłą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ętewewną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
zwijaniez 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,opis2itd.) 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,spisnzajmie całą szerokość wiersza tabeli.
spisn*- (np.
spis1,spis2itd.) 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 elementspisjest 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. Parametrgrafikamoż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
spis1oraz nie wpisywać parametrówopisn. Parametrgrafika lewamoż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órazachowuje się podobnie jak parametrspis1bez 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 parametrspisnbez 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. Ustawienieparzystelubnieparzystepowoduje, że wszystkie wiersze mają ten sam kolor tła, odpowiednio domyślny dla parzystych i nieparzystych wierszy. Ustawienie wartościbrakwyłą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
classwygenerowanego szablonu nawigacyjnego. Zbiór dopuszczalnych wartości obejmuje:ll-scriptwłącza automatyczne skryptyll-script-dl-hlistwskazuje automatyczny skrypt do wykonania MediaWiki:Gadget-ll-script-dl-hlist.jskz-liniawłącza obsługę szablonów {{KZ-linia}}nav-teamszmienia formatowanie wybranych szablonów drużyn sportowychhnowrap-ul-ulzmienia formatowanie w specyficznych sytuacjachmedaliścikoloruje nagłówki pólopis1,opis2iopis3na złoto, srebro i brąz.hwrapzezwala na łamanie linii w treści elementu listypionowywłą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-leftkomó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 spisutak, 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 grafikiistyl 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 • 0 elementów)
Kategoria:Szablony nawigacyjne – spisy do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne – spisy bez linków (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne – tylko 1 link (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne – tylko 2 linki (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne – tylko 3 linki (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 1 elementów)
Kategoria:Szablony nawigacyjne – tylko 4 linki (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne – ponad 500 pozycji (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne ze stylami (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
Kategoria:Szablony nawigacyjne ze złym parametrem nazwa (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)
- Opisy szablonów
- Szablony nawigacyjne – spisy bez linków
- Szablony nawigacyjne – wikikod do sprawdzenia
- Szablony nawigacyjne – spis bez linków
- Szablony nawigacyjne – nieprawidłowe parametry
- Szablony nawigacyjne
- Szablony nawigacyjne – spisy podejrzane
- Szablony nawigacyjne – nieopisane spisy
- Szablony nawigacyjne – spisy do sprawdzenia