Przejdź do zawartości

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

(→‎Tworzenie szablonu: + W skrócie)
Linia 15: Linia 15:


== Tworzenie szablonu ==
== Tworzenie szablonu ==
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>
{{Objaśnienie streszczenie
|W skrócie
| Strona szablonu musi mieć prefix Szablon np. <code>Szablon:Przykład 01</code>
 
<br>
 
Gotowe wnętrze szablonu z dokumentacją i widoczną zawartością:<br>
<pre>
Dokumentacja


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.
<onlyinclude>
Zawartość szablonu
</onlyinclude>


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ę]]. W przypadku prostszych szablonów wystarczy samo <code><nowiki><onlyinclude></nowiki></code> – sprawi to, że treść szablonu zostanie umieszczona na stronie szablonu. 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ę.
[[Kategoria:Szablony]]
</pre>


Poza tagami umieszcza się także odpowiednią kategorię – [[:Kategoria:Szablony|Szablony]], gdyż przyjęło się, że szablony mają swoją osobną kategorię.
<br>


Podsumowując, standardowa strona szablonu będzie wyglądać mniej więcej tak:
Gotowe wnętrze szablonu z dokumentacją i ukrytą zawartością:<br>
<code><poem><nowiki>Dokumentacja szablonu
<pre><nowiki>Dokumentacja


<includeonly><onlyinclude>
<includeonly><onlyinclude>
Zawartość szablonu
Zawartość szablonu
</onlyinclude></includeonly>
</onlyinclude></includeonly>


[[Kategoria:Szablony]]
[[Kategoria:Szablony]]
</nowiki></poem></code>
</nowiki></pre>
 
}}
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><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 ''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ę]]. W przypadku prostszych szablonów wystarczy samo <code><nowiki><onlyinclude></nowiki></code> – sprawi to, że treść szablonu zostanie umieszczona na stronie szablonu. 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ę.


=== Prosty tekst ===
=== Prosty tekst ===