Pomoc:Tworzenie szablonów: Różnice pomiędzy wersjami
| [wersja nieprzejrzana] | [wersja przejrzana] |
Usunięta treść Dodana treść
USN->navbox |
m →Udokumentowanie szablonu: drobne redakcyjne |
||
| (Nie pokazano 48 wersji utworzonych przez 27 użytkowników) | |||
Linia 1:
{{ombox
| typ = zawartość
| grafika = {{ikona|pomczas|35}}
| grafika prawo =
| tekst = '''Niniejsza strona pomocy jest przestarzała i mało przydatna dla nowych uczestników'''<br /><small>Zawartość strony jest w znacznej części historyczna i jej praktyczna przydatność, zwłaszcza dla nowych, niedoświadczonych uczestników polskiej wikipedii jest znikoma. Strona wymaga stworzenia na nowo, z opisem tylko aktualnego stanu wiedzy wewnętrznej o omawianym przedmiocie, z naciskiem na stronę praktyczną, z przykładami. Po naprawie strony należy dany komunikat usunąć.<br> Data utworzenia komunikatu: 21:43, 27 lis 2013 (CET) </small>}}
== Tworzenie i edytowanie strony szablonu ==
Zazwyczaj komunikat, który ma się pojawić po zalinkowaniu w postaci szablonu powinien być zapisany w przestrzeni nazw Szablon:
{{osobny artykuł|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 '''<nowiki>{{Treść informacji tratata}}</nowiki>'''. 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 '''<nowiki>{{Jakaś nazwa 001}}</nowiki>''', 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 ;)
== 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 [[Specjalna:MyPage/brudnopis|własnym brudnopisie]] (nazwa podstrony oczywiście dowolna). Aby w pełni przetestować szablon wystarczy wkleić go na stronę dyskusji brudnopisu. Odpowiedni kod to:
{{[[Specjalna:Mypage/brudnopis|Wikipedysta:Nazwa użytkownika/brudnopis]]}}
Po przetestowaniu szablon można przenieść do [[
Warto jeszcze zwrócić uwagę, że wielkość liter w
=== 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ć {{s|
* 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
=== Kolorystyka i format szablonów ===
Linia 42 ⟶ 39:
== Korzystanie z komunikatów ==
===
Umiejscowienie szablonu zależy od jego rodzaju (patrz dział [[Wikipedia:Jak tworzyć szablony#Rodzaje szablonów|rodzaje szablonów]]):
* '''szablony informacyjne''' jak np. {{s|ujednoznacznienie}} 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 [[Pomoc:Interwiki|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.
=== Metody zamieszczania szablonów na stronach ===
Linki do komunikatów tworzy się według schematu:
<nowiki>{{metoda:nazwa komunikatu}}</nowiki>
Weźmy pod uwagę szablon {{s|aktualne}}
==== metoda prostego wstawienia szablonu ====
<nowiki>{{aktualne}}</nowiki> (najczęściej wykorzystywana ;)
<br />
{{
Ten sam efekt da <nowiki>{{msg:aktualne}}</nowiki> (ale praktycznie w Wikipedii nie wykorzystujemy tej formy)
==== metoda '''msgnw''' ====
<nowiki>{{msgnw:
<br />
wyświetli nam cały kod tego komunikatu,
<br />
{{msgnw:aktualne}}
==== metoda '''subst''' ====
<nowiki>{{subst:
<br />
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 <nowiki>{{aktualne}}</nowiki>, a przy tej - samą treść z szablonu.
{{Ambox
| typ = wiadomość
| grafika = [[Plik:Ambox currentevent.svg|30px]]
| tekst = '''{{#ifeq:{{{1|}}}|sekcja|Ta sekcja|Ten artykuł}} dotyczy [[Portal:Aktualności|trwającego wydarzenia]].''' Informacje w nim zamieszczone mogą się zmienić.
}}{{#if:{{NAMESPACE}}||[[Kategoria:Aktualne]]|}}
=== 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></nowiki>”</nowiki> – umożliwia to np. wstawianie fragmentów kodu, który normalnie byłby interpretowany przez mechanizm wiki.
== 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. <nowiki>{{:klucz}}</nowiki> wstawi do artykułu całą stronę o nazwie [[klucz]] znajdującą się w przestrzeni głównej.
Należy zauważyć, że stosując jedną z metod wstawiania szablonów, opisanych w pkt. 3.2, należy w tym przypadku użyć podwójnego dwukropka według schematu: <nowiki>{{metoda::dowolna strona}}</nowiki>, np. <nowiki>{{subst::klucz}}</nowiki> aby jedna z tych metod działała poprawnie z dowolną stroną nie należąca do przestrzeni nazw szablonów.
== 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.
{{osobny artykuł|Wikipedia:Szablony nawigacyjne}}
* '''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
{{osobny artykuł|Pomoc:Infoboks}}
* '''szablony w portalach''' to szablony utworzone na podstronie danego portalu w celu łatwiejszej aktualizacji danych. Są one umieszczone w [[Pomoc:Przestrzeń nazw|przestrzeni nazw]] ''Portal''
{{osobny artykuł|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.: {{s|test}}, {{s|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. {{s|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.
== Udokumentowanie szablonu ==
Należy w każdym szablonie umieścić jego opis (dokumentację własną), zawierający m.in. wykaz parametrów szablonu i spsób ich użycia. Chociaż jest technicznie możliwe umieszczenie opisu na stronie szablonu (czyli w jego kodzie), z użyciem odpowiednich konstrukcji parsera, to zdecydowanie poprawne jest umieszczenie opisu na specjalnej podstronie szablonu o nazwie ".../opis". Oczywiście podstronę taką można stworzyć samodzielnie, ale równie zdecydowanie zalecane jest użycie w tym celu specjalnego szablonu {{s|Dokumentacja}} poprzez umieszczenie (np. przy tworzeniu nowego szablonu) w kodzie szablonu, na jego końcu poniższej konstrukcji:
<pre><noinclude>{{Dokumentacja}}</noinclude></pre>
Szablon ten pozwala utworzyć podstronę dokumentacji z gotowym sformatowanym wg zwyczajów polskiej wikipedii kodem. M.in. kod ten zawiera prawidłowo urządzone miejsce na podanie kategorii opisywanego szablonu.
== Kategoryzacja szablonów ==
Każdy szablon musi mieć przypisaną kategorię, ale jej wskazanie wymaga zastosowania odpowiednich konstrukcji. Wyboru kategorii należy dokonać na podstawie analizy [[:Kategoria:Szablony|kategorii szablonów]].
Jawne wpisanie kategorii szablonu w jego kodzie (np. <nowiki>[[Kategoria:Szablony nawigacyjne]]</nowiki>) oczywiście umieści dany szablon we wskazanej kategorii, ale też wywoła, że również taką kategorię będą otrzymywały hasła, w których będzie on użyty (co oczywiście będzie błędnym propagowaniem tej kategorii). Ogólnie gdy podajemy kategorię szablonu w jego kodzie, to używany konstrukcji:
<pre><nowiki><noinclude>[[Kategoria:xxx]]</noinclude></nowiki></pre>
Należy jednak tego unikać i stosować podawanie kategorii w jego dokumentacji własnej, utworzonej ze sformatowanym wstępnie kodem poprzez szablon {{s|Dokumentacja}} (patrz wyżej). Ponadto jeśli dany szablon używa innego (wywołuje go), a ma on taką samą kategorię, to można w danym w ogóle nie wskazywać tej kategorii.
[[Kategoria:
| |||