Szablon:Szachownica

Z Wikipedii, wolnej encyklopedii
Przejdź do nawigacji Przejdź do wyszukiwania
ABCDEFGH
8
Chessboard480.svg
8
77
66
55
44
33
22
11
ABCDEFGH
Template-info.png Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

Użycie[edytuj kod]

Poniższy kod jest wzorem, na którym można w łatwy sposób utworzyć szablon szachownicy:

{{Szachownica
| tright/tleft
| tytuł
<!--  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 -->
| podpis
}}

Jeśli plansza ma przedstawiać warcabnicę, należy dopisać w argumentach: game = Draughts.

Opis parametrów[edytuj kod]

{{Szachownica
| size = <rozmiar>
| reversed = <odwrócony>
| letters = <litery>
| numbers = <liczby>
| game = <rodzaj gry>
| <wyrównanie>
| <tytuł>
<!--   a    b    c    d    e    f    g    h
8 -->|<a8>|<b8>|<c8>|<d8>|<e8>|<f8>|<g8>|<h8><!-- 8
7 -->|<a7>|<b7>|<c7>|<d7>|<e7>|<f7>|<g7>|<h7><!-- 7
6 -->|<a6>|<b6>|<c6>|<d6>|<e6>|<f6>|<g6>|<h6><!-- 6
5 -->|<a5>|<b5>|<c5>|<d5>|<e5>|<f5>|<g5>|<h5><!-- 5
4 -->|<a4>|<b4>|<c4>|<d4>|<e4>|<f4>|<g4>|<h4><!-- 4
3 -->|<a3>|<b3>|<c3>|<d3>|<e3>|<f3>|<g3>|<h3><!-- 3
2 -->|<a2>|<b2>|<c2>|<d2>|<e2>|<f2>|<g2>|<h2><!-- 2
1 -->|<a1>|<b1>|<c1>|<d1>|<e1>|<f1>|<g1>|<h1><!-- 1
       a    b    c    d    e    f    g    h -->
| <podpis>
}}
Parametry
  • <rozmiar> – definiuje rozmiar planszy, należy podać rozmiar pola szachownicy w pikselach.
  • <odwrócona> – określa, czy plansza jest odwrócona, należy tutaj podać true (plansza jest odwrócona) lub false (tak jak domyślnie). Atrybut reverse można pominąć, w tym przypadku plansza nie będzie odwrócona.
  • <litery> – określa, w po jakich stronach są nazywane kolumny. Należy podać: top (jest na górze), bottom (na dole), both (po obu stronach), lub neither (nigdzie).
  • <liczby> – określa, w po jakich stronach są nazywane wiersze. Należy podać: left (jest po lewej stronie), bottom (po prawej), both (po obu stronach), lub neither (nigdzie).
  • <rodzaj gry> – określa grę, którą przedstawia szablon, należy tutaj podać chess (szachy) lub draughts (warcaby). Atrybut game można pominąć, wtedy domyślnie jest ustawione jako chess.
  • <wyrównanie> – definiuje wyrównanie diagramu w poziomie, należy tu podać tright (diagram zostanie umieszczony po prawej stronie tekstu) lub tleft (po lewej stronie). Tutaj można pominąć argument (zostawić pusty atrybut), wtedy domyślnie jest ustawione jako tright.
  • <tytuł> – tekst, który pojawi się nad ramką z diagramem, może być pusty
  • <a1>, <b1><h8> – definicje kolejnych pól szachownicy (szczegóły poniżej)

Argumenty dotyczące pól szachowych[edytuj kod]

Figury[edytuj kod]

Argumentem może być kod, którego pierwszy znak określa figurę (patrz poniżej), a drugi znak określa kolor (l – biały / d – czarny). Na przykład pl oznacza biały pionek w szachach.

Ikony w szachach
Znak Znaczenie Ikona
Podstawowe figury
p Pionek Chess pdt45.svg
r Wieża Chess rdt45.svg
n Skoczek Chess ndt45.svg
b Goniec Chess bdt45.svg
q Hetman Chess qdt45.svg
k Król Chess kdt45.svg
Dodatkowe figury
a Arcybiskup Chess adt45.svg
c Kanclerz Chess cdt45.svg
z Mistrz Chess zdt45.svg
w Czarnoksiężnik Chess wdt45.svg
t Błazen Chess tdt45.svg
M Strażnik Chess Mdt45.svg
e Słoń Chess edt45.svg
s Łódź Chess sdt45.svg
D Smok Chess Ddt45.svg
G Żyrafa Chess Gdt45.svg
U Jednorożec Chess Udt45.svg
Z Zebra Chess Zdt45.svg
Odwrócone figury
h Pionek Chess hdt45.svg
m Wieża Chess mdt45.svg
N Skoczek Chess Ndt45.svg
B lub j Goniec Chess Bdt45.svg
g Hetman Chess gdt45.svg
f Król Chess fdt45.svg
Ikony w warcabach
Znak Znaczenie Ikona
m Pionek Draughts mdt45.svg
k Damka Draughts kdt45.svg

