Szablon:Link

Dokumentacja

Ten opis jest dołączany ze strony Szablon:Link/opis. (edytuj | historia)

Użycie

Szablon {{Link}} jest elementem infrastruktury WikiStylów. Stanowi jednak jego specjalny składnik, który w przeciwieństwie do innych szablonów, ma zadanie techniczne, nie zaś wizualne. Jego celem jest tworzenie linków wewnętrznych pomiędzy dokumentami w sposób analogiczny do szablonu {{LinkRel}} i {{LinkRelKsiążkaZeStrukturą}} ukrywając jednocześnie przed użytkownikiem, wewnątrz definicji stylu, niektóre ze stałych parametrów, takich jak lista rozdziałów. Szablon umożliwia budowanie linków na stronach całościowych kolejnych poziomów struktury książki, przy założeniu, że w tekście wpisywane są konsekwentnie kotwice wykorzystujące ten sam system oznaczania struktury.

Opis parametrów

1. tytuł docelowej strony (bez bazowej części nazwy) (parametr obowiązkowy)
2. etykieta (opcjonalna, wymagana)
3. początek kotwicy (np. oznaczający tom)
4. kolejna część kotwicy (np. oznaczająca rozdział)
5. kolejna część kotwicy (np. oznaczająca podrozdział lub tabelkę w rozdziale)
6. kolejna część kotwicy (np. ustęp lub ilustrację w podrozdziale)
7. kolejna część kotwicy ....

Pierwszy z parametrów zwykle jest tytułem strony najniższego poziomu w strukturze książki, czyli np. pojedynczy wiersz w tomiku, przepis kulinarny, hasło słownikowe. Nie jest to jednak konieczne. W sytuacji gdy jakiś odsyłacz mówi "zobacz niżej torty", które są umieszczone jako niewydzielona grupa przepisów w rozdziale "Ciasta", to w pierwszym parametrze wskazujemy tytuł strony zawierającej cały rozdział, natomiast w kotwicach wskazujemy pierwszy przepis z grupy tortów. Takie rozwiązanie przy skoku z innych miejsc książki zawsze wypozycjonuje rozdział lub stronę całości na właściwej, wydzielonej logicznie grupie tekstów. Praktyczny przykład takiego linku w tekście „Baby wyborne domowe“.

Przykład

Załóżmy, że mamy książkę "Książka kucharska"

Wersja minimum

Wikikod {{Link|Wstęp}} spowoduje:

• utworzenie na jakiejkolwiek innej niż "całość" stronie tej książki kod:
  [[Książka kucharska/Wstęp#Wstęp|Wstęp]]jest to link do innej strony html lub link wewnętrzny gdy użyty na stronie "Książka kucharska/Wstęp"
• utworzenie na stronie "całość" tej książki kod:
  [[Książka kucharska/całość#Wstęp|Wstęp]]jest to link wewnętrzny w ramach tej samej strony

Ta wersja jest odpowiednikiem wstawienia zwykłego wikilinku bez etykiety: [[Wstęp]].

Wersja bez podawania kotwic

Wikikod {{Link|Wstęp|we wstępie}} spowoduje:

• utworzenie na jakiejkolwiek innej niż "całość" stronie tej książki kod:
  [[Książka kucharska/Wstęp#Wstęp|we wstępie]]jest to link do innej strony html lub link wewnętrzny gdy użyty na stronie "Książka kucharska/Wstęp"
• utworzenie na stronie "całość" tej książki kod:
  [[Książka kucharska/całość#Wstęp|we wstępie]]jest to link wewnętrzny w ramach tej samej strony

Ta wersja jest odpowiednikiem wstawienia zwykłego wikilinku z etykietą: [[Wstęp|we wstępie]].

Wersja rozbudowana

Przyjmijmy, że wewnątrz wymienionej wyżej książki mamy rozdział XXXV "Zupy warzywne", w którym

• jest przepis nr 13 "Zupa ze szczawiem"
• jest przepis nr 15 "Zupa z kalafiora" ze zdaniem "robi się tak jak zupę nr 13"

oraz rozdział XXVII "Pieczywa", w którym

• jest przepis "Grzanki na sposób angielski" ze zdaniem "świetne do zupy ze szczawiu"

W takiej sytuacji dla przepisu nr 15, będziemy mieć:

• wikikod wewnątrz przepisu nr 15:
  {{Link|Zupa ze szczawiem|robi się tak jak zupę nr 13|XXXV|13}}
• wygenerowany kod na stronie "Książka kucharska/Zupa z kalafiora":
  [[Książka kucharska/Zupa ze szczawiem#XXXV13|robi się tak jak zupę nr 13]]jest to link do innej strony html
• wygenerowany kod na stronie "Książka kucharska/Zupy warzywne":
  [[Książka kucharska/Zupy warzywne#XXXV13|robi się tak jak zupę nr 13]]jest to link wewnętrzny w ramach tej samej strony
• wygenerowany kod na stronie "Książka kucharska/całość":
  [[Książka kucharska/całość#XXXV13|robi się tak jak zupę nr 13]]jest to link wewnętrzny w ramach tej samej strony

Natomiast dla przepisu o grzankach będziemy mieć:

• wikikod:
  {{Link|Zupa ze szczawiem|świetne do zupy ze szczawiu|XXXV|13}}
• wygenerowany kod na stronie "Książka kucharska/Grzanki na sposób angielski":
  [[Książka kucharska/Zupa ze szczawiem#XXXV13|świetne do zupy ze szczawiu]]jest to link do innej strony html
• wygenerowany kod na stronie "Książka kucharska/Pieczywa":
  [[Książka kucharska/Zupa ze szczawiem#XXXV13|świetne do zupy ze szczawiu]]jest to link do innej strony html
• wygenerowany kod na stronie "Książka kucharska/całość":
  [[Książka kucharska/całość#XXXV13|świetne do zupy ze szczawiu]]jest to link wewnętrzny w ramach tej samej strony

Zobacz też