Sablon:Sakkdiagram/doc

Ez a sablon egy sakk-állás leírását teszi lehetővé. Az eredmény képként jelenik meg.

Kötelező paraméterek

A sablonnak 66 kötelező paramétere van:

1. a sakktábla helye a lapon. Lehetséges értékek: tleft és tright.
2. a tábla felirata

A 3–66. paraméter a tábla mezőin álló bábukat adja meg.

Opcionális paraméterek

Az utolsó (67.) paraméter a tábla alá kiírandó megjegyzés.

Használata

Susztermatt

A susztermatt táblaképe

{{Sakkdiagram
| tright
| Susztermatt
|rd|  |bd|qd|kd|bd|  |rd
|pd|pd|pd|pd|  |ql|pd|pd
|  |  |nd|  |  |nd|  |  
|  |  |  |  |pd|  |  |  
|  |  |bl|  |pl|  |  |  
|  |  |  |  |  |  |  |  
|pl|pl|pl|pl|  |pl|pl|pl
|rl|nl|bl|  |kl|  |nl|rl
|A [[susztermatt]] táblaképe}}

Bábukódok

Kód	Angol	Magyar
k	king	király
q	queen	vezér
r	rook	bástya
b	bishop	futó
n	knight	huszár
p	pawn	gyalog

Ha egy mezőn nincs bábu, a paramétert üresen hagyjuk, egyébként egy kétbetűs kóddal jelezzük. Az első betű adja meg bábut, a második a bábu színét:

• light: világos
• darg: sötét.

A sablon működése

A sablon több mellékhatást is kihasznál a mediawiki működésében.

• A sor végén nem lehet üres paraméter. Ha a paramétereket elválasztó | után a sor végéig a helyközön kívül nincs semmi, akkor a mediawiki úgy tekinti, mintha a paraméter nem lenne megadva. Az olvashatóság szempontjából viszont fontos, hogy a sakktábla sorai szerint adjuk meg a paramétereket akkor is, ha a h oszlopban nincs bábu. Ennek érdekében van a példában a sorok végén |=, ami egy másik mellékhatást használ ki.
• A mediawikiben a paramétereket háromféleképpen lehet megadni: névtelenül (kötött sorrendben), a paraméter sorszámával vagy névvel. A sakkdiagram sablon fenti hívása az elsőt használja, kivéve a sorok végén, ahol név szerint adja át a paramétert. A paraméter neve üres. Ez egy újabb mellékhatást használ ki.
• Ha a sablon hívásakor név szerint adunk meg paramétert, és a sablon nem használja az ilyen nevű paramétert, akkor a paraméter hatástalan. Ez jól jön az |= esetén: jelzi, hogy a paraméter létezik, de a hívás módja miatt hatástalan. Ez viszont azzal jár, hogy a név nélküli, név szerint átadott paraméter többször kap értéket.
• Ha a sablon hívásakor egy paraméter több értéket is kapott a mediawiki csak a legutolsó értéket veszi figyelembe. Ez okozhat problémát, ezért a magyar Wikipédián hibalista készült az ilyen lapokról. A sakkdiagram sablont használó lapok a hibalistára kerülnek, és ezt nem lehet (könnyen) elkerülni.
• A mediawiki figyelmen kívül hagyja a paraméter vége és a következő | közötti szöveget. Ez általában nem okoz gondot, csak akkor, ha egy híváson belül keverjük a különböző sablonhívási módokat. Márpedig a sakkdiagram hívási példája éppen ezt teszi a sorokat záró |= szöveggel. E mellékhatás miatt a mediawiki figyelmen kívül hagyja a sorok elején levő táblasor-számot és az a b c d e f g h sort.

Kapcsolódó sablonok

• {{Sakkfigurák}}
• {{Csaturangadiagram}}

További információk

• en:Template talk:Chess position (a sablon működése, a felmerült problémák)