„Segítség:Sablondokumentáció” változatai közötti eltérés

Tartalom törölve Tartalom hozzáadva
KeFe (vitalap | szerkesztései)
Nincs szerkesztési összefoglaló
KeFe (vitalap | szerkesztései)
10. sor:
* '''Kapcsolódó sablonok''': ha a sablon több, együtt használandó vagy hasonló funkciójú sablon egyike, mindig linkelj a többi sablonra, hogy megkönnyítsd a navigációt. Ha elég sok sablonról van szó, érdemes külön navigációs sablont csinálni erre a feladatra. (Lásd például az angol [[:en:Template:Protection templates|Protection templates]] sablont.) A sablonok megadásához érdemes az {{sl|sl}} sablont használni.
 
== Hogyan írj dokumentációtSablon információt? ==
Az egyszerűbb megoldás, ha simán beírod a dokumentációSablon információ szövegét, a kategóriákat és az interwikilinkeket a sablon végén elhelyezett <tt><nowiki><noinclude>...</noinclude></nowiki></tt> blokkba, hogy csak a sablon saját lapján jelenjen meg, a sablon használatakor ne. (Ügyelj rá, hogy a <tt><nowiki><noinclude></nowiki></tt> ne új sorban kezdődjön, hanem az utolsó nem üres sor végén! Máskülönben a sablon használatakor több üres hely lesz utána, mint szeretnéd.) Ha a sablon a saját lapján csúnyán jelenik meg (például mert nincsenek megadva a paraméterek, amik a megjelenését szabályozzák), beleteheted a kódját egy <tt><nowiki><includeonly>...</includeonly></nowiki></tt> blokkba (de a dokumentációtSablon információt nem!), hogy csak beillesztéskor jelenjen meg, a sablon saját lapján ne.
 
A bonyolultabb megoldás a dokumentációsSablon információs allap használata, ilyenkor a dokumentációSablon információ a ''Sablon:Sablonneve/inf'' lapról lesz beillesztve. Ennek számos előnye van:
* mind a sablon, mind a dokumentációSablon információ szövege áttekinthetőbb lesz;
* nem áll fenn a veszélye, hogy a dokumentációSablon információ átírása közben véletlenül elrontja valaki a sablont;
* a dokumentációSablon információ akkor is szerkeszthető, ha a sablon le van védve;
* a dokumentációSablon információ nem növeli a sablont (ami nem lehet tetszőlegesen nagy – lásd [[:en:Wikipedia:Template limits]]);
* a MediaWiki fordítójának nem kell a dokumentációSablon információ minden egyes változtatásakor ellenőriznie, hogy a sablon változott-e.
 
Hátránya viszont, hogy a sablonokat tartalmazó kategóriák könnyen elavulttá válhatnak, mert a dokumentációsSablon információs lapon végrehajtott változtatások csak akkor jelennek meg a kategórialapokon, ha a dokumentálandó sablont is megváltoztatja valaki.
 
DokumentációsSablon információs allap használatához a sablon végére a <tt><nowiki><noinclude>{{sablondokumentáció}}</noinclude></nowiki></tt> szöveget írd be. (Ilyenkor is ügyelj rá, hogy a <tt><nowiki><noinclude></nowiki></tt> ne új sorban kezdődjön!)

A sablon elmentése után megjelenő doboz "szerkeszt"{{gomb1|{{bszín|[Sablondok. infó]|#006000}} }} gombjára kattintva olvashatod a Sablon információk készítését, {{gomb1|{{bszín|[Sablon szerkesztés]|#006000}} }} {{gomb1|{{bszín|[Infó szerkesztés]|#006000}} }} gombjára kattintva, szerkesztheted a dokumentációssablont, vagy a információs allapot.

Az interwikilinkeket és kategóriákat ilyenkor a dokumentációsSablon információs allap végén egy <tt><nowiki><includeonly>...</includeonly></nowiki></tt> blokkba zárd, hogy csak a sablonra vonatkozzanak, az allapra ne.
 
== Példa ==