Przejdź do zawartości

Szablon:Sekcja referencyjna

Z Wikibooks, biblioteki wolnych podręczników.
 Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

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 lub strona - jest to artykuł w podręczniku, ewentualnie z nagłówkiem,
  • 2 lub nazwa - nazwa linku wyświetlana w artykule,
  • 3 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 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 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 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



Przykłady od małej i od dużej




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







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=Zbiory|podstrona=Zaczynamy}} → [[#Zaczynamy/Zbiory|Zbiory]] → Zbiory.
  • Wikikod: {{Sekcja referencyjna|strona=Zbiory|podstrona=Zaczynamy|podstrona=Zaczynamy|ustęp=tak}} → [[#Zaczynamy/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







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 Ż

Błędy

Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.

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]

ParametrOpisTypStatus
stronastrona 1

Nazwa strony, ewentualnie z nagłówkiem.

Nazwa stronysugerowany
nazwanazwa 2

Nazwa wyświetlana linku.

Ciąg znakówsugerowany
podstronapodstrona 3

Podstrona podręcznika, do której ma zaliczyć, do linku, artykuł.

Ciąg znakówopcjonalny
ustępustęp 4

Jeśli niepuste, gdy ma wyświetlić nagłówek strony lub podstronę.

Ciąg znakówopcjonalny

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