Szablon:Sekcja referencyjna

Z Wikibooks, biblioteki wolnych podręczników.
Przejdź do nawigacji Przejdź do wyszukiwania
Template-info.png Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

Użycie[edytuj]

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.

Ogólne przedstawienie szablonu[edytuj]

{{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[edytuj]

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[edytuj]

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.

Przykłady[edytuj]

Możliwe poniższe warianty przykładów tego szablonu symbolizują na czym on polega, jak się powinno go używać.

Błędy[edytuj]

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

Parametry szablonu (strukturyzacja Wizualnego Edytora)[edytuj]

Szablon służy do linkowania na stronie danego podręcznika, wewnątrz niej, szablon koloruje linki (jest to szablon inteligentny), który zaznaczył jako odnośnik.

Parametry 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ż[edytuj]

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}},
  • {{LinkPełnyURL}} - 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ą.