Znaki specjalne[edytuj kod]

Na szachownicy mogą zostać użyte również inne znaki, które opisują m. in. możliwe ruchy figur. Jako argument należy podać ciąg dwóch znaków. Oznaczenie każdego jest podane poniżej:

Ciąg Znaczenie Zastosowanie Ikona
xx Czarny krzyżyk Możliwe bicie Chess xxt45.svg
ox Biały krzyżyk Chess oxt45.svg
xo Czarne kółko Możliwy ruch Chess xot45.svg
oo Białe kółko Chess oot45.svg
ul Strzałki Chess ult45.svg
ua Chess uat45.svg
ur Chess urt45.svg
la Chess lat45.svg
ra Chess rat45.svg
dl Chess dlt45.svg
da Chess dat45.svg
dr Chess drt45.svg
lr Chess lrt45.svg
ud Chess udt45.svg
x0 Zero Chess x0t45.svg
x1 Jeden Chess x1t45.svg
x2 Dwa Chess x2t45.svg
x3 Trzy Chess x3t45.svg
x4 Cztery Chess x4t45.svg
x5 Pięć Chess x5t45.svg
x6 Sześć Chess x6t45.svg
x7 Siedem Chess x7t45.svg
x8 Osiem Chess x8t45.svg
x9 Dziewięć Chess x9t45.svg

Przykłady[edytuj kod]

Użycie szablonów najlepiej zilustrują przykłady. Porównaj diagramy z umieszczonym poniżej kodem, który je generuje. Łatwą metodą umieszczenia własnego diagramu jest skopiowanie tego kodu, wklejenie do swojego artykułu i dokonanie odpowiednich modyfikacji.

W poniższych przykładach rzędy i kolumny szachownicy są oznaczone cyframi i literami dla lepszej orientacji. Ponieważ dowolny tekst umieszczony pomiędzy "|=" i następnym "|" jest ignorowany (traktowany jak komentarz), oznaczenie rzędów i kolumn nie ma wpływu na wygląd diagramu.

Praktyczne rady:

  • zwróć uwagę na to, by nie naruszyć ogólnego schematu, w szczególności pozostaw znaki "|" i "=" na swoim miejscu,
  • nie można użyć znaku "|" w tytule lub podpisie,
  • jeśli istnieje konieczność użycia znaku "=" w tytule lub podpisie, musi on być zawarty pomiędzy znacznikami nowiki i /nowiki,
  • w tytule i podpisie można użyć pogrubioną lub pochyłą czcionkę.

Standardowy diagram[edytuj kod]

ABCDEFGH
8
Chessboard480.svg
A8 – Czarna wieża
B8 – Czarny skoczek
C8 – Czarny goniec
D8 – Czarny hetman
E8 – Czarny król
F8 – Czarny goniec
G8 – Czarny skoczek
H8 – Czarna wieża
A7 – Czarny pionek
B7 – Czarny pionek
C7 – Czarny pionek
D7 – Czarny pionek
F7 – Czarny pionek
G7 – Czarny pionek
H7 – Czarny pionek
E5 – Czarny pionek
E4 – Biały pionek
F4 – Biały pionek
A2 – Biały pionek
B2 – Biały pionek
C2 – Biały pionek
D2 – Biały pionek
G2 – Biały pionek
H2 – Biały pionek
A1 – Biała wieża
B1 – Biały skoczek
C1 – Biały goniec
D1 – Biały hetman
E1 – Biały król
F1 – Biały goniec
G1 – Biały skoczek
H1 – Biała wieża
8
77
66
55
44
33
22
11
ABCDEFGH
Gambit królewski

Jest to podstawowy rodzaj diagramu szachowego. Zaleca się stosowanie tego diagramu w artykułach o otwarciach szachowych, końcówkach, partiach, pozycjach itp. Porównaj kod umieszczony poniżej diagramu.

