Szablon:Sekcja referencyjna/opis

To jest podstrona dokumentacji dla szablonu {{Sekcja referencyjna}}.
Zawiera ona informacje na temat sposobu użycia, kategoryzacji szablonu i inną zawartość niebędącą częścią oryginalnej strony.

Opis szablonu

Jest to specjalistyczny szablon linków inteligetnych (tzw. linki inteligetne), a link do jego stylów mieści się w szablonie kodów linków inteligentnych z kodami na stronie {{Link wewnętrzny}}, który się znajduje pod tabelą wywołania szablonowego {{Tabela nawigacyjna}}, a w jego parametrze, tam są też linkujące do tej samej strony, czyli do szablonu kaskadowych arkuszy stylów CSS, które są od nadawawia barwy linkom, mające kolory odpowiednie dla nich, a właściwe wartości kodów znajdują się w znaczniku szablonowym {{Span}} obok tych odpowiednich elementów. Szablon koloruje linki w zależności do jakiej kategorii on należy, wskazanych przez te kody a do tego celu używa Wikidane.

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

{{sr|nazwa strony}}, {{sr|1=nazwa strony|3=nazwa podstrony}}, {{sr|nazwa strony|tytuł linku w tekście}} lub {{sr|nazwa strony|tytuł linku w tekście|nazwa podstrony}}

