Wikipédia

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

Laptörténet interaktív böngészése
← Régebbi szerkesztésÚjabb szerkesztés →
Tartalom törölve Tartalom hozzáadva
VizuálisWikiszöveges
Grga (vitalap | szerkesztései)
1 108 szerkesztés
Nincs szerkesztési összefoglaló
pontosítás, TemplateData a Wikipédia:Sablondokumentáció lapra
12. 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.
 
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. TartalmukatAmikor úgysablonokat lehet más lapokonhasználunk (szócikkekbenbeillesztünk), közösségiegy lapokon,speciális dekódot akárkell máshasználni. sablonokbanA vizuális szerkesztőben ([[Wikipédia:VisualEditor|VisualEditor]]) elhelyezniegyszerű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, hogya 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é írjukkell í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 Sablonokkalsablonokkal kapcsolatban ==▼
A sablonokat elvileg '''„Forrásszöveg szerkesztése” nézetben''' és '''„Vizuális szerkesztőmódban”''' is be tudunk szúrni, gyakorlatban a viszonylag új „Vizuális szerkesztőmódban” sok sablonhoz nincs megírva a megfelelő háttérkódolás, ezeket hiába ajánja 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.
 
▲== Segítségkérés Sablonokkal kapcsolatban ==
Sablonokkal kapcsolatban segítséget a [[Wikipédia-vita:Sablonműhely|Sablonműhely vitalapján]] kérhetsz.
 
== A sablonok használata ==
Sablonokat be lehet illeszteni a vizuális szerkesztővel és a hagyományos felületen is. Az előbbi használata általában egyszerűbb és kényelmesebb, azonban speciális dokumentációt 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.
Sablonokat elvileg „Forrásszöveg szerkesztése” nézetben és „Vizuális szerkesztőmódban” is be tudunk szúrni. 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ő háttérkó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 háttérkó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.
 
=== Vizuális szerkesztő ===
== A sablonok használata „Vizuális szerkesztőmódban” ==
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.
Beszúrás menüben beírjuk a kívánt Sablon nevét, és kiválasztjuk.
 
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).
=== Sablon használhatóvá tétele „Vizuális szerkesztőmódban” (Sablonszerkesztők számára!)===
A legtöbb sablont eredetileg „Forrásszöveg szerkesztése” módra írták meg. A Vizuális Szerkesztő csak akkor tudja kezelni a paramétereket, ha bekerül egy <templatedata> szakasz a sablon TemplateData-dokumentációjába. Ez Vizuális módban is behelyezhető.
Vegyünk egy példát:
Beszúrsz egy sablont (pl. „Szövegdoboz”) a Vizuális Szerkesztő módban, de egy {{{1}}} szöveget látsz megjelenni a szerkesztés alatt álló szócikkedben. Ez azt jelenti, hogy ott az 1. névtelen paraméternek kell megjelennie, amit – ha nincs TemplateData az adott sablonhoz – úgy adhatsz hozzá, hogy a sablonszerkesztő ablakban a További információ hozzáadása linkre kattintva megjelenő keresőmezőbe beírod a paraméter nevét: 1, és lenyomod az entert – vagy rákattintasz a keresőmező alatt a paraméterre –, majd egyszerűen beírod a szöveget. Ahol van neve a paraméternek – pl. float –, ott azt kell beírni.)
 
=== Hagyományos szerkesztő ===
Ha Te nem tudod elvégezni, a Sablonműhely vitalapján kérheted.
 
== A sablonok használata „Forrásszöveg szerkesztése” módban ==
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>}}
 
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 elhelyezni, 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.
186 ⟶ 177 sor:
 
=== Sablondokumentáció és kategorizálás ===
Készíts az új sablonhoz dokumentációt! Ez azért nagyon fontos, hogy mindenki pontosan láthassa, mire és hogyan használható egy adott sablon. A sablondokumentáció leírja a sablon célját, a használat módját, és mintát is közöl a sablonról, illetve egy szócikkbe másolható mintát is mutat. Ez különösen a paraméteres sablonok esetében nagyon hasznos, mivel megkönnyíti azok gyors bemásolását a szócikkbe. Bonyolultabb sablonok esetén az egyes paraméterek külön magyarázatát is ide lehet leírni. A sablondokumentáció képes kezelni a sablon kategóriáit ésis. Ahhoz, hogy a sablonok a vizuális szerkesztővel is használhatóak legyenek, itt kell megadni a speciális dokumentációt ([[Wikipédia:interwikiTemplateData|wikiközi hivatkozásaitTemplateData]] is).▼
 
▲Készíts az új sablonhoz dokumentációt! Ez azért nagyon fontos, hogy mindenki pontosan láthassa, mire és hogyan használható egy adott sablon. A sablondokumentáció leírja a sablon célját, a használat módját, és mintát is közöl a sablonról, illetve egy szócikkbe másolható mintát is mutat. Ez különösen a paraméteres sablonok esetében nagyon hasznos, mivel megkönnyíti azok gyors bemásolását a szócikkbe. Bonyolultabb sablonok esetén az egyes paraméterek külön magyarázatát is ide lehet leírni. A sablondokumentáció képes kezelni a sablon kategóriáit és [[Wikipédia:interwiki|wikiközi hivatkozásait]] is.
 
A sablondokumentáció pontos készítésének módjáról itt olvashatsz: [[Wikipédia:Sablondokumentáció]]
A lap eredeti címe: „https://hu.wikipedia.org/wiki/Wikipédia:Sablonok”