Этот шаблон реализован на основе Lua с использованием модуля Произвольная шахматная доска .

Общая информация

Данная серия шаблонов создана на основе модуля " Произвольная шахматная доска ", представляющего собой переработанный англоязычный модуль с увеличенным функционалом и адаптацией под грамматику русского языка. Серия состоит из следующих шаблонов со сходным синтаксисом:

• Шаблон:Шахматная диаграмма 5x5
• Шаблон:Шахматная диаграмма 7x7
• Шаблон:Шахматная диаграмма 8x8
• Шаблон:Шахматная диаграмма 9x9
• Шаблон:Шахматная диаграмма 10x8
• Шаблон:Шахматная диаграмма 10x10
• Шаблон:Шашечная диаграмма 10x10
• Шаблон:Шахматная диаграмма 12x12

Частные особенности отдельных шаблонов указаны в конце данной документации.

Общий синтаксис

Синтаксис шаблона выглядит следующим образом:

{{Шахматная диаграмма 8x8
|<выравнивание>
|<заголовок>
|<a8>|<b8>|<c8>|<d8>|<e8>|<f8>|<g8>|<h8>
|<a7>|<b7>|<c7>|<d7>|<e7>|<f7>|<g7>|<h7>
...
|<a2>|<b2>|<c2>|<d2>|<e2>|<f2>|<g2>|<h2>
|<a1>|<b1>|<c1>|<d1>|<e1>|<f1>|<g1>|<h1>
|<подпись>
}}

Параметр <выравнивание> должен иметь значение tleft (для выравнивания по левому краю) или tright (для выравнивания по правому краю). Параметр <заголовок> содержит текст заголовка, отображаемого над доской. Параметр <подпись> содержит текст подписи, отображаемой под доской.

Вместо <a1>, <a2>, ..., <e4>, <e5> подставляются коды фигур, находящихся на соответствующих клетках участка игровой доски. Код фигуры представляет собой два символа, первый из которых обозначает тип фигуры, а второй - её цвет. Коды стандартных шахматных фигур соответствуют международной шахматной нотации (в нижнем регистре), цвет фигуры обозначается символом d (dark, чёрные) или l (light, белые). Таким образом:

• kl - белый король
• kd - чёрный король
• ql - белый ферзь
• qd - чёрный ферзь
• rl - белая ладья
• rd - чёрная ладья
• bl - белый слон
• bd - чёрный слон
• nl - белый конь
• nd - чёрный конь
• pl - белая пешка
• pd - чёрная пешка

Чтобы оставить клетку доски пустой, достаточно ничего в неё не вписывать (или вписать пробелы).

Пример для выравнивания по левому краю:

{{Шахматная диаграмма 8x8
|tleft
|Диаграмма №1
|  |  |  |rd|kd|  |  |
|  |  |  |nd|  |  |  |
|  |  |  |  |  |  |  |
|ql|pl|  |  |  |  |  |
|kl|  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|Подпись}}

Пример для выравнивания по правому краю:

{{Шахматная диаграмма 8x8
|tright
|Диаграмма №2
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|pl|pl|pl|pl|pl|pl|pl|pl
|rl|nl|bl|ql|kl|bl|nl|rl
|Подпись}}

Важно! коды фигур регистрозависимые. То есть писать QL, Ql, qL вместо ql нельзя.

Заголовок, подписи

При использовании шаблона допускается игнорирование заголовка и(или) подписи. Для этого вместо них достаточно ничего не вписывать. Например:

{{Шахматная диаграмма 5x5
|tleft
|
|  |  |  |  |  
|  |  |  |  |  
|  |kl|  |bl|  
|  |  |  |bl|  
|kd|  |  |  |  
|}}

Дополнительные фигуры

Помимо стандартных допускается использование следующих фигур:

• fl, fd - перевёрнутый король
• gl, gd - перевёрнутый ферзь
• ml, md - перевёрнутая ладья
• el, ed - перевёрнутый слон
• sl, sd - перевёрнутый конь
• hl, hd - перевёрнутая пешка
• al, ad - архиепископ (см. Шахматы Капабланки , Шахматы Карреры )
• cl, cd - канцлер (см. Шахматы Капабланки , Шахматы Карреры )
• zl, zd - чемпион (см. Омега-шахматы )
• wl, wd - колдун (см. Омега-шахматы )
• tl, td - шут (см. Омега-шахматы )
• Gl, Gd - жираф
• Ul, Ud - единорог
• Zl, Zd - зебра

