„Wikipédia:Sablonok” változatai közötti eltérés

Tartalom törölve Tartalom hozzáadva
pontosítás, TemplateData a Wikipédia:Sablondokumentáció lapra
Grga (vitalap | szerkesztései)
Nincs szerkesztési összefoglaló
11. sor:
 
A sablonok további előnye, hogy bonyolult, összetett elemeket helyezhetünk el velük a szócikkekben és más lapokon, miközben a wikikód egyszerű és könnyen áttekinthető marad.
 
Sablonokat elvileg a hagyományos módon, '''„Forrásszöveg szerkesztése” nézetben''' és az újabb '''„Vizuális szerkesztő” módban''' is be tudunk illeszteni. Gyakorlatban „Vizuális szerkesztőmódban” sok sablonhoz még nincs megírva a megfelelő kiegészítő kódolás, ezeket hiába ajánlja fel a „Vizuális szerkesztőmód” menürendszer, csak „Forrásszöveg szerkesztése” nézetben beszúrhatók. Egy-egy konkrét sablon leíró lapján is nagy valószínűséggel csak a „Forrásszöveg szerkesztése” mód leírását fogjuk találni.
 
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. Amikor sablonokat használunk (beillesztünk), egy speciális kódot kell használni. A vizuális szerkesztőben ([[Wikipédia:VisualEditor|VisualEditor]]) egyszerűen a ''Beszúrás'' → ''{{nowrap|[[Fájl:VisualEditor - Icon - Template-big.svg|16px]] Sablon}}'' menüpontot kell választani és beírni a sablon nevét, a program automatikusan generálja a kódot. A hagyományos szerkesztőben („Forrásszöveg szerkesztése”) a nevüket kettős kapcsos zárójelek (<tt><nowiki>{{</nowiki></tt>&nbsp;és&nbsp;<tt>}}</tt>) közé kell írni. (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.
 
 
== Segítségkérés sablonokkal kapcsolatban ==
18 ⟶ 21 sor:
 
== A sablonok használata ==
Sablonokat be lehet illeszteni a vizuális„Vizuális szerkesztővelszerkesztővel” és a hagyományos felületen („Forrásszöveg szerkesztése” nézetben) is. Az előbbi használata általában egyszerűbb és kényelmesebb, azonban speciális dokumentációtkódolást igényel, ami sok sablonnak nincs (ha hiányzik, írhatsz a Sablonműhely vitalapjára). Sablonokat általában a Sablon névtérből illesztünk be, de bármely lap használható sablonként, ekkor a lap névterét is be kell írni, szócikkeknél ezt <code>:</code> helyettesíti.
 
<small>A gyakorlatban a legtöbb sablont még akkor írták, amikor csak „Forrásszöveg szerkesztése” mód létezett. „Forrásszöveg szerkesztése” nézetben tehát bármely sablon szerkeszthető, az újabb „Vizuális szerkesztőmódban” viszont csak azok a sablonok, amelyhez valaki már megírta a megfelelő kiegészítő kódolást. Figyelem: A „Vizuális szerkesztőmód” > „Beszúrás” menüje minden, már létező sablont felajánl beszúrásra, de a Vizuális szerkesztőmódra megfelelően nem kódolt sablonok esetén csak egy használhatatlan kódot fog beszúrni. Ezek a sablonok csak „Forrásszöveg szerkesztése” nézetben szerkeszthetők. Az ilyen Sablonok dokumentációjában bárki hozzáértő szerkesztő elhelyezheti a szükséges <templatedata> szakaszt, és onnantól az a sablon is „Vizuális szerkesztőmódban” is szerkeszthetővé válik.</small>
 
Sablonokat általában a Sablon névtérből illesztünk be, de bármely lap használható sablonként, ekkor a lap névterét is be kell írni, szócikkeknél ezt <code>:</code> helyettesíti.
 
 
=== Sablonok használata „Vizuális szerkesztőmódban” ===
=== Vizuális szerkesztő ===
A ''Beszúrás'' → ''{{nowrap|[[Fájl:VisualEditor - Icon - Template-big.svg|16px]] Sablon}}'' menüpontban szúrhatók be. A megjelenő panelon be kell írni a sablon nevét (ügyelj arra, hogy ne a <tt>/doc</tt> végűt válaszd, az a dokumentáció). Utána meg lehet adni az esetleges paramétereket – a megfelelő dokumentációval rendelkező sablonoknál a program tudja a lehetséges paramétereket, esetleg fel is kínál néhányat (a csillaggal megjelöltek kötelezőek, nélkülük nem ad értelmes eredményt a sablon), a többi paramétert a ''{{int:visualeditor-dialog-transclusion-add-param}}'' gombbal lehet használni.
Ha nincs a sablonnak ilyen dokumentációja, akkor is beszúrható, viszont a paraméterneveket neked kell kihámoznod az egyéb dokumentációból. Ekkor a sablon nevének kiválasztásáig a folyamat ugyanaz, ekkor viszont, miután rákattintottál a ''{{int:visualeditor-dialog-transclusion-add-param}}'' gombra, és még mindig nincs semmilyen választható paraméter, a panel felső részén lévő üzenetben ''({{int:visualeditor-dialog-transclusion-no-template-description}})'' található linkre kattintva nyílik meg (új fülön) a sablon lapja, ahol megtalálható a leírás. Ha nem jelenik meg ez a szöveg, az azt jelenti, hogy a sablonnak van speciális dokumentációja, viszont nincs benne semmilyen változó szöveg (paraméter). Amennyiben található a sablon lapján paraméter, ami szükséges az adott helyzetben, akkor az a panel alján lévő (a ''{{int:visualeditor-dialog-transclusion-add-param}}'' gombra kattintva megjelenő) keresőmezőbe a paraméter pontos nevét beírva szúrható be, gépelés közben a szoftver felajánlja az aktuálisan a keresőmezőben lévő paraméternevet, erre kell (a paraméternév beírása után) rákattintani. Ezt követően ugyanúgy beírható a paraméter értéke, mint ha alapból ismerte volna a program. Ezután már csak a ''{{int:visualeditor-dialog-action-insert}}'' gombra kell kattintani a tényleges beillesztéshez.
 
Sablonok szerkesztéséhez ki kell jelölni az adott sablont (kattintással), majd a ''{{int:visualeditor-contextitemwidget-label-secondary}}'' gombra kattintani (vagy duplán rákattintani a sablonra). Ekkor a sablon kiválasztása értelemszerűen elmarad, a paraméterek hozzáadása pedig a fenti módon történik. A paraméterek el is távolíthatóak a paraméter kijelölése után a név mellett jobb oldalon megjelenő piros kukával (néhány esetben az üres paraméternek más hatása lehet, mint az eltávolítottnak).
 
=== Sablonok használata „Forrásszöveg szerkesztése” módban ===
=== Hagyományos szerkesztő ===
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ű|N}}-nel 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>}}