{{Szachownica
| tright
| 
<!--  a  b  c  d  e  f  g  h
8 -->|rd|nd|bd|qd|kd|bd|nd|rd<!-- 8
7 -->|pd|pd|pd|pd|  |pd|pd|pd<!-- 7
6 -->|  |  |  |  |  |  |  |  <!-- 6
5 -->|  |  |  |  |pd|  |  |  <!-- 5
4 -->|  |  |  |  |pl|pl|  |  <!-- 4
3 -->|  |  |  |  |  |  |  |  <!-- 3
2 -->|pl|pl|pl|pl|  |  |pl|pl<!-- 2
1 -->|rl|nl|bl|ql|kl|bl|nl|rl<!-- 1
      a  b  c  d  e  f  g  h -->
| Gambit królewski
}}


Diagram z tytułem[edytuj kod]

W. Langstaff
Chess Amateur 1922
ABCDEFGH
8
Chessboard480.svg
E8 – Czarny król
H8 – Czarna wieża
F6 – Biały goniec
H6 – Biały pionek
D5 – Biała wieża
F5 – Biały król
G5 – Czarny pionek
H5 – Biały pionek
8
77
66
55
44
33
22
11
ABCDEFGH
Mat w dwóch posunięciach.
Przykład uzycia analizy wstecznej.

Ten rodzaj diagramu może być szczególnie przydatny w artykułach o kompozycjach szachowych. Warto zwrócić uwagę, jak w opisach użyć pogrubionej i pochyłej czcionki, a także znacznika "<br>" w celu umieszczenia tekstu w więcej niż jednym wierszu.

{{Szachownica
| tright
| '''W. Langstaff'''<br />''Chess Amateur'' 1922
<!--  a  b  c  d  e  f  g  h
8 -->|  |  |  |  |kd|  |  |rd<!-- 8
7 -->|  |  |  |  |  |  |  |  <!-- 7
6 -->|  |  |  |  |  |bl|  |pl<!-- 6
5 -->|  |  |  |rl|  |kl|pd|pl<!-- 5
4 -->|  |  |  |  |  |  |  |  <!-- 4
3 -->|  |  |  |  |  |  |  |  <!-- 3
2 -->|  |  |  |  |  |  |  |  <!-- 2
1 -->|  |  |  |  |  |  |  |  <!-- 1
      a  b  c  d  e  f  g  h -->
| '''Mat w dwóch posunięciach.'''<br />Przykład uzycia ''analizy wstecznej''.
}}


Diagram bez tytułu i podpisu[edytuj kod]

ABCDEFGH
8
Chessboard480.svg
B6 – Czarny krzyżyk
C6 – Czarne kółko
D6 – Czarny krzyżyk
C5 – Biały pionek
F4 – Czarne kółko
E3 – Czarny krzyżyk
F3 – Czarne kółko
G3 – Czarny krzyżyk
F2 – Biały pionek
8
77
66
55
44
33
22
11
ABCDEFGH

Porównaj kod poniżej diagramu. Pole tytułu i podpisu można pozostawić puste, jednak odpowiednie znaki "|" koniecznie należy pozostawić na swoim miejscu. Diagram umieszczono po lewej stronie aby zilustrować użycie pierwszego parametru.

{{Szachownica
| tright
| 
<!--  a  b  c  d  e  f  g  h
8 -->|  |  |  |  |  |  |  |  <!-- 8
7 -->|  |  |  |  |  |  |  |  <!-- 7
6 -->|  |xx|xo|xx|  |  |  |  <!-- 6
5 -->|  |  |pl|  |  |  |  |  <!-- 5
4 -->|  |  |  |  |  |xo|  |  <!-- 4
3 -->|  |  |  |  |xx|xo|xx|  <!-- 3
2 -->|  |  |  |  |  |pl|  |  <!-- 2
1 -->|  |  |  |  |  |  |  |  <!-- 1
      a  b  c  d  e  f  g  h -->
| 
}}


Szczególne zastosowania[edytuj kod]

Mały diagram[edytuj kod]

ABCDEFGH
8
Chessboard480.svg
A8 – Czarna wieża
D8 – Czarny hetman
F8 – Czarna wieża
G8 – Czarny król
A7 – Czarny pionek
B7 – Czarny pionek
E7 – Czarny pionek
F7 – Czarny pionek
G7 – Czarny goniec
H7 – Czarny pionek
B6 – Czarny skoczek
C6 – Czarny pionek
F6 – Czarny skoczek
G6 – Czarny pionek
C5 – Biały hetman
G5 – Biały goniec
D4 – Biały pionek
E4 – Biały pionek
G4 – Czarny goniec
C3 – Biały skoczek
F3 – Biały skoczek
A2 – Biały pionek
B2 – Biały pionek
F2 – Biały pionek
G2 – Biały pionek
H2 – Biały pionek
D1 – Biała wieża
E1 – Biały król
F1 – Biały goniec
H1 – Biała wieża
8
77
66
55
44
33
22
11
ABCDEFGH
Pozycja po 11. Gg5.