Пример:

{{Шахматная диаграмма 8x8
|tleft
|
|  |al|ad|  |  |fl|fd|
|  |cl|cd|  |  |gl|gd|
|  |zl|zd|  |  |sl|sd|
|  |wl|wd|  |  |el|ed|
|  |tl|td|  |  |hl|hd|
|  |Gl|Gd|  |  |Ul|Ud|
|  |Zl|Zd|  |  |  |  |
|  |  |  |  |  |  |  |
|}}

Шашки

• j0 - чёрная шашка
• j1 - белая шашка
• D0 - чёрная дамка
• D1 - белая дамка

Пример:

{{Шахматная диаграмма 8x8
|tleft
|
|  |j0|  |j0|  |j0|  |j0
|j0|  |j0|  |j0|  |j0|  
|  |D0|  |D0|  |D0|  |D0
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|D1|  |D1|  |D1|  |D1|
|  |j1|  |j1|  |j1|  |j1
|j1|  |j1|  |j1|  |j1|
|}}

Дополнительные обозначения

Для рисования диаграмм могут использоваться следующие обозначения на доске:

• xx - чёрный крест
• ox - белый крест
• xo - чёрный круг
• oo - белый круг
• ua - стрелка вверх
• da - стрелка вниз
• ra - стрелка вправо
• la - стрелка влево
• ul - стрелка влево вверх
• ur - стрелка вправо вверх
• dl - стрелка влево вниз
• dr - стрелка вправо вниз
• lr - стрелки влево и вправо
• ud - стрелки вверх и вниз
• db - стрелки вправо вверх и влево вниз
• dw - стрелки влево вверх и вправо вниз
• x1 - цифра 1
• x2 - цифра 2
• x3 - цифра 3
• x4 - цифра 4
• x5 - цифра 5
• x6 - цифра 6
• x7 - цифра 7
• x8 - цифра 8
• x9 - цифра 9
• x0 - цифра 0
• O0 - чёрный круг
• O1 - белый круг
• O2 - красный круг
• O3 - зелёный круг
• O4 - синий круг
• O5 - бирюзовый круг
• O6 - жёлтый круг
• O7 - розовый круг
• O8 - коричневый круг
• O9 - фиолетовый круг

Примеры:

{{Шахматная диаграмма 5x5
|tleft|
|  |  |  |  |  
|xx|  |xx|  |  
|  |  |  |xx|  
|  |nl|  |  |  
|  |  |  |xx|  
|Ход конём}}

{{Шахматная диаграмма 5x5
|tleft|
|la|la|la|la|rd
|  |  |  |ur|da
|ul|  |ur|  |da
|  |bl|  |  |da
|dl|  |dr|  |da
|}}

{{Шахматная диаграмма 8x8
|tleft|
|O0|O1|O2|O3|O4|O5|O6|O7
|  |  |  |  |  |  |  |  
|O8|O9|x0|x1|x2|x3|x4|x5
|  |  |  |  |  |  |  |  
|x6|x7|x8|x9|xo|ox|xx|oo
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|}}

Нумерация клеток

При необходимости можно добавить или убрать нумерацию клеток доски. За это отвечают параметры letters (буквы) и numbers (цифры). Параметры могут принимать следующие значения:

letters:

• none - нигде (по умолчанию)
• top - сверху
• bottom - снизу
• both - сверху и снизу

numbers:

• none - нигде (по умолчанию)
• left - слева
• right - справа
• both - слева и справа

Примеры:

{{Шахматная диаграмма 8x8
|tleft
|letters=none
|numbers=none
|Диаграмма
|  |  |  |  |  |  |  |
|  |kl|  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|}}

{{Шахматная диаграмма 5x5
|tleft
|numbers=left
|letters=bottom
|
|  |  |  |  |
|  |kl|  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|}}

{{Шахматная диаграмма 5x5
|tleft
|numbers=both
|letters=both
|
|  |  |  |  |
|  |kl|  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|}}

Шашечная нумерация

При помощи параметра numeration можно изменить способ нумерации клеток. Указанный параметр может принимать следующие значения:

