Pomoc:Tworzenie szablonów

Szablony umożliwiają wstawianie często powtarzających się fragmentów artykułów w formie jednego, krótkiego linku (zapisywanego w postaci '''{{xxx}}''', a nie jak tradycyjny link '''[[xxx]]'''), który automatycznie „dopisuje” ten fragment do treści artykułu w momencie jego wczytywania do przeglądarki lub (w drugim wariancie) w momencie zapisywania tekstu artykułu.

[edytuj] Tworzenie i edytowanie strony szablonu

Zazwyczaj komunikat, który ma się pojawić po zalinkowaniu w postaci szablonu powinien być zapisany w przestrzeni nazw Szablon:

 Osobna strona: Wikipedia:Przestrzeń nazw.

Co to znaczy? Aby używać szablonowych komunikatów na stronach, tworzymy najpierw treść szablonu na stronie Szablon:Treść informacji tratata. Gdy mamy taką stronę utworzoną, wówczas możemy ją wstawić na stronie w postaci {{Treść informacji tratata}}. Wyświetli się wówczas ta treść, jaką wpisaliśmy na stronę Szablon:Treść informacji tratata. Proste? :)

Żeby edytować szablon, trzeba wejść na jego stronę, czyli jeśli na stronie zauważymy w kodzie coś takiego {{Jakaś nazwa 001}}, to kopiujemy tę nazwę i wpisujemy w wyszukiwarkę Szablon:Jakaś nazwa 001. W przypadku bardziej złożonych szablonów, o których niżej, to może być nieco bardziej skomplikowane ;)

[edytuj] Testowanie szablonów

Na początku należy zastanowić się, czy szablon jest na pewno potrzebny i zastanowić się nad odpowiednią nazwą dla niego. Szablony o podobnym zastosowaniu powinny mieć generalnie podobną nazwę, bo to ułatwia ich znalezienie.

Podobnie jak w przypadku artykułów nowy szablon najlepiej najpierw stworzyć we własnym brudnopisie (nazwa podstrony oczywiście dowolna). Aby w pełni przetestować szablon wystarczy wkleić go na stronę dyskusji brudnopisu. Odpowiedni kod to:

{{Wikipedysta:Nazwa użytkownika/brudnopis}}

Po przetestowaniu szablon można przenieść do przestrzeni nazw Szablon, korzystając z odpowiedniej zakładki, tj. zakładki „przenieś”. Warto też dodać instrukcję dla użytkowników na stronie dyskusji szablonu. Powinny się w niej znaleźć informacje o zastosowaniu szablonu (jeśli nie jest oczywiste) i opis parametrów (jeśli szablon takie posiada).

Warto jeszcze zwrócić uwagę, że wielkość liter w nazwie jest ważna, to znaczy szablon o nazwie "AbCd" nie jest tożsamy z szablonem o nazwie „Abcd”.

[edytuj] Wielkość szablonów

Wielkość szablonu powinna być dostosowana do jego funkcji.

• Dla szablonów nawigacyjnych optymalną szerokością jest cała szerokość strony. Do tego celu najlepiej wykorzystać {{Navbox}}.
• Dla infoboksów szerokość powinna wynosić 250 pikseli lub – gdy to nie wystarcza – 300 pikseli.

Wielkość pozostałych szablonów nie jest dokładnie ustalona, zależy ona od funkcji jaką pełni dany szablon.

[edytuj] Kolorystyka i format szablonów

Należy wystrzegać się stosowania w szablonach kolorów, które utrudniają czytanie oraz kontrastują z ogółem strony (żółty, czerwony, niebieski).

Optymalne kolory dla szablonu to odcienie szarego oraz kolory pastelowe, np. fiolet. Dla tekstu najlepiej zostawić kolor czarny.

[edytuj] Korzystanie z komunikatów

[edytuj] Umieszczanie szablonów na stronie

Umiejscowienie szablonu zależy od jego rodzaju (patrz dział rodzaje szablonów):

• szablony informacyjne jak np. {{disambig}} umieszcza się na samej górze artykułu, tzn. w pierwszej linijce
• infoboksy umieszcza się pod nimi, także przed treścią
• szablony nawigacyjne umieścić należy na końcu strony, tzn. pod linkami zewnętrznymi, a jednocześnie przed kategoriami i interwiki

Należy pamiętać, aby nie umieszczać na jednej stronie zbyt wielu szablonów oraz by się one nie dublowały. Zalecane jest, aby na stronie znajdował się tylko jeden infobox.

Liczba szablonów nawigacyjnych nie jest określona. Najlepiej, gdy jest ich maksymalnie kilka. Należy także uważać, aby szablon oparty na komunikacie {{Navbox}} nie dublował się z szablonem {{Poprzednik Następca}}.

[edytuj] Metody zamieszczania szablonów na stronach

Linki do komunikatów tworzy się wg schematu:

{{metoda:nazwa komunikatu}}

Weźmy pod uwagę szablon {{aktualne}}

[edytuj] metoda prostego wstawienia szablonu

{{aktualne}} (najczęściej wykorzystywana ;)

Ten artykuł dotyczy niedawnego lub trwającego wydarzenia. Informacje w nim zamieszczone mogą się zmienić lub zdezaktualizować.

Ten sam efekt da {{msg:aktualne}} (ale praktycznie w Wikipedii nie wykorzystujemy tej formy)

[edytuj] metoda msgnw

{{msgnw:aktualne}}
wyświetli nam cały kod tego komunikatu, tak, jak byśmy uniemożliwili działanie linków, tagów itd.: (w wikipedii raczej nie wykorzystywana)

