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

m
brak opisu edycji
mNie podano opisu zmian
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>


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.
Zawartość szablonu umieszczamy między tagi <code><nowiki><includeonly><onlyinclude></nowiki></code> i <code><nowiki></onlyinclude></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ę.
Tag <code><nowiki><onlyinclude></nowiki></code> sprawia, że ''wyłącznie'' 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> sprawia, ż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 obu tagów <code><nowiki><includeonly><onlyinclude></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ę.
Poza tagami umieszcza się także odpowiednią kategorię – [[:Kategoria:Szablony|Szablony]], gdyż przyjęło się, że szablony mają swoją osobną kategorię.
Linia 38: Linia 38:


=== 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 poza znacznikami <code><nowiki><includeonly></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><onlyinclude></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]].


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.
Szablon tworzymy wówczas w oparciu o oba tagi <code><nowiki><includeonly><onlyinclude></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, obok treści samego szablonu.


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>.
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><onlyinclude></nowiki></code>.


=== Zaawansowane ===
=== Zaawansowane ===