Šablona:Šachovnice

	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

Dokumentace  

Úč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.

Š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.