„Wikipédia:Sablonok” változatai közötti eltérés
Tartalom törölve Tartalom hozzáadva
14. sor:
A sablonokat saját [[Wikipédia:Névtér|névterükben]], a <tt>Sablon:</tt> névtérben helyezzük el, de használhatunk sablonként bármelyik más névtérből származó lapokat is. Tartalmukat úgy lehet más lapokon (szócikkekben, közösségi lapokon, de akár más sablonokban) elhelyezni, hogy a nevüket kettős kapcsos zárójelek (<tt><nowiki>{{</nowiki></tt> és <tt>}}</tt>) közé írjuk. (A <tt>Sablon:</tt> névtérben elhelyezett sablonok névterét nem kell kiírni, tehát <tt><nowiki>{{sablon:valami}}</nowiki></tt> helyett elegendő <tt><nowiki>{{valami}}</nowiki></tt>-t írni.) Tartalmazhatnak ún. paramétereket, melyek segítségével változó szövegrészeket hozhatunk létre (például paraméter lehet egy város információit tároló sablonban a város neve vagy a lakók száma). Ezen paraméterek értékeit a sablon elhelyezésének helyén lehet (vagy kell) megadni.
== A sablonok használata ==
Sablonok tartalmát más lapokon a nevüket kapcsos zárójelek, azaz <tt><nowiki>{{</nowiki></tt> és <tt>}}</tt> közé (a <tt><nowiki>{</nowiki></tt>-et az {{billentyű|AltGr}}+{{billentyű|B}}-vel vagy {{billentyű|Alt}}+{{billentyű|123}}-mal, míg a <tt>}</tt>-et {{billentyű|AltGr}}+{{billentyű|M}}-mel vagy {{billentyű|Alt}}+{{billentyű|125}}-tel írhatsz, vagy kattints a szerkesztő-eszköztár [[Fájl:Button_plantilla.png|16px]] ikonjára) írva lehet elhelyezni:
{{Wikikód|wikikód=<nowiki>{{Sablonnév}}</nowiki>}}
Sablonként nem csak a <tt>Sablon:</tt> névtérben található lapok használhatóak, ilyen esetben a névteret is oda kell írni a név elé. (Pl. ha a <tt>Wikipédia:Szerkessz bátran!</tt> lapot szeretnéd elhelyezned, akkor a <tt><nowiki>{{Wikipédia:Szerkessz bátran!}}</nowiki></tt> szöveget kell beírnod, ha a szócikk névtérből illesztesz be lapot, akkor pedig a szócikk neve elé kell írni egy kettőspontot, azaz ha a <tt>StarCraft</tt> lap szövegét akarod elhelyezni, akkor a <tt><nowiki>{{:StarCraft}}</nowiki></tt> szöveget kell beírnod a lap szerkesztésekor.)
A sablonok nevei mindig nagybetűvel kezdődnek, és kis- és nagybetűérzékenyek, azaz míg az <tt><nowiki>{{azonnali}}</nowiki></tt> és az <tt><nowiki>{{Azonnali}}</nowiki></tt> ugyanarra a sablonra hivatkoznak (amennyiben az első betű kisbetű, automatikusan nagyra cserélődik), addig az <tt><nowiki>{{Azonnali}}</nowiki></tt> és az <tt><nowiki>{{AzOnNaLi}}</nowiki></tt> két különböző sablont jelent.
Az alábbi ábra betekintést nyújt, hogy a wikikódelemző-motor (ami a wikikódot HTML-kóddá alakítja, ennek megjelenítésére már a böngésző is képes), hogyan is végzi a sablonok behelyettesítését.
{{Kiemelt szöveg|szín=zöld|1=[[Fájl:A sablonok működése.png|550px|center]]
:'''1. lépés:''' a wikikód-elemző motor megkeresi a szövegben elhelyezett sablonokat, majd betölti azok tartalmát. (Esetünkben csak a <tt>Sablon:Teszt</tt>et)
:'''2. lépés:''' További feldolgozás után az így keletkező szöveget beilleszti a szócikk szövegébe. Ez a szöveg HTML-kóddá való alakítás után a lap megtekintésekor fog megjelenni, míg a szócikk forrásában ugyanúgy a wikikódú változat és a sablonhivatkozás marad meg.
}}
(Valójában a {{sl|Teszt}} sablon létezik, és egészen más a tartalma, ez csak egy elvi példa.) A fenti színes téglalapot is egy sablonnal hoztuk létre; ha érdekel a működése, ennek a szakasznak a forrásában megtekintheted.
=== Paraméteres sablonok ===
A sablonok tartalmazhatnak úgynevezett paramétereket. Ezek arra valók, hogy az egyébként fixen megadott sablonszövegbe olyan részeket rakjunk be, melyek tartalmát a sablont a használat helyén elhelyező szerkesztő adhatja meg.
Magában a sablon kódjában a paraméterek nevükkel három kapcsos zárójel közé rakva jelennek meg. Paraméter lehet névtelen vagy más néven számozott (azaz <tt><nowiki>{{{1}}}</nowiki></tt>, <tt><nowiki>{{{2}}}</nowiki></tt> stb.), vagy névvel ellátott (pl. <tt><nowiki>{{{kiadási év}}}</nowiki></tt>, <tt><nowiki>{{{népesség}}}</nowiki></tt> stb.).
Arról, hogy egy sablonnál milyen paraméterek használhatóak, és melyik paraméter milyen értéket vehet fel, az adott sablon leírólapján található sablondokumentációban olvashatsz. Vannak kötelező paraméterek, melyeket muszáj megadni, ha azt szeretnénk, hogy a sablon helyesen jelenjen meg. Az opcionális paraméterek általában olyan kiegészítő információkat tartalmaznak, melyek hiányában a sablon még mindig használható marad.
A sablon használatának helyén ezen paraméterek értékét nevük és egy egyenlőségjel írása után tudjuk megadni. Egymástól, és a sablon nevétől a pipe karakterrel (függőleges vonal: „|”, az {{billentyű|AltGr}}+{{billentyű|W}} vagy az {{billentyű|Alt}}+{{billentyű|124}} segítségével írható) választhatóak el:
{{Wikikód|wikikód=<nowiki>{{Sablon neve|paraméter1=értéke|paraméter2=értéke}}</nowiki>}}
Névtelen paraméterek esetén nem szükséges kiírni a számokat, az elsőként megadott szöveg az <tt><nowiki>{{{1}}}</nowiki></tt> értéke lesz, a második a <tt><nowiki>{{{2}}}</nowiki></tt>-é, és így tovább:
{{Wikikód|wikikód=<nowiki>{{Sablon neve|érték1|érték2}}</nowiki>}}
Akkor is elhagyható a névtelen paraméterek neve, ha a névtelen és a névvel ellátott paramétereket keverjük. Ilyenkor érdemes a névtelen paramétereket előre rakni, hogy más szerkesztők számára is áttekinthető maradjon a sablon. Amennyiben nem keverjük őket, a névtelen paraméterek az előfordulásuk sorrendjében kapnak értéket, továbbá a névvel ellátott paraméterek jelenléte nem befolyásolja őket:
{{Wikikód|wikikód=<nowiki>{{Sablon neve|érték1|tesztparaméter=valamilyen érték|érték2}}</nowiki>}}
A fenti példánál az <tt><nowiki>{{{1}}}</nowiki></tt> értéke „''érték1''”, míg a <tt><nowiki>{{{2}}}</nowiki></tt> értéke „''érték2''”, míg a <tt><nowiki>{{{tesztparaméter}}}</nowiki></tt> értéke „''valamilyen érték''” lesz.
Amennyiben a névtelen paramétereket nem az adott sorrendben szeretnénk megadni, vagy valamelyiket ki akarjuk hagyni, a paraméter számát kötelező megadni:
{{Wikikód|wikikód=<nowiki>{{Sablon neve|2=érték2|7=ez is valami}}</nowiki>}}
Akkor is kötelező megadni a névtelen paraméter számát, ha a paraméter értéke egyenlőségjelet (=) tartalmaz, mert ha nem ezt tennénk, akkor az egyenlőségjel előtti szöveg lenne a paraméter értéke, és az esetleges további paraméterek elcsúsznának:
:Hibás változat:
{{Wikikód|wikikód=<nowiki>{{Sablon neve|e=mc2|érték2}}</nowiki>}}
::Ennél a változatnál az <tt><nowiki>{{{e}}}</nowiki></tt> paraméter értéke „''mc2''”, míg az <tt><nowiki>{{{1}}}</nowiki></tt> értéke „''érték2''”
:Jó változat:
{{Wikikód|wikikód=<nowiki>{{Sablon neve|1=e=mc2|érték2}}</nowiki>}}
::Ennél a változatnál az <tt><nowiki>{{{1}}}</nowiki></tt> paraméter értéke „''e=mc2''”, míg a <tt><nowiki>{{{2}}}</nowiki></tt> értéke „''érték2''”
Az alábbi ábra betekintést nyújt, hogy a wikikódelemző motor (ami a wikikódot a böngésző által megjeleníthető HTML-kóddá alakítja) hogyan is végzi a paraméterek feldolgozását.
{{Kiemelt szöveg|szín=zöld|1=[[Fájl:A sablonparaméterezés működése.png|700px|center]]
:'''1. lépés:''' a wikikódelemző motor megkeresi a szövegben elhelyezett sablonokat, majd betölti azok tartalmát. (Esetünkben csak a <tt>Sablon:Teszt</tt>et.)
:'''2. lépés:''' ha a sablon rendelkezik paraméterekkel, és megadta azok értékeit a szerkesztő, akkor behelyettesíti azokat a sablon szövegébe (jelen esetben a kékkel jelölt <tt><nowiki>{{{népesség}}}</nowiki></tt>-et lecseréli a <tt>népesség=</tt> után megadott <tt>17575</tt>-re), majd további feldolgozás után az így keletkező szöveget beilleszti a szócikk szövegébe. Ez a szöveg HTML-kóddá való alakítása után a lap megtekintésekor fog megjelenni, míg a szócikk forrásában ugyanúgy a wikikódú változat és a sablonhivatkozás marad meg.
}}
=== Speciális használati módok ===
A sablonok két speciális használati móddal rendelkeznek.
====Szubsztolás====
Az első és a gyakrabban használt módszer az, mikor „beillesztjük” vagy „bemásoljuk” a sablon tartalmát. Ez azt jelenti, hogy a lap szerkesztésekor még a sablonra hivatkozunk, azonban miután elmentjük, már nem a sablonhivatkozás lesz a szócikk forrásában, hanem helyette a sablon tartalma kerül beillesztésre. Ez olyan sablonok esetében használható, melyek valamilyen váz kitöltésében vagy tartalom elhelyezésében segítenek (pl. a sorozatok egységes bevezetőjének megírásához használható {{sl|epizódbevezető}} sablon), vagy gyakran változó tartalommal rendelkeznek, és az elhelyezés helyén az elhelyezés pillanatában meglévő változatot szeretnénk megtartani (pl. üdvözlősablonok, figyelmeztetősablonok, blokkértesítésre szolgáló sablonok esetében). Sablon beillesztéséhez a sablonhivatkozás elhelyezésekor egyszerűen a sablon neve elé kell írni a „<tt>beilleszt:</tt>”, a „<tt>bemásol:”, vagy az angol „<tt>subst:</tt>” szöveget. Paraméterek ugyanúgy használhatóak itt is. Az alábbi módon működik:
{{Wikikód|wikikód=<nowiki>{{beilleszt:Sablon neve|paraméter1=érték1|paraméter2=érték2}}</nowiki>}}
A lap elmentése után ha legközelebb megnyitjuk szerkesztésre a lapot, már nem a <tt><nowiki>{{beilleszt:Sablon neve|paraméter1=érték1|paraméter2=érték2}}</nowiki></tt> szöveget láthatjuk a szócikk szövegében, hanem a beillesztett sablon (esetünkben a <tt>Sablon neve</tt> nevű sablon) tartalmát, a megadott paramétereknek megfelelően.
====Msgnw előtag====
A második, és igen ritkán használt módszer a sablon neve elé illesztett <tt>msgnw:</tt> előtag. Ekkor maga a sablon kódja fog megjelenni a lap ''megtekintésekor'', ugyanakkor a szócikk forrásában továbbra is az msgnw: előtaggal ellátott sablonhivatkozás marad (tehát nem cserélődik le a sablon tartalmára, mint a beillesztés esetén). A használata a következő:
{{Wikikód|wikikód=<nowiki>{{msgnw:Sablon neve|paraméter1=érték1|paraméter2=érték2}}</nowiki>}}
===Névtérválasztás===
Több oka is van, amiért a sablonjainkat célszerű a <tt>Sablon:</tt> névtérben elhelyezni, és ha nincs nyomós okunk másként tenni, akkor illik ehhez a szokáshoz tartanunk magunkat:
*Csak a sablonnévtérben levő sablonok beillesztésekor hagyható el a névtér a sablon nevéből.
*Csak a sablonnévtérben elhelyezett sablonok módosítása üríti ki az összes őket tartalmazó lapot a szerver [[gyorsítótár]]ából, biztosítva ezzel a percre kész megjelenésüket.
*A külön sablonnévtér használata áttekinthetővé teszi a Wikipédiát.
*A szócikknévtérhez hasonlóan ebben a névtérben is be van kapcsolva a [[Wikipédia:Jelölt lapváltozatok|lapváltozatok ellenőrzése]], így a sablonjaink bizonyos fokig védve vannak a vandalizmustól és kísérletezéstől.
Egy jellemző kivétel ez alól a szabály alól az allapok használata sablonként.
===Allapok használata sablonként===
Közösségi lapokon, vitalapokon szokás egyes témákat, megbeszéléseket, szavazásokat, illetve a tudnivalókat tartalmazó lapfejlécet sablonként beilleszteni [[Wikipédia:Allapok|allapokról]]. Ezáltal a főlap szerkesztéskor mindig áttekinthető marad, és az összetartozó lapokat is közös néven tarthatjuk, később pedig az archívumokban való turkálás nélkül is könnyen megtaláljuk. Gondoltad volna például, hogy a gyakran elburjánzó [[Wikipédia:Törlésre javasolt lapok]] vagy a [[Wikipédia:Javaslat tisztségviselők megválasztására]] lap valójában milyen rövid, ha megnyitjuk szerkesztésre?
Alkalmazására példa:
{{Wikikód|1=<nowiki>{{Wikipédia:Törlésre javasolt lapok/abcd}}</nowiki>}}
Figyelem! Ezt a módszert a szócikkeknél ''nem alkalmazzuk.''
==Sablontípusok==
| |||