Wikipédia:Sablonmester forrásának megtekintése

{{Fejléc
|stílus = Segítség
|cím = Sablonmester
|1. szint = [[Wikipédia:Segítség|Segítség]]
|2. szint = [[Wikipédia:Sablonok|Sablonok]]
|kapcsolódó lapok = Sablonok
}}
[[Fájl:Sablonmester.jpg|bélyegkép|300px|Működés közben]]
A '''Sablonmester''' egy kiegészítő, segítségével az oldalakon levő sablonokat lehet szerkeszteni, kényelmes felületen, anélkül, hogy ismernéd, melyik paraméter mire való.
__TOC__
<br style="clear:both;" />

== Telepítés ==
A Sablonmester telepítése rendkívül egyszerű: a [[Speciális:Preferences|beállításaidnál]] menj a Segédeszközök fülre, majd jelöld be a Sablonmester mellett található dobozt.

A kiegészítő sikeresen lett tesztelve [[Mozilla Firefox|Firefox 2 és 3]], [[Opera (böngésző)|Opera 9]] és [[Internet Explorer|Internet Explorer 7]] alatt, Monobook kinézettel.

'''Figyelem:''' A Sablonmester nem használható, miközben a [[Wikipédia:WikEd|WikEd]] aktív. Ahhoz, hogy rendben működjön egyik lehetőség, hogy kikapcsolod a SM használata idejéig a jobb felső sarokban található WikEd-ikonnal, másik, hogy kiveszed előle a pipát a beállításaidnál.

== Működése ==
A telepítés után a szerkesztőeszköz-sor elején (ha ki van kapcsolva, akkor is) található egy gomb „SM” felirattal. Ezzel lehet előhívni az űrlapot.

=== Új sablon beillesztése ===
Először vidd a kurzort a megfelelő pozícióra. Ezután két lehetőség van:
# Írj egy üres sablont a szövegbe: <nowiki>{{Sablon neve}}</nowiki>, belekattintasz, vagy odaviszed a kurzort, és az SM-gombra kattintasz.
# Rögtön az SM-gombra kattintasz, ennek hatására megjelenik az alkalmazás, kitöltendő űrlap nélkül. A ''Sablon'' mezőbe kell beírni a kívánt sablon nevét. Az {{billentyű|Enter}} leütése után már meg is jelenik az adott sablonhoz tartozó űrlap.

=== Meglévő sablon szerkesztése ===
Meglévő sablon szerkesztéséhez a kurzort a sablon szövegén belülre kell vinned. A program megkeresi a szerkeszteni kívánt sablon nevét, betölti az űrlapot és kitölti a mezőket a forráskódban található értékekkel.

A sablonszövegben található ismeretlen paraméterek is megmaradnak, ezek – ha van ilyen – felül találhatóak meg egy zöld színű gombsorként. Ha egy paraméter nevében írási hibát vétettek, akkor a probléma egy kattintással orvosolható, hiszen a gombok segítségével az ismeretlen paraméterek értéke beilleszthető a kívánt helyre, csupán bele kell kattintani a megfelelő mezőbe.

=== A szerkesztés befejezése ===
Ha kész vagy a szerkesztéssel, és szeretnéd elmenteni a sablonszövegben található változásokat, akkor kattints az {{billentyű|Elküld}} gombra. A {{billentyű|Mégse}} gomb használatával a változások nem mentődnek, és az eszköz bezárul.

Ha a Sablonmester elindítása után kattintasz az SM-gombra, akkor szöveget tudsz másolni a szócikk szövegéből, és egy újabb kattintással visszatérhetsz az űrlaphoz. (Kilépni nem ezzel lehet, hanem az Elküld vagy a Mégse gombbal!)

== Mely sablonokkal használható? ==
Azt, hogy a Sablonmester mely sablonokkal használható, azaz melyikhez létezik már XML-leírás, a [[:Kategória:Sablonmesterrel használható sablonok|Sablonmesterrel használható sablonok]] kategóriában találhatod meg.

== Fejlesztőknek ==
Ahhoz, hogy egy sablont ezzel az eszközzel használni lehessen, egy XML-leírásra van szükség (egy allapon, Sablon:Név/XML formában).

