Pomoc:Szablony: Różnice pomiędzy wersjami

Dodane 1056 bajtów ,  14 sie 2020
m
brak opisu edycji
(→‎Tworzenie szablonu: + Szablon dodający artykuł do kategorii, dodawanie szablonu do kategorii)
mNie podano opisu zmian
Linia 9: Linia 9:
Aby dodać swój szablon, musisz [[Pomoc:Tworzenie nowego artykułu|utworzyć artykuł]] z nazwą rozpoczynającą się od <code><nowiki>Szablon:</nowiki></code>, np. <code><nowiki>Szablon:Przykład 01</nowiki></code>
Aby dodać swój szablon, musisz [[Pomoc:Tworzenie nowego artykułu|utworzyć artykuł]] z nazwą rozpoczynającą się od <code><nowiki>Szablon:</nowiki></code>, np. <code><nowiki>Szablon:Przykład 01</nowiki></code>


Treść artykułu będzie zawartością szablonu, która zostanie wyświetlona na każdej stronie go przywołującą.
Zawartość szablonu umieszczamy między tagi <code><nowiki><onlyinclude></nowiki></code> lub <code><nowiki><includeonly></nowiki></code> — treść między tymi tagami zostanie wyświetlona na każdej stronie przywołującej szablon. Wszystko, co znajduje się poza tymi tagami nie zostanie dołączone do szablonu – może to być świetne miejsce na dokumentację szablonu na przykład.
 
Tag <code><nowiki><onlyinclude></nowiki></code> sprawia, że treści pomiędzy tymi tagami zostaną włączone do treści szablonu, a następnie wyświetlone na jego stronie. Tag <code><nowiki><includeonly></nowiki></code> funkcjonuje niemal identycznie, z tą drobną różnicą, że treść szablonu nie wyświetli się na stronie szablonu. Pozwala to na stworzenie dokumentacji i przykładu użycia bez widoku pustego szablonu z wartościami. Jest to także sposób na tworzenie [[Pomoc:Szablony#Szablon dodający artykuł do kategorii, dodawanie szablonu do kategorii|szablonu dodającego kategorię]]. Generalnie zaleca używać się zawsze <code><nowiki><includeonly></nowiki></code>, szczególnie w przypadku bardziej skomplikowanych szablonów, bądź gdy chcemy sporządzić dokumentację.
 
Poza tagami umieszcza się także odpowiednią kategorię – [[:Kategoria:Szablony|Szablony]], gdyż przyjęło się, że szablony mają swoją osobną kategorię.
 
=== Prosty tekst ===
=== Prosty tekst ===
'''Tworzenie i umieszczanie:'''<br>
'''Tworzenie i umieszczanie:'''<br>
Linia 18: Linia 23:
'''Rezultat:'''<br>
'''Rezultat:'''<br>
{{Przykład 01}}
{{Przykład 01}}
=== Tekst z parametrem ===
=== Tekst z parametrem ===
'''Tworzenie i umieszczanie:'''<br>
'''Tworzenie i umieszczanie:'''<br>
Linia 30: Linia 36:
'''Rezultat #2:'''<br>
'''Rezultat #2:'''<br>
{{Przykład 02|czekoladę}}
{{Przykład 02|czekoladę}}
=== Tekst niewyświetlany w szablonie ===
=== Tekst niewyświetlany w szablonie ===
Jeśli chcesz na stronie szablonu zawrzeć treści (np. instrukcję), które nie będą wyświetlanie przy umieszczaniu szablonu w tekście, dodaj je między znacznikami <code><nowiki><noinclude></nowiki></code> i <code><nowiki></noinclude></nowiki></code>.
Jeśli chcesz na stronie szablonu zawrzeć treści (np. instrukcję), które nie będą wyświetlanie przy umieszczaniu szablonu w tekście, dodaj je poza znacznikami <code><nowiki><includeonly></nowiki></code>.
 
=== Szablon dodający artykuł do kategorii, dodawanie szablonu do kategorii ===
=== Szablon dodający artykuł do kategorii, dodawanie szablonu do kategorii ===
Czasami chcemy, aby szablon automatycznie dodawał za nas artykuły do odpowiedniej kategorii. W tym miejscu poznasz sztuczkę, o którą oparte są [[Pomoc:Oznaczenia artykułów|oznaczenia artykułów]].
Czasami chcemy, aby szablon automatycznie dodawał za nas artykuły do odpowiedniej kategorii. W tym miejscu poznasz sztuczkę, o którą oparte są [[Pomoc:Oznaczenia artykułów|oznaczenia artykułów]].


Najprościej jest po prostu wpisać <code><nowiki>[[Kategoria:Nazwa kategorii]]</nowiki></code>. Wtedy wszędzie, gdzie użyjesz szablonu, artykuł zostanie przypisany do "Nazwa kategorii". Ale przy tym rozwiązaniu strona z szablonem również się w niej znajdzie. A to często nam nie pasuje.
Szablon tworzymy wówczas w oparciu o tagi <code><nowiki><includeonly></nowiki></code>. Sprawiają one, że treść szablonu nie jest widoczna na jego stronie, co zapobiega dodaniu strony szablonu do kategorii, którą szablon ten dodaje. Kategorię, którą nasz szablon ma dodawać umieszczamy więc między tagi <code><nowiki><includeonly></nowiki></code>, obok treści samego szablonu.
 
Aby obejść ten problem, w szablonie należy umieścić <code><nowiki>[[<noinclude>:</noinclude>Kategoria:Nazwa kategorii]]</nowiki></code>. Dzięki temu na stronie szablonu ten fragment będzie działał jak zwykły link do strony kategorii, a gdy umieścisz szablon w artykule - jako znacznik kategorii.


Z kolei jeśli chcesz dodać stronę szablonu do kategorii, ale tak, by artykuły używające szablonu nie były do niej dodawane, wystarczy użyć <code><nowiki><noinclude>[[Kategoria:Szablony]]</noinclude></nowiki></code>
Z kolei jeśli chcesz dodać stronę szablonu do kategorii [[:Kategoria:Szablony|Szablony]], ale tak, by artykuły używające szablonu nie były do niej dodawane, wystarczy umieścić <code><nowiki>[[Kategoria:Szablony]]</nowiki></code> poza tagami <code><nowiki><includeonly></nowiki></code>.


=== Zaawansowane ===
=== Zaawansowane ===
[https://www.mediawiki.org/wiki/Help:Templates Poradnik MediaWiki (ENG)]
* [https://www.mediawiki.org/wiki/Help:Templates Poradnik MediaWiki (ENG)]


== Wybrane szablony MW ==
== Wybrane szablony MW ==
=== +18 ===
=== +18 ===
<code><nowiki>{{18|Schowana treść}}</nowiki></code>
<code><nowiki>{{18|Schowana treść}}</nowiki></code>
Linia 66: Linia 71:
{{Oddzielny|Kenex Spam Center}}
{{Oddzielny|Kenex Spam Center}}


Jeśli chcemy, aby wyświetlała się inna nazwa, niż nazwa artykułu, należy przy umieszczaniu szablonu użyć <code><nowiki>{{!}}</nowiki></code>
Jeśli chcemy, aby wyświetlała się inna nazwa, niż nazwa artykułu, należy przy umieszczaniu szablonu użyć <code><nowiki>{{!}}</nowiki></code>.


<code><nowiki>{{Oddzielny|Nazwa artykułu{{!}}Nazwa wyświetlana}}</nowiki></code>
<code><nowiki>{{Oddzielny|Nazwa artykułu{{!}}Nazwa wyświetlana}}</nowiki></code>