Sjabloon:Skaakdiagram/doc

Sintaks

daar is verskeie standaard skaakdiagram sjablone:

• Template:Skaakdiagram (vierkantgrootte 26x26 px)
• Template:Skaakdiagram-klein (vierkantgrootte 22x22 px)
• Template:Skaakdiagram 5x5; Sjabloon:Skaakdiagram 6x6 (groter, 26px vierkante; kan gebruik word vir óf kleiner dele van die bord, óf die bord wat vir Miniskaak en Los Alamosskaak gebruik word)

Daar is ook sjablone vir skaakvariante:

• Template:Chess diagram 8x10 (Capablanca chess with ten columns, 26x26 px)
• Template:Raumschach diagram (5x5x5 board for Three-dimensional chess, 22x22 px)
• Template:Omega Chess diagram (Omega Chess with 10x10 board + 4 corners, 22x22 px)

Die sintaks is dieselfde vir almal.

{{Skaakdiagram| <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

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.

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.

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}}

Diagram with both captions

W. Langstaff, Chess Amateur 1922

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

Diagram without captions

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  }}

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.

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

Different board size

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

{{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}}

{{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}}

{{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}}

{{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}}

Double boards

{{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'''}}

{{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'''.}}

Different shaped board

{{Raumschach diagram| tright||=5 |rd|nd|kd|nd|rd|=4 |pd|pd|pd|pd|pd|=3 |  |  |  |  |  |=2 |  |  |  |  |  |=1 |  |  |  |  |  |=   Ea Eb Ec Ed Ee5 |bd|sd|qd|bd|sd|=4 |pd|pd|pd|pd|pd|=3 |  |  |  |  |  |=2 |  |  |  |  |  |=1 |  |  |  |  |  |=   Da Db Dc Dd De5 |  |  |  |  |  |=4 |  |  |  |  |  |=3 |  |  |  |  |  |=2 |  |  |  |  |  |=1 |  |  |  |  |  |=   Ca Cb Cc Cd Ce5 |  |  |  |  |  |=4 |  |  |  |  |  |=3 |  |  |  |  |  |=2 |pl|pl|pl|pl|pl|=1 |bl|sl|ql|bl|sl|=   Ba Bb Bc Bd Be5 |  |  |  |  |  |=4 |  |  |  |  |  |=3 |  |  |  |  |  |=2 |pl|pl|pl|pl|pl|=1 |rl|nl|kl|nl|rl|=   Aa Ab Ac Ad Ae| Raumschach}}

{{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}}