Template:Chess diagram/doc

From Wikipedia, the free encyclopedia

This is a documentation subpage for Template:Chess diagram (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

Contents

[edit] Syntax

There are several standard chess diagram templates:

There are also templates for chess variants:

The syntax is basically the same for all of them.

{{Chess diagram
| <alignment> (param #1)
| <header>    (#2) 
| <a8> | <b8> | ... | <h8>  (#3 to ...
| <a7> | <b7> | ... | <h7>
...
| <a1> | <b1> | ... | <h1>  ( ... #66)
| <footer> (#67)
}}

Parameters:

  • <alignment> – defines horizontal alignment (floating) of the whole table, must be tright or tleft (or nothing)
  • <header> – the text which appears above the diagram, may be empty;
  • <a8>, <b8>, ... <h1> – define corresponding squares of the chessboard, see below;
  • <footer> – the text which appears beneath the diagram, may be empty; optional – can be left out (currently not in the other templates)

A square is defined by the name of piece or empty parameter. The names of the pieces are those given in algebraic notation:

  • k = king
  • q = queen
  • r = rook
  • b = bishop
  • n = knight
  • p = pawn

There are also some fairy chess pieces available:

  • a = archbishop (knight + bishop compound)
  • c = chancelor (knight + rook compound)
  • f = upside-down king
  • g = upside-down queen
  • m = upside-down rook
  • e = upside-down bishop
  • s = upside-down knight
  • h = upside-down pawn
  • z = champion (for Omega Chess)
  • w = wizard (for Omega Chess)

These letters are combined with either "l" for Light=White, or "d" for Dark=Black. So "kl" is White's king, and "nd" is Black's knight.

An empty square is written either using underscores, spaces, or nothing at all. Two spaces are recommended.

  • <space> = empty square

You can also use "xx" for a cross, "xo" for a black circle on an empty square or "oo" for a white one.

  • xx = cross/x
  • xo = black circle
  • oo = white circle

Numbers can also be added to squares by using "x1" for 1, "x2" for 2, ..., "x9" for 9. There is no 0.

  • x1
  • x2
  • x3
  • x4
  • x5
  • x6
  • x7
  • x8
  • x9

[edit] Examples

In the following examples the rows and columns are numbered. Because any text between "|=" and the next "|" is ignored, numbers and letters can be added without affecting output.

[edit] Standard diagram

This diagram is recommended for common use as a main diagram in the articles on chess openings, endings, games, positions etc. See the corresponding code below.

Image:chess zhor 26.png
Image:chess zver 26.png a8 rd b8 nd c8 bd d8 qd e8 kd f8 bd g8 nd h8 rd Image:chess zver 26.png
a7 pd b7 pd c7 pd d7 pd e7 f7 pd g7 pd h7 pd
a6 b6 c6 d6 e6 f6 g6 h6
a5 b5 c5 d5 e5 pd f5 g5 h5
a4 b4 c4 d4 e4 pl f4 pl g4 h4
a3 b3 c3 d3 e3 f3 g3 h3
a2 pl b2 pl c2 pl d2 pl e2 f2 g2 pl h2 pl
a1 rl b1 nl c1 bl d1 ql e1 kl f1 bl g1 nl h1 rl
Image:chess zhor 26.png
The King's Gambit
{{Chess diagram
| tright
| 
|= 

 8 |rd|nd|bd|qd|kd|bd|nd|rd|=
 7 |pd|pd|pd|pd|  |pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |pd|  |  |  |=
 4 |  |  |  |  |pl|pl|  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|  |  |pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|nl|rl|=
    a  b  c  d  e  f  g  h  

| The King's Gambit
}}

[edit] Diagram with both captions

W. Langstaff, Chess Amateur 1922
Image:chess zhor 26.png
Image:chess zver 26.png a8 b8 c8 d8 e8 kd f8 g8 h8 rd Image:chess zver 26.png
a7 b7 c7 d7 e7 f7 g7 h7
a6 b6 c6 d6 e6 f6 bl g6 h6 pl
a5 b5 c5 d5 rl e5 f5 kl g5 pd h5 pl
a4 b4 c4 d4 e4 f4 g4 h4
a3 b3 c3 d3 e3 f3 g3 h3
a2 b2 c2 d2 e2 f2 g2 h2
a1 b1 c1 d1 e1 f1 g1 h1
Image:chess zhor 26.png
Mate in two.
This problem uses partial retrograde analysis method.

It may be convenient to use this in the articles on chess problems. Please note that in the header and footer you can use bolds or italics. You can also use <br> to break the lines.

{{Chess diagram
| tright
| '''W. Langstaff''', ''Chess Amateur'' 1922
|= 

 8 |  |  |  |  |kd|  |  |rd|=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |  |bl|  |pl|=
 5 |  |  |  |rl|  |kl|pd|pl|=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |  |  |  |  |  |  |  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h  

| '''Mate in two.''' <br> This problem uses ''partial retrograde analysis'' method.
}}

[edit] Diagram without captions

Image:chess zhor 26.png
Image:chess zver 26.png a8 b8 c8 d8 e8 f8 g8 h8 Image:chess zver 26.png
a7 b7 c7 d7 e7 f7 g7 h7
a6 b6 xx c6 xo d6 xx e6 f6 g6 h6
a5 b5 c5 pl d5 e5 f5 g5 h5
a4 b4 c4 d4 e4 f4 xo g4 h4
a3 b3 c3 d3 e3 xx f3 xo g3 xx h3
a2 b2 c2 d2 e2 f2 pl g2 h2
a1 b1 c1 d1 e1 f1 g1 h1
Image:chess zhor 26.png

See the corresponding code below. If you don't want the captions, just remove them, but don't delete the second "|" pipe character for the caption above; it is possible to delete the last pipe for the longer caption below.

The diagram floats to the left to illustrate the use of the first parameter.

{{Chess diagram
| tleft
| 
|= 

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |xx|xo|xx|  |  |  |  |=
 5 |  |  |pl|  |  |  |  |  |=
 4 |  |  |  |  |  |xo|  |  |=
 3 |  |  |  |  |xx|xo|xx|  |=
 2 |  |  |  |  |  |pl|  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h  
}}

[edit] Small diagram

This one may be useful in articles with many diagrams. It uses another template named {{Chess diagram small}}.

The small diagrams can have header, too.

Image:chess zhor 22.png
Image:chess zver 22.png a8 rd b8 c8 d8 qd e8 f8 rd g8 kd h8 Image:chess zver 22.png
a7 pd b7 pd c7 d7 e7 pd f7 pd g7 bd h7 pd
a6 b6 nd c6 pd d6 e6 f6 nd g6 pd h6
a5 b5 c5 ql d5 e5 f5 g5 bl h5
a4 b4 c4 d4 pl e4 pl f4 g4 bd h4
a3 b3 c3 nl d3 e3 f3 nl g3 h3
a2 pl b2 pl c2 d2 e2 f2 pl g2 pl h2 pl
a1 b1 c1 d1 rl e1 kl f1 bl g1 h1 rl
Image:chess zhor 22.png
The position after 11. Bg5.
{{Chess diagram small
| tright
| 
|= 

 8 |rd|  |  |qd|  |rd|kd|  |=
 7 |pd|pd|  |  |pd|pd|bd|pd|=
 6 |  |nd|pd|  |  |nd|pd|  |=
 5 |  |  |ql|  |  |  |bl|  |=
 4 |  |  |  |pl|pl|  |bd|  |=
 3 |  |  |nl|  |  |nl|  |  |=
 2 |pl|pl|  |  |  |pl|pl|pl|=
 1 |  |  |  |rl|kl|bl|  |rl|=
    a  b  c  d  e  f  g  h  

| The position after 11. Bg5.
}}

[edit] Different board size

Chess boards of non-standard dimensions need special templates. There are templates for the following boards:

Minichess (5×5) – Chess diagram 5x5 
{{Chess diagram 5x5
| tright
| 
|= 

 5 |kd|qd|bd|nd|rd|=
 4 |pd|pd|pd|pd|pd|=
 3 |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|=
 1 |kl|ql|bl|nl|rl|=
    a  b  c  d  e  

| Gardner minichess
}}
a5 b5 c5 d5 e5
a4 b4 c4 d4 e4
a3 b3 c3 d3 e3
a2 b2 c2 d2 e2
a1 b1 c1 d1 e1
Gardner minichess
Los Alamos chess (6×6) – Template:Chess diagram 6x6 
{{Chess diagram 6x6
| tright
| 
|= 

 6 |rd|nd|qd|kd|nd|rd|=
 5 |pd|pd|pd|pd|pd|pd|=
 4 |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|ql|kl|nl|rl|=
    a  b  c  d  e  f  

| Los Alamos chess
}}
Image:chess_z6hor_26.png
Image:chess_z6ver_26.png
a6 b6 c6 d6 e6 f6
a5 b5 c5 d5 e5 f5
a4 b4 c4 d4 e4 f4
a3 b3 c3 d3 e3 f3
a2 b2 c2 d2 e2 f2
a1 b1 c1 d1 e1 f1
Image:chess_z6ver_26.png
Image:chess_z6hor_26.png
Los Alamos chess
Capablanca chess (8×10) 
{{Chess diagram 8x10
| tright
| 
|= 

 8 |rd|nd|ad|bd|qd|kd|bd|cd|nd|rd|=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|al|bl|ql|kl|bl|cl|nl|rl|=
    a  b  c  d  e  f  g  h  i  j

| Capablanca chess
}}
Image:chess_zh10_26.png
Image:chess_zver_26.png
Image:chess_zver_26.png
Image:chess_zh10_26.png
Capablanca chess
Grand Chess 
{{Chess diagram 10x10
| tright
| 
|= 

10 |rd|  |  |  |  |  |  |  |  |rd|=
 9 |  |nd|bd|qd|kd|cd|ad|bd|nd|  |=
 8 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
 7 |  |  |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |  |  |=
 3 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
 2 |  |nl|bl|ql|kl|cl|al|bl|nl|  |=
 1 |rl|  |  |  |  |  |  |  |  |rl|=
    a  b  c  d  e  f  g  h  i  j

| Grand Chess
}}
Image:chess_zh10_26.png
Image:chess_z10ver_26.png
a10 b10 c10 d10 e10 f10 g10 h10 i10 j10
a9 b9 c9 d9 e9 f9 g9 h9 i9 j9
a8 b8 c8 d8 e8 f8 g8 h8 i8 j8
a7 b7 c7 d7 e7 f7 g7 h7 i7 j7
a6 b6 c6 d6 e6 f6 g6 h6 i6 j6
a5 b5 c5 d5 e5 f5 g5 h5 i5 j5
a4 b4 c4 d4 e4 f4 g4 h4 i4 j4
a3 b3 c3 d3 e3 f3 g3 h3 i3 j3
a2 b2 c2 d2 e2 f2 g2 h2 i2 j2
a1 b1 c1 d1 e1 f1 g1 h1 i1 j1
Image:Chess_z10ver_26.png
Image:chess_zh10_26.png
Grand Chess


[edit] Double boards

Bughouse chess (four players) 
{{bughouse chess diagram
| A1=Team 1, Board A 
| A2=Team 2, Board A 
| B1=Team 1, Board B 
| B2=Team 2, Board B
| tright
|
|=
 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

 8 |rl|nl|bl|kl|ql|bl|nl|rl|=
 7 |pl|pl|pl|pl|pl|pl|pl|pl|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pd|pd|pd|pd|pd|pd|pd|pd|=
 1 |rd|nd|bd|kd|qd|bd|nd|rd|=
    a  b  c  d  e  f  g  h

| '''Bughouse setup and start position'''
}}
Team 2, Board A
a8 b8 c8 d8 e8 f8 g8 h8
a7 b7 c7 d7 e7 f7 g7 h7
a6 b6 c6 d6 e6 f6 g6 h6
a5 b5 c5 d5 e5 f5 g5 h5
a4 b4 c4 d4 e4 f4 g4 h4
a3 b3 c3 d3 e3 f3 g3 h3
a2 b2 c2 d2 e2 f2 g2 h2
a1 b1 c1 d1 e1 f1 g1 h1

Team 1, Board A

 Team 2, Board B
a8 b8 c8 d8 e8 f8 g8 h8
a7 b7 c7 d7 e7 f7 g7 h7
a6 b6 c6 d6 e6 f6 g6 h6
a5 b5 c5 d5 e5 f5 g5 h5
a4 b4 c4 d4 e4 f4 g4 h4
a3 b3 c3 d3 e3 f3 g3 h3
a2 b2 c2 d2 e2 f2 g2 h2
a1 b1 c1 d1 e1 f1 g1 h1

Team 1, Board B
Bughouse setup and start position
Alice chess (two players) 
{{alice chess diagram
| tright
|
|=
 8 |rd|nd|bd|qd|kd|  |nd|rd|=
 7 |pd|pd|pd|pd|  |pd|pd|pd|=
 6 |  |  |  |  |  |  |  |  |=
 5 |  |  |  |  |nl|  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|=
 1 |rl|nl|bl|ql|kl|bl|  |rl|=
    a  b  c  d  e  f  g  h
          Board A

 8 |  |  |  |  |  |  |  |  |=
 7 |  |  |  |  |  |  |  |  |=
 6 |  |  |  |  |pd|  |  |  |=
 5 |  |  |bd|  |  |  |  |  |=
 4 |  |  |  |  |  |  |  |  |=
 3 |  |  |  |  |  |  |  |  |=
 2 |  |  |  |  |  |  |  |  |=
 1 |  |  |  |  |  |  |  |  |=
    a  b  c  d  e  f  g  h
          Board B
| The position after '''1.Nf3 e6 2.Ne5 Bc5'''.
}}
a8 b8 c8 d8 e8 f8 g8 h8
a7 b7 c7 d7 e7 f7 g7 h7
a6 b6 c6 d6 e6 f6 g6 h6
a5 b5 c5 d5 e5 f5 g5 h5
a4 b4 c4 d4 e4 f4 g4 h4
a3 b3 c3 d3 e3 f3 g3 h3
a2 b2 c2 d2 e2 f2 g2 h2
a1 b1 c1 d1 e1 f1 g1 h1

A
a8 b8 c8 d8 e8 f8 g8 h8
a7 b7 c7 d7 e7 f7 g7 h7
a6 b6 c6 d6 e6 f6 g6 h6
a5 b5 c5 d5 e5 f5 g5 h5
a4 b4 c4 d4 e4 f4 g4 h4
a3 b3 c3 d3 e3 f3 g3 h3
a2 b2 c2 d2 e2 f2 g2 h2
a1 b1 c1 d1 e1 f1 g1 h1

B
The position after 1.Nf3 e6 2.Ne5 Bc5.

[edit] Different shaped board

Three-dimensional chess (Raumschach) – Template:Raumschach diagram 
{{Raumschach diagram
| tright
|
|=
5 |rd|nd|kd|nd|rd|=
4 |pd|pd|pd|pd|pd|=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Ea Eb Ec Ed Ee

5 |bd|sd|qd|bd|sd|=
4 |pd|pd|pd|pd|pd|=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Da Db Dc Dd De

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |  |  |  |  |  |=
1 |  |  |  |  |  |=
   Ca Cb Cc Cd Ce

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |pl|pl|pl|pl|pl|=
1 |bl|sl|ql|bl|sl|=
   Ba Bb Bc Bd Be

5 |  |  |  |  |  |=
4 |  |  |  |  |  |=
3 |  |  |  |  |  |=
2 |pl|pl|pl|pl|pl|=
1 |rl|nl|kl|nl|rl|=
   Aa Ab Ac Ad Ae

| Raumschach
}}
Ea5 Eb5 Ec5 Ed5 Ee5
Ea4 Eb4 Ec4 Ed4 Ee4
Ea3 Eb3 Ec3 Ed3 Ee3
Ea2 Eb2 Ec2 Ed2 Ee2
Ea1 Eb1 Ec1 Ed1 Ee1

E
Da5 Db5 Dc5 Dd5 De5
Da4 Db4 Dc4 Dd4 De4
Da3 Db3 Dc3 Dd3 De3
Da2 Db2 Dc2 Dd2 De2
Da1 Db1 Dc1 Dd1 De1

D
Ca5 Cb5 Cc5 Cd5 Ce5
Ca4 Cb4 Cc4 Cd4 Ce4
Ca3 Cb3 Cc3 Cd3 Ce3
Ca2 Cb2 Cc2 Cd2 Ce2
Ca1 Cb1 Cc1 Cd1 Ce1

C
Ba5 Bb5 Bc5 Bd5 Be5
Ba4 Bb4 Bc4 Bd4 Be4
Ba3 Bb3 Bc3 Bd3 Be3
Ba2 Bb2 Bc2 Bd2 Be2
Ba1 Bb1 Bc1 Bd1 Be1

B
Aa5 Ab5 Ac5 Ad5 Ae5
Aa4 Ab4 Ac4 Ad4 Ae4
Aa3 Ab3 Ac3 Ad3 Ae3
Aa2 Ab2 Ac2 Ad2 Ae2
Aa1 Ab1 Ac1 Ad1 Ae1

A
Raumschach
Omega Chess – Template:Omega Chess diagram 
{{Omega Chess diagram
|
| [[Omega Chess|Omega Chess]] (10x10 + 4 corners)
|=
  w4                                   w3
   |wd|=                            |wd|=
    9 |zd|rd|nd|bd|qd|kd|bd|nd|rd|zd|=
    8 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd|=
    7 |  |  |  |  |  |  |  |  |  |  |=
    6 |  |  |  |  |  |  |  |  |  |  |=
    5 |  |  |  |  |  |  |  |  |  |  |=
    4 |  |  |  |  |  |  |  |  |  |  |=
    3 |  |  |  |  |  |  |  |  |  |  |=
    2 |  |  |  |  |  |  |  |  |  |  |=
    1 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl|=
    0 |zl|rl|nl|bl|ql|kl|bl|nl|rl|zl|=
   |wl|=                            |wl|=
  w1    a  b  c  d  e  f  g  h  i  j   w2

| '''Omega Chess''' - start position
}}
Omega Chess (10x10 + 4 corners)
w4 wd w3 wd
a9 zd b9 rd c9 nd d9 bd e9 qd f9 kd g9 bd h9 nd i9 rd j9 zd
a8 pd b8 pd c8 pd d8 pd e8 pd f8 pd g8 pd h8 pd i8 pd j8 pd
a7 b7 c7 d7 e7 f7 g7 h7 i7 j7
a6 b6 c6 d6 e6 f6 g6 h6 i6 j6
a5 b5 c5 d5 e5 f5 g5 h5 i5 j5
a4 b4 c4 d4 e4 f4 g4 h4 i4 j4
a3 b3 c3 d3 e3 f3 g3 h3 i3 j3
a2 b2 c2 d2 e2 f2 g2 h2 i2 j2
a1 pl b1 pl c1 pl d1 pl e1 pl f1 pl g1 pl h1 pl i1 pl j1 pl
a0 zl b0 rl c0 nl d0 bl e0 ql f0 kl g0 bl h0 nl i0 rl j0 zl
w1 wl w2 wl
Omega Chess - start position
Languages