Nápověda:Šablona:Šachovnice

Účel

Používá se pro zobrazení šachového diagramu.

Použití

{{Šachovnice
| <zarovnání> (parametr 1)
| <nadpis>    (parametr 2) 
| size =
| clear =
| numbers =
| letters =
| <a8> | <b8> | ... | <h8>  (parametr 3 až ...
| <a7> | <b7> | ... | <h7>
...
| <a1> | <b1> | ... | <h1>  ( ... parametr 66)
| <popisek> (parametr 67)
| reverse = 
| solution =
}}

Lze také použít alternativní syntaxi (viz #Alternativní zápis: FEN níže):

{{Šachovnice
| fen =
| align =
| clear = 
| header = 
| footer =
| size =
| numbers =
| letters =
| reverse =
| solution =
}}

Parametery

<zarovnání>: horizontální zarovnání (floating) celého diagramu, fungují hodnoty tright, tleft, center (lze ponechat prázdné);
<nadpis>: text, který se zobrazí nad diagramem (lze ponechat prázdné);
size=: velikost políčka v pixelech (automaticky nastaveno na 26);
clear=: ukončí obtékání, lze použít hodnoty right, left, both a none (default);
numbers=: určuje, zda a kde se mají zobrazit čísla řádků; možné hodnoty: left, right, both (default) nebo neither (=nezobrazovat; stejně tak je-li zadán prázdný řetězec);
letters=: určuje, zda a kde se mají zobrazit písmena označující sloupce; možné hodnoty: top, bottom, both (default) nebo neither (= nezobrazovat; stejně tak je-li zadán prázdný řetězec);
<a8>, <b8>, ... <h1>: symbol zobrazený na příslušném poli šachovnice, vysvětlení níže;
<popisek>: text, který se zobrazí pod diagramem (nepovinné);
reverse=: otočení šachovnice;
solution=: řešení šachové úlohy, zobrazí se jako skrytý text pod popiskem;

Zápis kamenů

Kameny se zapisují písmeny podle následující notace:

k = král (king)
q = dáma (queen)
r = věž (rook)
b = střelec (bishop)
n = jezdec (knight)
p = pešec (pawn)

Dostupné jsou i některé kameny z exotických variant šachu:

a = arcibiskup (kombinace jezdce a střelce)
c = kancléř (chancellor) (kombinace jezdce a věže)
f = obrácený král (fers)
g = obrácená dáma (grasshoper, cvrček)
m = obrácená věž
j(e) = obrácený střelec
N(s) = obrácený jezdec
h = obrácený pěšec
z = šampion
w = čaroděj (wizzard)
t = šašek
G = žirafa (giraffa)
U = jednorožec (unicorn)
Z = zebra
e = slon (elephant)
s = loď (ship)

Prázdné pole lze zapsat pomocí podtržítek, mezer nebo ponechat nevyplněné. Pro snadnější orientaci v kódu zobrazeném neproporcionálním písmem je vhodné použít dvě mezery.

<mezera> = prázdné pole

Zápis barev

Uvedená písmena se kombinují s označením barvy:

l = bílý ((light)
d = černý (dark)
g = zelený (green)
r = červený (red)
y = žlutý (yellow)

Zápis kl tedy zobrazí bílého krále, zápis nd černého jezdce.

Zelenou, červenou a žlutou barvu nelze použít u některých exotických kamenů

Jiné značky

Lze také použít xx pro černý křížek, ox pro bílý křížek, xo pro černé kolečko nebo oo pro bílé kolečko.

xx = černý křížek
ox = bílý křížek
xo = černé kolečko
oo = bílé kolečko

Pro naznačení směru pohybu na šachovnici lze použít šipky:

ul = vlevo nahoru (up & left)
ua = nahoru (up arrow)
ur = vpravo nahoru(up & right)
la = vlevo (left arrow)
ra = doprava (right arrow)
dl = doleva dolů (down & left)
da = dolů (down arrow)
dr = doprava dolů (down & right)
lr = doleva a doprava (left & right)
ud = nahoru a dolů (up & down)
db = ve směru černé hlavní diagonály (diagonal black)
dw = ve směru bílé hlavní diagonály (diagonal white)

Čísla lze na pole umístit pomocí x0 pro 0, x1 pro 1, …, x9 pro 9.

x0
x1
x2
x3
x4
x5
x6
x7
x8
x9

Alternativní zápis: FEN

{{Šachovnice|fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR|align=tleft}}

	a	b	c	d	e	f	g	h
8									8
7									7
6									6
5									5
4									4
3									3
2									2
1									1
	a	b	c	d	e	f	g	h

Namísto použití pozičních parametrů je možné popsat situaci na šachovnici Forsyth–Edwardsovým zápisem (FEN) pomocí parametru fen=…. Výchozí postavení šachové hry lze v této notaci zapsat jako rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR (čísla udávají počet prázdných polí).

{{Šachovnice|fen=rnbqkbnr/acfghzwt/8/8/8/8/ACFGHZWT/RNBQKBNR|align=tleft}}

	a	b	c	d	e	f	g	h
8									8
7									7
6									6
5									5
4									4
3									3
2									2
1									1
	a	b	c	d	e	f	g	h

V zápisu FEN lze použít i většinu figur z exotických šachů; nelze však použít převráceného jezdce, který je zapisován pomocí velkého N (FEN používá velká a malá písmena k rozlišení barvy kamene). Příklad šachovnice s pěšáky nahrazenými figurkami exotických šachů:

Zobrazení šachovnice z pohledu černého

{{Šachovnice|fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR|align=tleft|reverse=true}}

	h	g	f	e	d	c	b	a
1									1
2									2
3									3
4									4
5									5
6									6
7									7
8									8
	h	g	f	e	d	c	b	a

Pomocí parametru reverse=true lze „otočit“ šachovnici a zobrazit ji z pohledu černého, tzn. pole h8 vlevo dole a pole a1 vpravo nahoře:

Tato sekce obsahuje strukturovaný popis parametrů této šablony využívající rozšíření TemplateData, který umožňuje snadnější používání této šablony v prostředí VisualEditoru.

Šablona:Šachovnice

Syntaktická chyba v JSON.

Příklady použití

Kód Výsledek Poznámka

{{Šachovnice|fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR}}

	a	b	c	d	e	f	g	h
8									8
7									7
6									6
5									5
4									4
3									3
2									2
1									1
	a	b	c	d	e	f	g	h

{{Šachovnice
|
|
|
rd|nd|bd|qd|kd|bd|nd|rd|
pd|pd|pd|pd|pd|pd|pd|pd|
  |  |  |  |  |  |  |  |
  |  |  |  |  |  |  |  |
  |  |  |  |  |  |  |  |
  |  |  |  |  |  |  |  |
pl|pl|pl|pl|pl|pl|pl|pl|
rl|nl|bl|ql|kl|bl|nl|rl|
}}

{{Šachovnice
|
|
|rd|nd|bd|qd|kd|bd|nd|rd
|pd|pd|pd|pd|pd|pd|pd|pd
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|pl|pl|pl|pl|pl|pl|pl|pl
|rl|nl|bl|ql|kl|bl|nl|rl
}}

	a	b	c	d	e	f	g	h
8									8
7									7
6									6
5									5
4									4
3									3
2									2
1									1
	a	b	c	d	e	f	g	h

Oba zápisy šablony jsou rovnocenné, liší se jen způsobem rozvržení zdrojového kódu.

{{Šachovnice
|
|
|
 8  rd|nd|bd|qd|kd|bd|nd|rd|
 7  pd|pd|pd|pd|pd|pd|pd|pd|
 6    |  |  |  |  |  |  |  |
 5    |  |  |  |  |  |  |  |
 4    |  |  |  |  |  |  |  |
 3    |  |  |  |  |  |  |  |
 2  pl|pl|pl|pl|pl|pl|pl|pl|
 1  rl|nl|bl|ql|kl|bl|nl|rl|=

    a  b  c  d  e  f  g  h
}}

	a	b	c	d	e	f	g	h
8									8
7									7
6									6
5									5
4									4
3									3
2									2
1									1
	a	b	c	d	e	f	g	h

Pro snadnější orientaci v kódu lze přidat označení řádků a sloupců způsobem, který nemá na výsledný diagram vliv.