• chess - шахматная нумерация (значение по умолчанию)
• continuous - сквозная нумерация всех клеток доски
• draughts - нумерация только чёрных клеток доски
• swapdraughts - нумерация только белых клеток доски.

Примеры:

{{Шахматная диаграмма 10x10
|tleft
|numeration=draughts
|Международные шашки
|  |j0|  |j0|  |j0|  |j0|  |j0
|j0|  |j0|  |j0|  |j0|  |j0|
|  |j0|  |j0|  |j0|  |j0|  |j0
|j0|  |j0|  |j0|  |j0|  |j0|
|  |  |  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  |  |  
|  |j1|  |j1|  |j1|  |j1|  |j1
|j1|  |j1|  |j1|  |j1|  |j1|
|  |j1|  |j1|  |j1|  |j1|  |j1
|j1|  |j1|  |j1|  |j1|  |j1|
|Начальная позиция
}}

{{Шахматная диаграмма 8x8
|tleft
|numeration=swapdraughts
|Испанские шашки
|j0|  |j0|  |j0|  |j0|  
|  |j0|  |j0|  |j0|  |j0
|j0|  |j0|  |j0|  |j0|  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |j1|  |j1|  |j1|  |j1
|j1|  |j1|  |j1|  |j1|  
|  |j1|  |j1|  |j1|  |j1
|Начальная позиция}}

{{Шахматная диаграмма 8x8
|tleft
|numeration=continuous
|Сквозная нумерация
|  |j0|  |j0|  |j0|  |j0
|j0|  |j0|  |j0|  |j0|  
|  |j0|  |j0|  |j0|  |j0
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|j1|  |j1|  |j1|  |j1|  
|  |j1|  |j1|  |j1|  |j1
|j1|  |j1|  |j1|  |j1|  
|}}

Смещение доски

По умолчанию в шаблоне отображается участок доски от угла с клеткой A1 (координаты клеток отображаются при наведении на них курсора мыши). Однако имеется возможность отображать участок шахматной доски с произвольным смещением. Смещение по горизонтали (вдоль оси букв) и вертикали (вдоль оси цифр) относительно клетки A1 задаётся параметрами offsetx и offsety. Значения указанных параметров по умолчанию равны нулю. Примеры:

{{Шахматная диаграмма 5x5
|tleft
|offsetx=0
|offsety=0
|letters=bottom
|numbers=left
|
|  |  |  |  |
|  |kl|  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|Ничего не изменилось, король на B4}}

{{Шахматная диаграмма 5x5
|tleft
|offsetx=1
|offsety=0
|letters=bottom
|numbers=left
|
|  |  |  |  |
|  |kl|  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|Смещение по горизонтали на 1 клетку, король на C4}}

{{Шахматная диаграмма 5x5
|tleft
|offsetx=0
|offsety=3
|letters=bottom
|numbers=left
|
|  |  |  |  |
|  |kl|  |  |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|Смещение по вертикали на 3 клетки (левый верхний угол доски), король на B7}}

При смещении доски чёрные и белые клетки соответствуют реальной шахматной доске. Также допускается сдвиг за пределы стандартной игровой доски 8x8, при этом, если для обозначения столбцов не хватит букв английского алфавита, они будут обозначаться парой букв. Пример:

{{Шахматная диаграмма 8x8
|tleft
|offsetx=20
|offsety=20
|
|  |  |  |  |  |  |  |
|  |kl|  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|}}

Поворот доски

При необходимости можно осуществить поворот доски на 180 градусов. Для этого используется параметр reverse со значением true. Пример:

{{Шахматная диаграмма 8x8
|tleft
|reverse=true
|
|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
|}}

При этом можно одновременно использовать поворот и смещение доски. Например:

{{Шахматная диаграмма 5x5
|tleft
|letters=top
|numbers=right
|reverse=true
|offsetx=3
|offsety=3
|
|qd|kd|bd|nd|rd
|pd|pd|pd|pd|pd
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |
|}}

Важно! при повороте доски "поворачивается" не только нумерация, но и сама доска с фигурами. То есть в шаблоне фигуры нужно расставлять так, как их видит игрок, играющий белыми (без разворота доски).

Инверсия цветов клеток

При необходимости возможна инверсия цветов клеток: белые клетки при этом становятся чёрными и наоборот. Для этого необходимо использовать параметр lightdark со значением swap. Например:

