Wikibooks

Szablon:Sekcja referencyjna/opis

< Szablon:Sekcja referencyjna
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.
p • d • e • U
Szablony stronicowe
Wzory
MathML
Grafika
  • {{Rysunek}}
    • Punkty
  • {{ZobaczTeż}}
  • {{Patrz}}
    • Ważne
    Ogólne
    Szablon linkówSzablon wypowiedzenia
    Linki
    Wypowiedzenie
    Szczególne
    LinkiWypowiedzenia
    Twierdzenie
    Hipotezy
    Lemat
    Kryterium
    Dowód
    Postulat
    Postulaty
    Definicje
    Zadanie
    Ćwiczenia
    Procedura
    Schemat
    Twierdzenie
    Hipoteza
    Lemat
  • {{Lemat}}
    • Kryterium
    Dowód
  • {{Dowód}}
    • Postulat
    Postulaty
    Definicja
    Zadanie
  • {{Zadanie}}
    • Ćwiczenie
    Procedura
    Schemat
  • {{Schemat}}
    • Szablony okienek i do ich uchwytów specjalistyczne linki
    L-Nagłówki
    Wykazy
    W tekście
    Pomiędzy
  • {{Tekst}}
    • Nagłówki
    Autonawigacja
    Spis treści
  • {{SpisTreści}} (spis rozdziałów artykułu)
  • {{TOC}}
  • {{TOCRamka}}
  • {{TOC limit}}
  • {{Spis treści}}
    • Nawigacja
    L-Nawigacja
    Artykuły
    Numerowanie
    Linie
    Nazwy
    Autorskie
    Zawartości
    Linki
  • {{Sekcja referencyjna}} (spis artykułów)
  • {{StopkaSpisTreści}}
    • Książkowe
  • {{Wolumin}}
  • {{LinkWolumin}}
  • {{StronaWolumin}}
  • {{T}}
  • {{T2}}
  • {{Q}}
  • {{N}}
  • {{A}}
  • {{Status}}
  • {{Kompletność}}
  • {{Kompletność junior}}
  • {{Książka}}
    • Indeksowanie
  • {{Kotwica}}
  • {{Indeksuj}}
    • Spis artykułów

    Opis szablonu

    edytuj

    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

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

    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, 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

    edytuj
    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

    edytuj

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

    Parametry szablonu (strukturyzacja Wizualnego Edytora)

    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, 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ż

    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}},
    • {{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ą.
    p • d • e • U
    Szablony linków do obiektów, stron i indeksowanych punktów w niej
     
    Szablony linków oparte o linki wewnętrzne lub z opcją odwołania się do serwisów zewnętrznych
    Szablony do ustępu (rozdziału)
    Szablony linków ogólne
    {{LinkOgólne}} • {{LinkOgólne2}} • {{Link wewnętrzny}} • {{Sekcja referencyjna}} • {{LinkURL}}
    Szablon nawigacyjny zbiera zbiory linków linkowania do obiektów szablonów stronicowych, i szablony linków do różnych przestrzeni nazw, stron i punktów w nich, zbudowanych w oparciu o normalne linki wewnętrzne.


    Źródło: „https://pl.wikibooks.org/w/index.php?title=Szablon:Sekcja_referencyjna/opis&oldid=475712”