{{Ambox | typ = wiadomość | grafika = {{#if:{{{link|}}}|[[Plik:Wikinews-logo.svg|40px]]|[[Plik:Ambox currentevent.svg|40px]]}} | tekst = '''{{#ifeq:{{{1|}}}|sekcja|Ta sekcja|Ten artykuł}} dotyczy [[Portal:Aktualności|niedawnego lub trwającego wydarzenia]].''' Informacje w {{#ifeq:{{{1|}}}|sekcja|niej|nim}} zamieszczone mogą się zmienić lub zdezaktualizować.<br />{{#if:{{{link|}}}|'''Odwiedź [[n:|Wikinews]]''', serwis informacyjny, siostrzany projekt [[Wikimedia Foundation|Fundacji Wikimedia]].}} }}{{#if:{{NAMESPACE}}||[[Kategoria:Aktualne]]|}}<noinclude> {{Dokumentacja}} </noinclude>

[edytuj] metoda subst

{{subst:aktualne}}
Użycie tej metody spowoduje, że kod szablonu zostanie zastąpiony jego treścią (efekt można zobaczyć, np. edytując tę stronę). Mimo, że treść poniżej wygląda identycznie jak przy pierwszej metodzie, to jednak po zapisaniu strony i ponownym edytowaniu przy pierwszej metodzie znajdziemy w kodzie {{aktualne}}, a przy tej - samą treść z szablonu.

Ten artykuł dotyczy niedawnego lub trwającego wydarzenia. Informacje w nim zamieszczone mogą się zmienić.

[edytuj] Jeszcze raz, żeby łatwiej było odróżnić :)

• metoda subst – powoduje jednokrotne wpisanie tekstu komunikatu do kodu artykułu w momencie zapisywania artykułu po edycji.
  • w wyniku tej metody tekst komunikatu "łączy się" z resztą artykułu zaś sam link do komunikatu niejako „znika” z kodu artykułu, więc w rezultacie powstaje jednolity tekst, składający się z tekstu wpisanego „ręcznie” oraz wklejonego linkiem komunikatu
  • korzystanie z metody subst powoduje, że przy zmianie źródłowego tekstu komunikatu, tekst wstawiony do artykułu tą metodą nie ulega zmianom.
• metoda msg (addycja) – powoduje wyświetlanie aktualnego tekstu komunikatu przy każdym wczytaniu tekstu artykułu zawierającego w kodzie link do tego komunikatu.
  • w wyniku tej metody link pozostaje na stałe w kodzie artykułu i jest „podstawiany” tekstem źródłowym komunikatu przy każdym wczytaniu artykułu do przeglądarki
  • korzystanie z metody msg powoduje, że przy zmianie tekstu źródłowego komunikatu, zmienia się automatycznie wyświetlany tekst wszystkich artykułów, w których ten komunikat został użyty
• metoda msgnw – technicznie jest to praktycznie to samo co metoda msg, z wyjątkiem tego, że cały tekst komunikatu zostaje automatycznie umieszczony między znacznikami „<nowiki></nowiki>” – umożliwia to np. wstawianie fragmentów kodu, który normalnie byłby interpretowany przez mechanizm wiki.

[edytuj] Dowolna strona jako szablon

Za szablon może też posłużyć dowolna strona nie należąca do przestrzeni nazw szablonów. Aby wstawić tekst ze strony nie będącej w przestrzeni nazw szablonów należy najpierw podać nazwę tej przestrzeni, dwukropek i nazwę strony (dla głównej przestrzeni należy dodać tylko dwukropek na początku nazwy), np. {{:klucz}} wstawi do artykułu całą stronę o nazwie klucz znajdującą się w przestrzeni głównej.

[edytuj] Rodzaje szablonów

Można rozróżnić kilka rodzajów szablonów

• szablony nawigacyjne to rodzaj szablonów mający za zadanie ułatwienie użytkownikowi poruszania się pomiędzy artykułami na ten sam temat. Przeważnie szablon nawigacyjny ma postać niewielkiej tabeli zawierającej linki do artykułów.

• infoboksy to szablony specjalnego typu. Tworzy się je najczęściej przy użyciu szablonów warunkowych (specjalnych). Infoboksy posiadają parametry, które modyfikują ich wygląd i zawartość. Więcej na stronie

 Osobna strona: Pomoc:Infoboks.

• szablony w portalach to szablony utworzone na podstronie danego portalu w celu łatwiejszej aktualizacji danych. Są one umieszczone w przestrzeni nazw Portal

 Osobna strona: Wikipedia:Tworzenie wikiportali.

• szablony informacyjne/ostrzegawcze to szablony, które nie są częścią treści artykułu, ale np. informują o tym, aby wstawić linki, dopracować artykuł, czy go usunąć. Czasami szablony informacyjne wstawiane są na strony wikipedystów czy do innych przestrzeni nazw – np.: {{test}}, {{witaj}}

 Zobacz też: Wikipedia:Szablony.

• szablony warunkowe/specjalne – szablony warunkowe to szablony używane w innych szablonach, np. w infoboksach lub w szablonach informacyjnych. Istnieje tez szereg szablonów specjalnych, czasami także wykorzystujących szablony warunkowe, jak np. {{lang}}

• oprócz powyższych przykładów można użyć jako szablonu dowolnej strony z przestrzeni Wikipedia, Wikipedysta, MediaWiki, Pomoc oraz strony dyskusji.

[edytuj] Kategoryzacja szablonów

(opracować)