{{Шахматная диаграмма 8x8
|tright
|numbers=none
|letters=none
|lightdark=swap
|'''Португальские шашки'''
|j0|  |j0|  |j0|  |j0|  
|  |j0|  |j0|  |j0|  |j0
|j0|  |j0|  |j0|  |j0|  
|  |  |  |  |  |  |  |  
|  |  |  |  |  |  |  |  
|  |j1|  |j1|  |j1|  |j1
|j1|  |j1|  |j1|  |j1|  
|  |j1|  |j1|  |j1|  |j1
|Начальная позиция}}

Такая инверсия соответствует повороту доски на 90 градусов и используется, например, в итальянских или португальских шашках.

Выделение клеток

При необходимости можно выделить клетки, в которых находятся фигуры или пешки. Для этого код их цвета необходимо указать прописной буквой (D или L вместо d или l). Например:

{{Шахматная диаграмма 5x5
|tleft
|
|  |xx|  |xx|
|xx|  |  |  |xx
|  |  |nd|  |
|pL|pl|pl|pl|pL
|rl|nL|bl|kL|ql
|}}

Масштаб доски

По умолчанию размер одной клетки - 24 пиксела. Однако этот размер можно уменьшить или увеличить при помощи параметра size. Примеры:

{{Шахматная диаграмма 5x5
|tleft
|size=16
|
|  |  |  |rd|kd
|  |  |  |nd|  
|  |  |  |  |  
|ql|pl|  |  |  
|kl|  |  |  |  
|}}

{{Шахматная диаграмма 5x5
|tleft
|size=48
|
|  |  |  |rd|kd
|  |  |  |nd|  
|  |  |  |  |  
|ql|pl|  |  |  
|kl|  |  |  |  
|}}

Частные особенности шаблонов

Шахматная диаграмма 5x5

• Размер доски - 5x5
• По умолчанию не отображается нумерация строк и столбцов

Шахматная диаграмма 6x6

• Размер доски - 6x6 (используется, в частности, в шахматах Лос-Аламоса )
• По умолчанию отображается нумерация строк и столбцов со всех сторон доски

Шахматная диаграмма 7x7

• Размер доски - 7x7 (используется, в частности, в Ласке )
• По умолчанию не отображается нумерация строк и столбцов

Шахматная диаграмма 8x8

• Размер доски - 8x8
• По умолчанию отображается нумерация строк и столбцов со всех сторон доски
• Возможно использование нотации Форсайта—Эдвардса (FEN)

Нотация Форсайта — Эдвардса

При использовании шаблона размера 8x8 возможно использование нотации FEN, для чего используется параметр fen. При этом вся информация, указываемая по правилам нотации после пробелов (сведения об очередности хода, возможности рокировок и т.д. игнорируется). При использовании параметра fen не следует указывать фигуры стандартным методом. Примеры:

{{Шахматная диаграмма 8x8
|tleft
|fen=rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1
|Нотация FEN
|Начальная позиция}}

{{Шахматная диаграмма 8x8
|tleft
|reverse=true
|fen=r1b2rk1/pp2qpp1/1bn2n1p/4p1N1/8/P1N1P3/1PQBBPPP/R2R2K1
|'''[[Флор,_Саломон_Михайлович|Флор]] — [[Гильг,_Карл|Гильг]]'''<br>1934
|Ход белых, вид со стороны чёрных}}

Шахматная диаграмма 10x8

• Размер доски - 10x8 (используется, в частности, в шахматах Капабланки , шахматах Карреры )
• По умолчанию отображается нумерация строк и столбцов со всех сторон доски

Шахматная диаграмма 10x10

• Размер доски - 10x10 (используется, в частности, в Великих шахматах и Больших шахматах )
• По умолчанию отображается нумерация строк и столбцов со всех сторон доски

Шашечная диаграмма 10x10

• Размер доски - 10x10 (используется, в частности, в международных шашках )
• По умолчанию отображается шашечная нумерация
• Допускается использование упрощённых обозначений:
  • x - чёрная шашка
  • o - белая шашка
  • X - чёрная дамка
  • O - белая дамка

Шахматная диаграмма 12x12

• Размер доски - 12x12 (используется, в частности, в Канадских шашках )
• По умолчанию не отображается нумерация строк и столбцов
• Размер одной клетки доски - 18px.