{{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 skrótowe wywołanie

{{sr|[1|s]=|[2|n]=|[3|p]=|[4|u]=|[t]=}}

{{sr|[1|s]=|[2|n]=|[b]=tak|[4|u]=|[t]=}}

Pełne wywołanie

{{Sekcja referencyjna|[1|strona]=|[2|nazwa]=|[3|podstrona]=|[4|ustęp]=|[pod-ustęp]=}}

{{Sekcja referencyjna|[1|strona]=|[2|nazwa]=|[bieżąca]=tak|[4|ustęp]=|[pod-ustęp]=}}

Parametry

1, s lub strona - jest to artykuł w podręczniku, ewentualnie z nagłówkiem,
2, n lub nazwa - nazwa linku wyświetlana w artykule,
3, p lub podstrona - podstrona dodawana do linku podczas rozważać, wtedy artykuł, będzie o jeden lub wyżej, głębiej w drzewie danej przestrzeni nazw,
4. u lub ustę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 strony strona (lub jego skrót: s) lub 1, to parametr ustę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 (lub jego synonim numerowany: | 4 = tak) (lub jego skrót: | u = tak) podaje cały adres,
m, od małej - jeśli niepuste, wyświetlany jest link od małej litery,
d, od dużej - jeśli niepuste, wyświetlany jest link od dużej litery,
t, pod-ustęp - na stronach zbiorczych skraca nazwę nagłówka, która na stronie artykułów podręcznika byłaby nazwą strony, do substrony,
b, bieżąca - jeśli zmienna: podstrona, lub jego koledzy nie są podane, wtedy adres książki jest liczony względem bieżącej.

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: {{sr|s=Historia}} → [[Onomastyka/Historia|Historia]] → Historia.
Wikikod: {{sr|s=Alfabet grecki|p=Wstęp}} → [[Matematyka dla liceum/Wstęp/Alfabet grecki|Alfabet grecki]] → Alfabet grecki.
Wikikod: {{sr|s=Historia|n=Historia matematyki}} → [[Onomastyka/Historia|Historia matematyki]] → Historia matematyki.
Wikikod: {{sr|s=Alfabet grecki|n=Alfabet grecki|p=Wstęp}} → [[Matematyka dla liceum/Wstęp/Alfabet grecki|Alfabet grecki]] → Alfabet grecki.
Wikikod: {{sr|s=Historia#Historia onomastyki}} → [[Onomastyka/Historia#Historia onomastyki|Historia#Historia onomastyki]] → Historia#Historia onomastyki.
Wikikod: {{sr|s=Historia#Historia onomastyki|u=tak}} → [[Onomastyka/Historia#Historia onomastyki|Historia onomastyki]] → Historia onomastyki.
Wikikod: {{sr|s=#Historia onomastyki|p=Historia}} → [[Onomastyka/Historia#Historia onomastyki|Historia onomastyki]] → Historia onomastyki.
Wikikod: {{sr|s=Zaczynamy/Zbiory}} → [[Matematyka dla liceum/Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak}} → [[Matematyka dla liceum/Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Przykłady m i d

Wikikod: {{sr|s=Historia|m=tak}} → [[Onomastyka/Historia|historia]] → historia.
Wikikod: {{sr|s=Historia|n=historia|d=tak}} → [[Onomastyka/Historia|Historia]] → Historia.

Dla stron o subnazwie Wersja do druku dla przykładu dla strony Matematyka dla liceum/Wersja do druku

Wikikod: {{sr|s=Zaczynamy/Zbiory}} → [[#Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zaczynamy/Zbiory|t=tak}} → [[#Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zbiory|p=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
Wikikod: {{sr|s=Zbiory|p=Zaczynamy|u=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zbiory|p=Zaczynamy|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
Wikikod: {{sr|s=Zbiory|p=Zaczynamy|u=tak|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.

Dla stron o subnazwie poszczególnych rozdziałów, tu mamy Matematyka dla liceum/Zaczynamy, a jego substrona (jednocześnie rozdział) Zaczynamy

Wikikod: {{sr|s=Zaczynamy/Zbiory}} → [[#Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zaczynamy/Zbiory|t=tak}} → [[#Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zbiory|p=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
Wikikod: {{sr|s=Zbiory|p=Zaczynamy|p=Zaczynamy|u=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zbiory|p=Zaczynamy|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
Wikikod: {{sr|s=Zbiory|p=Zaczynamy|u=tak|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.

Dla stron o subnazwie równej nazwie książki, tu mamy Matematyka dla liceum/Matematyka dla liceum, a jego substrona (jednocześnie s zbiorcza) Matematyka dla liceum

Wikikod: {{sr|s=Zaczynamy/Zbiory}} → [[#Zaczynamy/Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zaczynamy/Zbiory|t=tak}} → [[#Zbiory|Zaczynamy/Zbiory]] → Zaczynamy/Zbiory.
Wikikod: {{sr|s=Zaczynamy/Zbiory|u=tak|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zbiory|p=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
Wikikod: {{sr|s=Zbiory|p=Zaczynamy|u=tak}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.

Wikikod: {{sr|s=Zbiory|p=Zaczynamy|t=tak}} → [[#Zbiory|Zbiory]] → Zbiory.
Wikikod: {{sr|s=Zbiory|p=Zaczynamy|u=tak|t=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: {{sr}} → [[Wikibooks:Brudnopis/Karol Karolus/Ulice miasta Lublina|Ulice miasta Lublina]] → Ulice miasta Lublina.
Wikikod: {{sr|u=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.

Parametry szablonu[Zarządzaj danymi szablonu]
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ż

Zwykłe szablony linków

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}} (skrót: {{lo}}) - najogólniejszy szablon linków, budulec innych szablonów linków, w tym również {{LinkUstęp}} (skrót: {{lu}}), i pośrednio innych podobnych tego typu,
{{LinkOgólne2}} (skrót: {{lo2}}) - jest to szablon linków, oparty o szablon {{LinkOgólne}} (skrót: {{lo}}), wyświetla link, przy niepodanym drugim parametrze, z nazwą przestrzeni nazw strony,
{{Link wewnętrzny}} (skrót: {{ly}}) - szablon służy do budowania linków inteligentnych, szablon nie ma parametru nazwy przestrzeni nazw, w przeciwieństwie do {{LinkOgólne}} (skrót: {{lo}}),
{{Sekcja referencyjna}} (skrót: {{sr}})- szablon sekcji podręczników, używana w ramach jednej książki, szablon na substronie: Wersja do druku lub równej subnazwie książki, albo na rozdziałowych stronach zbiorczych, wyświetla tylko linki manewrowania po całej tej stronie, a wewnątrz podręcznika, pomiędzy jego artykułami,
{{LinkURL}} (skrót: {{lz}}) - szablon tworzy, pełny adres URL, na podstawie użytych parametrów.

Szablony ustępu

Szablony ogólne linków do ustępu

{{LinkUstęp}} (skrót: {{lu}}) - szablon ogólny, budulec do tworzenia innych szablonów do ustępu na danej stronie.

Szablony linków, do ustępu, wewnętrznych, z opcją do odwołania się do serwisów siostrzanych lub wersji językowych, polskiego Wikibooks

{{LinkGłównaUstęp}} (skrót: {{lgu}}), {{LinkWikijuniorUstęp}} (skrót: {{lju}}), {{LinkSzablonUstęp}} (skrót: {{lsu}}), {{LinkModułUstęp}} (skrót: {{ldu}}), {{LinkPomocUstęp}} (skrót: {{lpu}}), {{LinkProjektUstęp}} (skrót: {{lru}}), {{LinkKategoriaUstęp}} (skrót: {{lku}}), {{LinkUżytkownikUstęp}} (skrót: {{lżu}}) i {{LinkSpecjalnaUstęp}} (skrót: {{lcu}}) - szablony linku do stron, do ustępu, w przestrzeni nazw kolejno: (główna), Wikijunior, Szablon, Pomoc, Wikibooks, Kategoria, Wikipedysta i Specjalna, domyślnie na polskim Wikibooksie.

Szablony odwołujące się do do stron, do ustępu, serwisu: polskiej Wikipedii, projektu siostrzanego polskiego Wikibooks

{{LinkPediaGłównaUstęp}} (skrót: {{lpgu}}), {{LinkPediaSzablonUstęp}} (skrót: {{lpsu}}), {{LinkPediaPomocUstęp}} (skrót: {{lppu}}) i {{LinkPediaProjektUstęp}} (skrót: {{lpru}}) - szablony linku do stron, do ustępu, w przestrzeni nazw kolejno: (główna), Szablon, Pomoc i Wikipedia, na polskiej Wikipedii.

Czyste bezznacznikowe linki uzyskane z podanego wikitekstu

Szablony wydobywające linki

{{WydobądźLinki}} - wydobywa linki wewnętrzne i zewnętrzne, jeżeli występują.

Inne

Kategorie skojarzone z szablonem:

Szablon zgłasza błędy parametrów w kategorii: Kategoria:Szablon sekcja referencyjna do sprawdzenia (Liczba stron: 0).