Template:Chess diagram/doc

此頁面是Template:Chess diagram的Template文档。
此頁面可能包含了模板的使用說明、分類和其他内容。

此模板使用Lua语言：

Module:Chessboard（沙盒）

使用方法

這裏有幾個國際象棋圖表的模板：

Template:Chess diagram（方格大小26x26 px）
Template:Chess diagram small（方格大小22x22 px）
Template:Chess diagram 4x4（方格大小26x26 px）
Template:Chess diagram 5x5（方格大小26x26 px）
Template:Chess diagram 8x10（卡帕布蘭卡象棋，方格大小26x26 px）
Template:Chess diagram 10x10（方格大小26x26 px）
如果想顯示其它棋盤大小，就用{{#invoke:chessboard mxn|board|cols=|rows=

這裏也有為國際象棋變體而設的模版：

Template:Alice chess diagram（愛麗絲象棋，方格大小22x22 px）
Template:Omega Chess diagram (歐梅加象棋，是一個有四個角落的10x10棋盤、方格大小22x22 px）

以上模板所使用的文法，基本上是相同的。

{{Chess diagram
| <排列> (參數#1)
| <標題>    (#2) 
| size =
| numbers =
| letters =
| <a8> | <b8> | ... | <h8>  (#3 to ...
| <a7> | <b7> | ... | <h7>
...
| <a1> | <b1> | ... | <h1>  ( ... #66)
| <脚注> (#67)
| reverse = 
}}

當棋盤大小為8x8，可以用另一種文法。(see #Alternative way to place the pieces: FEN below):

{{Chess diagram
| fen =
| align =
| clear = 
| header = 
| footer =
| size =
| numbers =
| letters =
| reverse =
}}

參數：

<排列> – 「tleft」會令模板泊向左方，而「tright」則會泊向右方
<標題> – 這是會出現在棋盤上方的文字（可以留空）
size - 用像素指明每個方格的大小，預設為26
numbers - 指明代表行的數字在哪裏顯示。可以填入：left、right、both（預設）或neither。
letters - 指明代表列的字母在哪裏顯示。可以填入：top、bottom、both（預設）或neither。
<a8>, <b8>, ... <h1> – 指明對應方格顯示什麼棋子。下面有詳細說明。
<脚注> – 這是會出現在棋盤下方的文字（可以留空）

一個方格是由棋子的名稱或空白的參數定義。棋子是由代數記譜法命名：

k = 王
q = 后
r = 車（城堡）
b = 象（主教）
n = 馬（騎士）
p = 兵

這裏也有一些仙靈棋子可以使用：

a = 大主教（馬+象的合體，可以代表公主）
c = 首相（馬+車的合體，可以代表皇帝）
f = 倒轉的王（可以代表丈夫（英语：Mann (chess)））
g = 倒轉的后（可以代表蚱蜢）
m = 倒轉的車（可以代表洞屋、跳躍者、或者華西爾）
j(e) = 大象（可以代表象或者維齊爾）
N(s) = 倒轉的馬（可以代表駱駝（英语：Camel (chess)）、麒麟、夢魘、或者鳳凰）
h = 倒轉的兵（可以代表貝羅利納兵（英语：Berolina chess））
z = 歐梅加象棋的勇
w = 歐梅加象棋的巫
t = 歐梅加象棋的傻
M = 另外一個可以代表丈夫（英语：Mann (chess)）的符號
C = 亞馬遜

這些字母與「l」（代表白棋）和「d」（代表黑棋）組合來使用。所以「kl」是白王，而「nd」則是黑馬。

一個空的方格可以用下劃線、空格或者什麼都不打來表達。建議使用兩個空格。

<空格> = 空的方格

你也可以用「xx」代表黑色交叉、「ox」代表白色交叉、「xo」代表黑色圓圈或者「oo」代表白色圓圈。

xx = 黑叉
ox = 白叉
xo = 黑圈
oo = 白圈

當你想表示棋子的移動方向，就可以用箭頭：

ul = 左上
ua = 上
ur = 右上
la = 左
lr = 左右
ud = 上下
ra = 右
dl = 左下
da = 下
dr = 右下

數字也可以放入方格——「x0」代表0、「x1」代表1、「x2」代表2、⋯、「x9」代表9。

x0
x1
x2
x3
x4
x5
x6
x7
x8
x9

範例

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.

	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

The King's Gambit

{{Chess diagram
| tright
| 

|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

| The King's Gambit
}}

	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

空板

{{Chess diagram
| tright
| 

|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  

| 空板
}}

兩行脚注

W. Langstaff, Chess Amateur 1922

	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

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

|  |  |  |  |kd|  |  |rd
|  |  |  |  |  |  |  |  
|  |  |  |  |  |bl|  |pl
|  |  |  |rl|  |kl|pd|pl
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  

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

無脚注

	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

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
| 

|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |xx|xo|xx|  |  |  |  
|  |  |pl|  |  |  |  |  
|  |  |  |  |  |xo|  |  
|  |  |  |  |xx|xo|xx|  
|  |  |  |  |  |pl|  |  
|  |  |  |  |  |  |  |  

}}

Movement example

This can be used to show how pieces move.

	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

Example showing how white king can move

any direction, but only one square, while black rook can move any number of squares but only up and down, and right and left.

{{Chess diagram 
| tleft
| 

|  |  |ua|  |  |  |  |  
|  |  |ua|  |  |  |  |  
|la|la|rd|ra|ra|ra|ra|ra
|  |  |da|  |  |  |  |  
|  |  |da|  |ul|ua|ur|  
|  |  |da|  |la|kl|ra|  
|  |  |da|  |dl|da|dr|  
|  |  |da|  |  |  |  |  

|Example showing how white king can move
any direction, but only one square, while
black rook can move any number of squares
but only up and down, and right and left.
}}

	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

{{Chess diagram
| tright
| 

|  |ul|  |ua|  |ur|  |  
|  |  |ul|ua|ur|  |  |  
|la|la|la|ql|ra|ra|ra|ra
|  |  |dl|da|dr|  |  |  
|  |dl|  |da|  |dr|  |  
|dl|  |  |da|  |  |dr|  
|  |  |  |da|  |  |  |dr
|  |  |  |da|  |  |  |  

}}

In the board on the right, it is shown that the white queen can go any distance in any of these directions.

Another method for the rook example:

	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

{{Chess diagram
| tleft
| 

|  |  |  |  |  |  |  |  
|  |  |ud|  |  |  |  |  
|  |lr|rd|lr|  |  |  |  
|  |  |ud|  |  |  |  |  
|  |  |  |  |ul|ua|ur|  
|  |  |  |  |la|kl|ra|  
|  |  |  |  |dl|da|dr|  
|  |  |  |  |  |  |  |  

}}

小图

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.

	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

Position after 11.Bg5

{{Chess diagram small
| tright
| 

|rd|  |  |qd|  |rd|kd|  
|pd|pd|  |  |pd|pd|bd|pd
|  |nd|pd|  |  |nd|pd|  
|  |  |ql|  |  |  |bl|  
|  |  |  |pl|pl|  |bd|  
|  |  |nl|  |  |nl|  |  
|pl|pl|  |  |  |pl|pl|pl
|  |  |  |rl|kl|bl|  |rl

| Position after 11.Bg5
}}

不同板子尺寸

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

Minichess (5×5) – Template:Chess diagram 5x5

{{Chess diagram 5x5
| tright
| 

|kd|qd|bd|nd|rd
|pd|pd|pd|pd|pd
|  |  |  |  |  
|pl|pl|pl|pl|pl
|kl|ql|bl|nl|rl

| Gardner minichess
}}

Gardner minichess

Capablanca Chess (8×10)

{{Chess diagram 8x10
| tright
| 

|rd|nd|ad|bd|qd|kd|bd|cd|nd|rd
|pd|pd|pd|pd|pd|pd|pd|pd|pd|pd
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|pl|pl|pl|pl|pl|pl|pl|pl|pl|pl
|rl|nl|al|bl|ql|kl|bl|cl|nl|rl

| Capablanca Chess
}}

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

Capablanca Chess

Grand Chess

{{Chess diagram 10x10
| tright
| 

|rd|  |  |  |  |  |  |  |  |rd
|  |nd|bd|qd|kd|cd|ad|bd|nd|  
|pd|pd|pd|pd|pd|pd|pd|pd|pd|pd
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|pl|pl|pl|pl|pl|pl|pl|pl|pl|pl
|  |nl|bl|ql|kl|cl|al|bl|nl|  
|rl|  |  |  |  |  |  |  |  |rl

| Grand Chess
}}

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

Grand Chess

Alice Chess

Alice Chess (two players)

{{alice chess diagram
| tright
|

|rd|nd|bd|qd|kd|  |nd|rd
|pd|pd|pd|pd|  |pd|pd|pd
|  |  |  |  |  |  |  |  
|  |  |  |  |nl|  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|pl|pl|pl|pl|pl|pl|pl|pl
|rl|nl|bl|ql|kl|bl|  |rl

|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |pd|  |  |  
|  |  |bd|  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  

| Position after '''1. Nf3 e6 2. Ne5 Bc5'''
}}

A

B

Position after 1. Nf3 e6 2. Ne5 Bc5

Different shaped board

Omega Chess – Template:Omega Chess diagram

{{Omega Chess diagram
|
| [[Omega Chess]] (10×10 + 4 corners)

|wd                              |wd
   |zd|rd|nd|bd|qd|kd|bd|nd|rd|zd
   |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd
   |  |  |  |  |  |  |  |  |  |  
   |  |  |  |  |  |  |  |  |  |  
   |  |  |  |  |  |  |  |  |  |  
   |  |  |  |  |  |  |  |  |  |  
   |  |  |  |  |  |  |  |  |  |  
   |  |  |  |  |  |  |  |  |  |  
   |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl
   |zl|rl|nl|bl|ql|kl|bl|nl|rl|zl
|wl                              |wl

| '''Omega Chess''' starting position
}}

Omega Chess (10x10 + 4 corners)

	<W4 A	B	C	D	E	F	G	H	I	W3> J
9											9
8											8
7											7
6											6
5											5
4											4
3											3
2											2
1											1
0											0
	A <W1	B	C	D	E	F	G	H	I	J W2>

Omega Chess starting position

Alternative way to place the pieces: FEN

{{Chess diagram|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

It is possible to populate the board using Forsyth–Edwards Notation, instead of positional parameters.

To do this, the "fen" parameter is used. For instance, this is the opening board of a chess game, defined using the "fen" parameter "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR":

{{Chess diagram|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

It is also possible to show "fairy" pieces using the FEN notation. However, because the FEN notation uses uppercase and lowercase to denote the color of the piece, it is not possible to display the inverted knight fairy piece (denoted by "N") using the fen parameter. Here is a board where the pawns are replaced by fairy pieces:

Only 8x8 boards can use the "fen" parameter. For other size boards, positional parameters should be used.

Displaying the board from the Black's point of view

{{Chess diagram|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

The "reverse=true" parameter causes the board to be shown from Black's point of view, that is, with the h8 square at lower-left corner, and a1 at the upper-right. This works for all sizes of the normal chessboard template, but not for the Alice, Bughouse, Omega, or Raumschach templates. Here, the same FEN notation as in the previous example produces a board with Black's starting position at the bottom.

參見

{{Xiangqi diagram}}