Szablon:Sekcja referencyjna
Ten szablon wykorzystuje dość skomplikowane cechy mechanizmów MediaWiki. Nie zaleca się jego modyfikacji osobom niedoświadczonym. Osoba proponująca zmiany powinna być przygotowana do naprawienia wszelkich niepożądanych ubocznych efektów swoich działań. Eksperymenty należy prowadzić w brudnopisie. |
|
Opis szablonu
Jest to szablon linków inteligentnych (tzw. linki inteligentne), który koloruje linki w zależności do jakiej kategorii szablon zaliczy stronę wskazaną w nim. Zestaw możliwych kodów linkowych, znajduje się na stronie {{Link wewnętrzny}}, w miejscu pod tabelą nawigacyjną {{Tabela nawigacyjna}}, według jego wikikodu opisu.
Użycie
Szablon służy do użycia na stronach danych podręczników, z linkiem do strony do nagłówka rozdziału lub do samej strony, albo na stronach wersji do druku (stworzonej z artykułów tego podręcznika), o nazwie Wersja do druku
lub na stronach zbiorczych złożonych z artykułów, do linkowania, w niej, do nagłówków, gdzie w ich tekstach są załadowane artykuły.
Ogólne przedstawienie szablonu
{{Sekcja referencyjna|nazwa strony}}, {{Sekcja referencyjna|1=nazwa strony|3=nazwa podstrony}}, {{Sekcja referencyjna|nazwa strony|tytuł linku w tekście}} lub {{Sekcja referencyjna|nazwa strony|tytuł linku w tekście|nazwa podstrony}}
Szablon ten, gdy użyty na normalnej stronie, wstawia linka do strony (domyślnie rozdziału lub innego rodzaju sekcji, na którą jest podzielona książka). Używa się go podobnie jak zwykłego linka: [[nazwa strony|tytuł linku w tekście]].
Różnica pojawia się, gdy strona zawierająca ten szablon zostanie dołączona do strony, która ma w tytule "Wersja do druku". Wtedy szablon ten, zamiast tworzyć linka do strony, tworzy odnośnik do sekcji na tej samej stronie.
Dlaczego ten szablon
Szablon został stworzony do używania w spisach treści, oraz wewnątrz zwyczajnych stron książki jako odnośnik do sekcji (rozdziału/podrozdziału/itp.) Ideą tego szablonu było rozwiązanie pewnego problemu pojawiającego się, gdy strona zostanie wydrukowana w formie PDF-a. Normalnie, gdy spis treści zawiera linki do rozdziałów tworzonych normalnym sposobem (przez wikilinki), to w wydrukowanej formie te linki zostają odnośnikami bezwzględnymi do strony Wikibooks. Gdy użytkownik kliknie w taki link w PDF-ie, to zostanie przekierowany do przeglądarki WWW z otwartą stroną Wikibooks. Psuje to użytkowanie takiej strony, gdyż użytkownik zazwyczaj zakłada, że gdy kliknie na odnośnik w spisie treści, to ten przeniesie go na odpowiednią stronę wewnątrz PDF-a.
Ten szablon rozwiązuje ten problem, przez warunkową zamianę linków do stron sekcji w linki lokalne do sekcji wewnątrz strony do druku. W niektórych generatorach PDF-a taka zamiana skutkuje tym, że takie linki umieszczone w spisach treści, powodują przeniesienie do odpowiedniej strony, a nie przeskok do strony WWW (pozostałe generatory po prostu nie generują linków w ogóle).
Opis parametrów
- Pełne wywołanie
{{Sekcja referencyjna|[1|strona]
=|[2|nazwa]
=|[3|podstrona]
=|[4|ustęp]
=}}
- Parametry
1
lubstrona
- jest to artykuł w podręczniku, ewentualnie z nagłówkiem,2
lubnazwa
- nazwa linku wyświetlana w artykule,3
lubpodstrona
- podstrona dodawana do linku podczas rozważać, wtedy artykuł, będzie o jeden lub wyżej, głębiej w drzewie danej przestrzeni nazw,4
lubustęp
- jeśli przyjmuje wartość niepustą, to nazwa wyświetlana linku jest jego nagłówek, jeżeli istnieje, lub jego podstrona albo sama strona, w przypadku przestrzeni nazw (główna) i Wikijunior oraz nibyprzestrzeni nazw Wikibooks:Brudnopis, w przestrzeni nazw Wikibooks, a także przestrzeni użytkownika Wikipedysta, a w przypadku nie podania nazwy stronystrona
lub1
, to parametrustęp
zachowuje się odwrotnie, wtedy nazwę strony, do której linkuje szablon, przyjmujemy domyślnie, że jest to nazwa książki, w przestrzeniach nazw w dwóch pierwszych nie widać różnicy działania tego parametru, już jest różnica w nibyprzestrzeniach nazw dwóch ostatnich, tutaj ten szablon podaje subnazwę książki, a nie jego adres, gdzie przy| ustęp = tak
podaje cały adres,od małej
- jeśli niepuste, wyświetlany jest link od małej litery,od dużej
- jeśli niepuste, wyświetlany jest link od dużej litery,pod-ustęp
- na stronach zbiorczych skraca nazwę nagłówka, która na stronie artykułów podręcznika byłaby nazwą strony, do substrony.
Szablon posiada też parametry: | bez znaczników = tak
i | bez przetwarzania = tak
, które kolejno znaczą, że bez obramowania znacznikowego span
kolorujące link, i bez głębszego, na siłę, przetwarzania linkowego.
Przykłady
- Możliwe poniższe warianty przykładów tego szablonu symbolizują na czym on polega, jak się powinno go używać. Działanie na odpowiednich stronach jest zasymulowane za pomocą parametrów pudełek.
- Podstawowe użycie
- Wikikod: {{Sekcja referencyjna|strona=Historia}} → [[Onomastyka/Historia|Historia]] → Historia.
- Wikikod: {{Sekcja referencyjna|strona=Alfabet grecki|podstrona=Wstęp}} → [[Matematyka dla liceum/Wstęp/Alfabet grecki|Alfabet grecki]] → Alfabet grecki.
- Wikikod: {{Sekcja referencyjna|strona=Historia|nazwa=Historia matematyki}} → [[Onomastyka/Historia|Historia matematyki]] → Historia matematyki.
- Wikikod: {{Sekcja referencyjna|strona=Alfabet grecki|nazwa=Alfabet grecki|podstrona=Wstęp}} → [[Matematyka dla liceum/Wstęp/Alfabet grecki|Alfabet grecki]] → Alfabet grecki.
- Wikikod: {{Sekcja referencyjna|strona=Historia#Historia onomastyki}} → [[Onomastyka/Historia#Historia onomastyki|Historia#Historia onomastyki]] → Historia#Historia onomastyki.
- Wikikod: {{Sekcja referencyjna|strona=Historia#Historia onomastyki|ustęp=tak}} → [[Onomastyka/Historia#Historia onomastyki|Historia onomastyki]] → Historia onomastyki.
- Wikikod: {{Sekcja referencyjna|strona=#Historia onomastyki|podstrona=Historia}} → [[Onomastyka/Historia#Historia onomastyki|Historia onomastyki]] → Historia onomastyki.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory}} → [[Matematyka dla liceum/Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak}} → [[Matematyka dla liceum/Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Przykłady
od małej
iod dużej
- Wikikod: {{Sekcja referencyjna|strona=Historia|od małej=tak}} → [[Onomastyka/Historia|historia]] → historia.
- Wikikod: {{Sekcja referencyjna|strona=Historia|nazwa=historia|od dużej=tak}} → [[Onomastyka/Historia|Historia]] → Historia.
- Dla stron o subnazwie Wersja do druku dla przykładu dla strony Matematyka dla liceum/Wersja do druku
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory}} → [[#Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|pod-ustęp=tak}} → [[#Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|ustęp=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|ustęp=tak|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Dla stron o subnazwie poszczególnych rozdziałów, tu mamy Matematyka dla liceum/Zaczynamy, a jego subnazwa (jednocześnie rozdział) Zaczynamy
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory}} → [[#Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|pod-ustęp=tak}} → [[#Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|podstrona=Zaczynamy|ustęp=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|ustęp=tak|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Dla stron o subnazwie równej nazwie książki, tu mamy Matematyka dla liceum/Matematyka dla liceum, a jego subnazwa (jednocześnie strona zbiorcza) Matematyka dla liceum
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory}} → [[#Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|pod-ustęp=tak}} → [[#Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zaczynamy/Zbiory|ustęp=tak|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|ustęp=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|ustęp=tak|pod-ustęp=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
- Dla stron brudnopisu projektu Wikibooks:Brudnopis lub stron w przestrzeni nazw Wikipedysta, dla przykładu dla artykułu Wikibooks:Brudnopis/Karol Karolus/Ulice miasta Lublina/Litera Ż
- Wikikod: {{Sekcja referencyjna}} → [[Wikibooks:Brudnopis/Karol Karolus/Ulice miasta Lublina|Ulice miasta Lublina]] → Ulice miasta Lublina.
- Wikikod: {{Sekcja referencyjna|ustęp=tak}} → [[Wikibooks:Brudnopis/Karol Karolus/Ulice miasta Lublina|Brudnopis/Karol Karolus/Ulice miasta Lublina]] → Brudnopis/Karol Karolus/Ulice miasta Lublina.
Błędy
Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.
Parametry szablonu (strukturyzacja Wizualnego Edytora)
Szablon służy do użycia na stronach danych podręczników, z linkiem do strony do nagłówka rozdziału lub do samej strony, albo na stronach wersji do druku (stworzonej z artykułów tego podręcznika), o nazwie "Wersja do druku", do linkowania, w niej, do nagłówków, gdzie w ich tekstach są załadowane artykuły.
Parametr | Opis | Typ | Status | |
---|---|---|---|---|
strona | strona 1 | Nazwa strony, ewentualnie z nagłówkiem. | Nazwa strony | sugerowany |
nazwa | nazwa 2 | Nazwa wyświetlana linku. | Ciąg znaków | sugerowany |
podstrona | podstrona 3 | Podstrona podręcznika, do której ma zaliczyć, do linku, artykuł. | Ciąg znaków | opcjonalny |
ustęp | ustęp 4 | Jeśli niepuste, gdy ma wyświetlić nagłówek strony lub podstronę. | Ciąg znaków | opcjonalny |
Zobacz też
- Ogólne szablony linków inteligentnych, kolorujących linki, w zależności do jakiej kategorii one należą, w tym celu wykorzystuje projekt Wikidane
- {{LinkOgólne}} - najogólniejszy szablon linków, budulec innych szablonów linków, w tym również {{LinkUstęp}}, i pośrednio innych podobnych tego typu,
- {{LinkOgólne2}} - jest to szablon linków, oparty o szablon {{LinkOgólne}}, wyświetla link, przy niepodanym drugim parametrze, z nazwą przestrzeni nazw strony,
- {{Link wewnętrzny}} - szablon służy do budowania linków inteligentnych, szablon nie ma parametru nazwy przestrzeni nazw, w przeciwieństwie do {{LinkOgólne}},
- {{LinkURL}} - szablon tworzy, pełny adres URL, na podstawie użytych parametrów.
- Szablony wydobywające linki z wikitekstu
- {{WydobądźLinki}} - wydobywa linki wewnętrzne i zewnętrzne, jeżeli występują.
Powyższy opis jest dołączany ze strony Szablon:Sekcja referencyjna/opis. (edytuj | historia)
Kategorie należy dodawać do podstrony /opis. Zobacz podstrony tego szablonu. |