Mniejszy diagram uzyskuje się za pomocą dodatkowe parametru size. Może być przydatny w artykułach, w których chcemy umieścić wiele diagramów.

{{Szachownica|size = 18
| tright
| 
<!--  a  b  c  d  e  f  g  h
8 -->|rd|  |  |qd|  |rd|kd|  <!-- 8
7 -->|pd|pd|  |  |pd|pd|bd|pd<!-- 7
6 -->|  |nd|pd|  |  |nd|pd|  <!-- 6
5 -->|  |  |ql|  |  |  |bl|  <!-- 5
4 -->|  |  |  |pl|pl|  |bd|  <!-- 4
3 -->|  |  |nl|  |  |nl|  |  <!-- 3
2 -->|pl|pl|  |  |  |pl|pl|pl<!-- 2
1 -->|  |  |  |rl|kl|bl|  |rl<!-- 1
      a  b  c  d  e  f  g  h -->
| Pozycja po 11. Gg5.
}}


Zapis w notacji FEN[edytuj kod]

Możliwe jest też wywołanie szablonu z notacją FEN. Pełne wywołanie wygląda następująco:

{{Szachownica
 | fen = 
 | align = 
 | header = 
 | footer = 
}}
ABCDEFGH
8
Chessboard480.svg
A8 – Czarna wieża
B8 – Czarny skoczek
C8 – Czarny goniec
D8 – Czarny hetman
E8 – Czarny król
H8 – Czarna wieża
A7 – Czarny pionek
B7 – Czarny pionek
C7 – Czarny pionek
D7 – Czarny pionek
F7 – Czarny pionek
G7 – Czarny pionek
H7 – Czarny pionek
E6 – Czarny pionek
F6 – Czarny skoczek
B4 – Czarny goniec
C4 – Biały pionek
D4 – Biały pionek
C3 – Biały skoczek
A2 – Biały pionek
B2 – Biały pionek
E2 – Biały pionek
F2 – Biały pionek
G2 – Biały pionek
H2 – Biały pionek
A1 – Biała wieża
C1 – Biały goniec
D1 – Biały hetman
E1 – Biały król
F1 – Biały goniec
G1 – Biały skoczek
H1 – Biała wieża
8
77
66
55
44
33
22
11
ABCDEFGH
Obrona Nimzowitscha

Parametry oznaczają następujące elementy:

align
wyrównanie
header
tytuł
footer
podpis

Przykład:

{{szachownica|fen=rnbqk2r/pppp1ppp/4pn2/8/1bPP4/2N5/PP2PPPP/R1BQKBNR|footer=Obrona Nimzowitscha}}

Zmiana zapisu standardowego na FEN[edytuj kod]

Na potrzeby szablonu {{szachista infobox}} możliwe jest wywołanie szablonu {{Szachownica/fen}} zamieniającego standardowy format zapisu diagramu szachowego dla Wikipedii na zapis FEN. W stosunku do wywołania {{szachownica}} pomijamy wszystkie zbędne parametry.

{{Szachownica/fen
<!--  a  b  c  d  e  f  g  h
8 -->|rd|nd|bd|qd|kd|  |  |rd<!-- 8
7 -->|pd|pd|pd|pd|  |pd|pd|pd<!-- 7
6 -->|  |  |  |  |pd|nd|  |  <!-- 6
5 -->|  |  |  |  |  |  |  |  <!-- 5
4 -->|  |bd|pl|pl|  |  |  |  <!-- 4
3 -->|  |  |nl|  |  |  |  |  <!-- 3
2 -->|pl|pl|  |  |pl|pl|pl|pl<!-- 2
1 -->|rl|  |bl|ql|kl|bl|nl|rl<!-- 1
      a  b  c  d  e  f  g  h -->
}}

Powyższy przykład daje w wyniku: rnbqk2r/pppp1ppp/4pn2/8/1bPP4/2N5/PP2PPPP/R1BQKBNR11.


Błędy[edytuj kod]

Błędy należy zgłaszać na stronie Wikipedia:Kawiarenka/Kwestie techniczne.

Parametry szablonu (strukturyzacja VE)[edytuj kod]

Zobacz też[edytuj kod]