[http://web.archive.org/web/20140630134049/http://toolserver.org/~revolus/Template-Master/index.hu.html Ezen a címen] <small>(JavaScript, archive.org-archívum, az eredeti 2014. június 30-án megszűnt)</small> a német [[:de:Benutzer:Revolus|Benutzer:Revolus]] készített egy eszközt, melynek segítségével a sablon vázából XML-leírást lehet készíteni.

=== Az [[XML]]-sablonleírás felépítése és jelentése ===
A leírás az alábbi módon épül fel (csak a kötelező attribútumokkal):
<source lang="xml">
 <TemplateUsage>
   <Group>
     <Parameter name="Címl" />
 
     <Parameter name="ISBN">
       <Help>Az ISBN-szám az előtte álló ISBN nélkül.</Help>
     </Parameter>
 
     <Parameter name="Hónap">
       <Value>Január</Value>
       <Value>Február</Value>
       ...
     </Parameter>
     ...
   </Group>
   ...
 </TemplateUsage>
</source>

Beillesztett szövegben, például a ''Help'', ''Condition'' és ''Value'' elemeknél és az attribútumok, például a ''name'' vagy ''label'' esetében  az alábbi karaktereket kell helyettesíteni, hogy az XML-dokumentum érvényes maradjon:
{| class="wikitable" 
!Karakter
!Helyettesítés
|-
|&||&amp;amp;
|-
|<||&amp;lt;
|-
|>||&amp;gt;
|-
|"||&amp;quot;
|-
|'||&amp;apos;
|}

A következő táblázat tartalmazza az összes elemet és azok attribútumait. A nagy- és kisbetűknek meg kell egyezniük. Az opcionális elemek ill. attribútumok ''(nem kötelező)'' jelzéssel vannak ellátva. Az attribútumok alapértelmezett értékeit nem kell megadni.

{| class="wikitable" 
!Elemnév
!Attribútum
!Leírás
|-
| TemplateUsage || || Gyökérelem, ez tartalmazza a leírást
|-
| rowspan="3" | || output || ''(nem kötelező)'' – Szabályozza, hogy hogyan nézzen ki a sablonszöveg elmentés után.
|-
| <p style="text-align:right;">output="collapse"</p> || ''(alapértelmezett)'' – Ebben az esetben a sablon egy sorban fog elhelyezkedni.
|-
| <p style="text-align:right;">output="expand"</p> || Ennél minden paraméter külön sorban helyezkedik el.
|-
| Group || || A paraméterek egy halmazát foglalja magába. Az űrlapon mindegyik külön területen fog szerepelni. Ha a csoportosítás nem célszerű, akkor az összes paramétert egyetlen csoportba kell belerakni.
|-
| || name || ''(nem kötelező)'' – Leírja a csoport tartalmát. Ha van értéke, akkor csoportcímként fog megjelenni.<!--
|-
| showempty || ''(nem kötelező)'' – Legt fest, ob im Ausgabemodus „expand“ die Gruppe angezeigt werden soll, wenn keinem Parameter dieser Gruppe ein Wert zugewiesen wurde.
|-
| <p style="text-align:right;"> showempty="true"</p> || ''(Vorgabe)'' – Alle Parameter der Gruppe werden ausgegeben, auch wenn keinem ein Wert zugewiesen wurde.
|-
| <p style="text-align:right;"> showempty="false"</p> || Alle Parameter dieser Gruppe werden nur ausgegeben, wenn wenigstens einem Parameter ein Wert zugewiesen wurde.-->
|-
| Parameter || || A sablon egy paraméterének leírását tartalmazza. Csak a „Group” elem tartalmazhatja.
|-
| rowspan="7" | || name || A paraméter neve.
|-
| label || ''(nem kötelező)'' – Másodlagos leírás, ez fog megjelenni a paraméter neve helyett az űrlapon. Például: „ISBN-szám” „isbn” helyett.
|-
| length || ''(nem kötelező)'' – A szövegmező maximális hossza.  Utóbbinak megadásánál a paraméter egy egész sort fog elfoglalni. Érték megadása akkor célszerű, ha a paraméter értékének hossza tartalmilag korlátozott, mint pl. magassági vagy sebességérték és ha a paraméter értékének túl sokszor nagyon hosszú szöveget írnak be. Az ''alapértelmezett'' érték 20 karakter.
|-
| height || ''(nem kötelező)'' – A szövegbeviteli mező magassága. Az alapértelmezett értéke egy.
|-
| null || ''(nem kötelező)'' – Meg lehet adni, hogy a paraméter kötelező legyen-e, vagy sem.
|-
| <p style="text-align:right;">null="true"</p> || ''(alapértelmezett)'' – Az üres érték endedélyezett, nem kötelező értéket megadni.
|-
| <p style="text-align:right;">null="false"</p> || A mező kitöltése kötelező. A paraméter neve az űrlapon aláhúzva látható. Az elküldés előtt a program megvizsgálja, hogy van-e érték neki megadva, és ha nem, akkor jelez.<!--
|-
| predefined || ''(nem kötelező)'' – Megmondja, hogy a sablon tartalmaz-e valamilyen előre megadott értéket, wenn kein Wert übergeben wird.
|-
| <p style="text-align:right;">predifined="true"</p> || A paraméternek van egy előre megadott értéket.
|-
| <p style="text-align:right;">predifined="false"</p> || ''(alapértelmezett)'' – Nincs előre megadott érték.-->
|-
| Condition || || ''(nem kötelező)'' – Egy [[reguláris kifejezés]]t tartalmazhat, a paraméter értékének ennek kell megfelelnie. Az elküldés előtt a program megvizsgálja, hogy van-e érték neki megadva, és ha nem, akkor jelez. Csak a „Parameter” elem tartalmazhatja.
|-
| Default || || ''(nem kötelező)'' – A „Paraméter” elem ezen eleme azt az értéket tartalmazza, amellyel a mező mindig fel lesz töltve, ha az üres.
|-
| Help || || ''(nem kötelező)'' – A súgószöveget tartalmazza, amely a paraméter használatáról, az értékek megadásával kapcsolatban tartalmaz információt. Az űrlapon ez látható az állapotsoron, amikor a hozzátartozó mező aktív. Továbbá a súgószöveg tooltipként is megjelenik. Csak a „Parameter” elem tartalmazhatja.
|-
| Value || || ''(nem kötelező)'' – Egy lehetséges választ tartalmaz. Az űrlapon a szövegmező helyett több adatnál egy legördülő lista jelenik meg, az összes lehetséges értékkel.  Csak a „Parameter” elem tartalmazhatja.
|-
| || label || ''(nem kötelező)'' – Másodlagos név, ez fog megjelenni az űrlapon. Például „MediaWiki” „mw” helyett.
|}

=== A leírás tesztelése és beillesztése ===
A sablon leírása az /XML allapon található. A sablon olvashatósága miatt az első sor kivételével minden sornak egy szóközzel kellene kezdődnie. 

<pre><nowiki>
<?xml version="1.0" encoding="utf-8"?>
<!--                                                                    -->
<!-- Ez a sablon XML-leírása a Sablonmesterrel való használathoz        -->
<!-- További infó: [[WP:SM]]                                            -->
<!--                                                                    -->
<?mediawiki "{{XML|A sablon neve}}"?>
 <TemplateUsage ...>
 ...
 </TemplateUsage>
</nowiki></pre>

Az {{sl|XML}} sablon informálja a szerkesztőket az XML leírás mibenlétéről és egy linket biztosít az XML leírás online történő ellenőrzéséhez. A sablon lapján (vagy, ha van, a sablonleírásén) a {{sl|Sablonmester-XML}} sablonnal jelezheted, hogy fel van készítve a Sablonmester használatára.

Nagyobb módosítások tesztelésénél mindenképp egy, a saját névtérben lévő allapot ajánlott használni, mivel a módosítások és egyben esetleges hibák a többi felhasználónál is jelentkezhetnek.

[[Kategória:Wikipédia-eszközök]]

[[de:Wikipedia:Helferlein/Vorlagen-Meister]]