> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/id/bidang-khusus/05-chess-notation.md).

# Notasi catur

## Pendahuluan

Artikel ini membahas dasar-dasar penataan huruf catur, termasuk [ulasan/ringkasan singkat tentang beberapa konvensi catur](#chess-conventions-a-brief-review) yang mungkin Anda temui dalam dokumentasi paket catur LaTeX. Pembaca yang tidak memerlukan materi pengantar itu dapat langsung ke [contoh-contoh paket LaTeX](#a-first-example-with-the-xskak-package).

## Satu paket untuk menguasai semuanya

Repositori CTAN mencantumkan sejumlah [paket terkait catur](https://ctan.org/search?phrase=chess\&ext=false&_PKG=\&PKG=on&_AUTHORS=\&AUTHORS=on&_TOPICS=\&TOPICS=on&_FILES=&_PORTAL=\&PORTAL=on\&wildcard=on\&max=32), jadi Anda mungkin bertanya-tanya mana yang harus dipilih? Artikel ini menggunakan [`xskak` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/xskak?lang=en), yang sangat direkomendasikan untuk penataan catur karena beragam fiturnya, opsi konfigurasi yang luas, dan dokumentasi yang sangat baik. `xskak` memuat dan memperluas [`skak` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/skak?lang=en) asli dan juga memuat [`chessboard` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/chessboard?lang=en) yang menyediakan rentang opsi yang sangat besar untuk mengonfigurasi dan membuat papan catur.

Contoh-contoh yang disediakan oleh artikel ini tidak dapat menggantikan *dokumentasi yang sangat baik* yang menyertai [`xskak`](https://texdoc.org/serve/xskak/0) dan [`chessboard`](https://texdoc.org/serve/chessboard/0) paket-paket tersebut, yang sangat kami anjurkan untuk Anda telusuri, tinjau, dan jelajahi karena kedua set dokumentasi berisi banyak contoh yang sangat membantu.

**Catatan**: Keduanya `skak` dan `xskak` dapat mengurai dan menata permainan catur dalam (sebagian dari) [Portable Game Notation (PGN)](#portable-game-notation). `xskak` memperluas subset PGN yang didukung oleh `skak`.

**Trivia**: skak adalah kata bahasa Denmark untuk catur.

### Beberapa catatan

Berikut adalah beberapa poin penting yang dicatat dalam `xskak` dokumentasi:

> `xskak` akan memuat paket `skak` tanpa opsi (dan tidak akan meneruskan opsi ke paket itu). Jadi, jika Anda ingin memuat `skak` dengan opsi, Anda harus melakukannya sebelum memuat paket `xskak`.

> `xskak` adalah sebuah perluasan (bukan pengganti) **pekerjaan utama tetap dilakukan oleh paket `skak`**... silakan baca terlebih dahulu dokumentasi paket `skak`...

* **Catatan**: Di antara paket-paket terkait catur [yang tercantum di CTAN](https://ctan.org/search?phrase=chess\&ext=false&_PKG=\&PKG=on&_AUTHORS=\&AUTHORS=on&_TOPICS=\&TOPICS=on&_FILES=&_PORTAL=\&PORTAL=on\&wildcard=on\&max=32) ada salah satunya bernama [`skaknew`](https://ctan.org/pkg/skaknew). Meskipun namanya demikian, `skaknew` paket ini adalah *berisi nilai data aktual yang disimpan dalam* versi baru atau versi yang disempurnakan dari `skak` paket asli: ini adalah seperangkat font catur Type 1. Paket `xskak` ini memanfaatkan `skaknew` font tersebut jadi Anda tidak perlu memuatnya secara manual ke dalam proyek Anda.

### Contoh minimal xskak

Untuk "membuat suasana", dan tanpa penjelasan lebih lanjut, berikut ini contoh minimal `xskak` paket yang menata dua papan catur: satu kosong, yang lain memiliki semua bidak catur pada posisi awalnya:

```latex
\documentclass{article}
% Catatan: Anda hanya perlu memuat xskak,
% bukan paket skak atau chessboard.
\usepackage{xskak}
\begin{document}
% Perintah \chessboard ini menggambar
% sebuah papan catur kosong: opsi
% showmover=false akan dibahas
% nanti dalam artikel
\chessboard[showmover=false]
% Perintah \newchessgame
% menginisialisasi permainan baru:
\newchessgame
% Karena permainan baru telah diinisialisasi,
% \chessboard sekarang menggambar sebuah
% papan dengan bidak-bidak catur:
\chessboard
Kotak putih kecil di sebelah kanan papan kedua disebut \textit{mover}.
\end{document}
```

[Buka contoh ini di Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=A+basic+xskak+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Note%3A+you+only+need+to+load+xskak%2C%0A%25+not+the+skak+or+chessboard+packages.%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%25+This+%5Cchessboard+command+draws+%0A%25+an+empty+chess+board%3A+the+option%0A%25+showmover%3Dfalse+will+be+discussed%0A%25+later+in+the+article%0A%5Cchessboard%5Bshowmover%3Dfalse%5D%0A%25+The+%5Cnewchessgame+command+%0A%25+initializes+a+new+game%3A%0A%5Cnewchessgame%0A%25+Because+a+new+game+was+initialized%2C+%0A%25+%5Cchessboard+now+draws+a+%0A%25+board+with+chess+pieces%3A%0A%5Cchessboard%0AThe+small+white+square+to+the+right+of+the+second+board+is+called+the+%5Ctextit%7Bmover%7D.%0A%5Cend%7Bdocument%7D)

Ini `xskak` contoh menghasilkan keluaran berikut:

![](/files/5c6a348d73d764102282753bcbadb5492f216207)

## Konvensi catur: tinjauan singkat

Untuk membantu pembaca yang baru mengenal catur, terutama penataannya, bagian-bagian berikut menyediakan *singkat* pengantar tentang topik dan konvensi yang akan Anda temui dalam paket catur LaTeX dan dokumentasinya. Pembaca yang sudah akrab dengan konvensi catur dapat melewati bagian-bagian ini dan langsung ke contoh-contoh LaTeX.

### Portable Game Notation

Paket skak dan xskak mendukung subset dari [Portable Game Notation](https://en.wikipedia.org/wiki/Portable_Game_Notation) (PGN), sebuah standar yang diciptakan sekitar tahun 1994 oleh [Steven Edwards](https://www.chessprogramming.org/Steven_Edwards). Spesifikasi PGN asli, bertanggal 1994, tersedia [di archive.org](https://archive.org/details/pgn-standard-1994-03-12). Tautan langsung ke standar tersebut adalah <https://tim-mann.org/Standard>.

Menurut [teks standar PGN](https://tim-mann.org/Standard):

> PGN adalah "Portable Game Notation", sebuah standar yang dirancang untuk representasi data permainan catur menggunakan berkas teks ASCII. PGN disusun agar mudah dibaca dan ditulis oleh pengguna manusia serta mudah diurai dan dihasilkan oleh program komputer... PGN diusulkan sebagai representasi portabel universal untuk pertukaran data.

Perlu dicatat bahwa berkas PGN dirancang untuk *pertukaran **data** permainan*; yaitu, berkas PGN dirancang untuk memuat *informasi permainan lengkap* —seperti nama para pemain, rincian acara/tanggal, dll., bersama dengan catatan, dalam notasi aljabar, dari *semua langkah* dalam permainan.

**Catatan**: Untuk pengantar singkat lainnya tentang PGN, kunjungi <http://www.enpassant.dk/chess/palview/p3manual/p3pgn.htm>

### Peringkat dan lajur papan catur

Papan catur adalah kisi 8×8 kotak yang, secara normal, dapat digambarkan sebagai 8 baris horizontal dan 8 kolom vertikal; namun, terminologi yang berbeda digunakan untuk menggambarkan papan catur:

* ada 8 ***peringkat*** (bukannya baris)
* ada 8 ***file yang dapat diedit*** (bukannya kolom)

Setiap kotak pada papan catur dapat diidentifikasi (dinamai) menggunakan [beberapa konvensi](https://en.wikipedia.org/wiki/Chessboard#Board_notation) tetapi [notasi aljabar](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) (sistem koordinat) adalah standar internasional yang diterima.

### Notasi aljabar

Dalam sistem notasi aljabar, peringkat dan lajur diberi label sebagai berikut:

* 8 horizontal ***peringkat*** diberi label menggunakan angka `1` ke `8`
* 8 vertikal ***file yang dapat diedit*** diberi label menggunakan huruf `a` ke `h`.

Diagram berikut menunjukkan papan catur dengan label notasi aljabar yang digunakan untuk lajur dan peringkat:

![](/files/c33171eb0d1f5ca3b7720311b4b08244b9baf751)

Setiap kotak pada papan catur berada pada perpotongan lajur (kolom) dan peringkat (baris) tertentu: nilai lajur dan peringkat yang sesuai dapat digunakan sebagai koordinat untuk mengidentifikasi setiap kotak secara unik guna digunakan dalam mendeskripsikan lokasi dan pergerakan bidak catur.

Sebagai contoh, diagram berikut menunjukkan kotak yang terletak di **e7** diikuti oleh papan catur kedua yang mencantumkan lokasi semua 64 kotak:

![](/files/1d09e4d337422f62803beb58c8db707e2f414c92)

Jika Anda baru mengenal catur, halaman Wikipedia [Notasi aljabar](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) berisi beberapa informasi latar belakang yang berguna, yang sebagian kami ringkas di bawah.

### Notasi untuk bidak catur

Setiap jenis bidak catur, biasanya kecuali pion, diidentifikasi oleh huruf kapital yang dapat bervariasi tergantung pada bahasa yang digunakan. Pemain berbahasa Inggris menggunakan huruf-huruf berikut:

| Huruf | Bidak   |
| ----- | ------- |
| K     | Raja    |
| Q     | Ratu    |
| R     | Benteng |
| B     | Gajah   |
| N     | Kuda    |

Dalam notasi aljabar standar pion tidak *biasanya* diidentifikasi dengan huruf kapital; sebaliknya, pion dikenali melalui *tidaknya* huruf kapital. Namun, konvensi itu tidak selalu diadopsi; huruf kapital P dapat digunakan untuk mengidentifikasi pion. Dalam [Notasi Forsyth-Edwards (FEN)](#forsyth-edwards-notation-fen) huruf kapital dan huruf kecil digunakan untuk merepresentasikan bidak catur.

### Notasi untuk langkah individual

Untuk mencatat pergerakan sebuah bidak catur, Anda perlu mengidentifikasi bidaknya dan kotak tujuan. Itu dapat dicapai dengan menggunakan huruf kapital bidak ditambah koordinat kotak tujuan.

**Catatan**: ketika mendeskripsikan langkah pion, huruf yang menunjukkan bahwa bidak itu pion tidak *biasanya* digunakan; hanya kotak tujuan yang *biasanya* diberikan, seperti ditunjukkan pada contoh berikut:

* *langkah* : bidak non-pion
  * **Be5**: **B**gajah bergerak ke kotak **e5**
  * **Nf3**: k**N**uda bergerak ke kotak **f3**
* *pion* : bidak non-pion
  * **c5**: sebuah pion bergerak ke kotak **c5**
  * **Catatan**: dalam keadaan tertentu (misalnya, beberapa perintah LaTeX) pion *diidentifikasi* dengan huruf kapital **P**; jadi **c5** mungkin ditulis **Pc5**.

#### Tiga titik (...) penanda langkah bidak hitam

Bagian 8.2.2.2 dari [standar Portable Game Notation](https://tim-mann.org/Standard) menjelaskan penggunaan tiga titik (...) setelah penanda nomor langkah (misalnya, **3...e6**):

> Penanda nomor langkah putih dibentuk dari bilangan bulat yang memberikan nomor langkah penuh dengan satu karakter titik ditambahkan. Penanda nomor langkah hitam dibentuk dari bilangan bulat yang memberikan nomor langkah penuh dengan ***tiga karakter titik ditambahkan***.

### Konvensi untuk serangkaian langkah

Seperti dijelaskan dalam artikel Wikipedia tentang [Notasi aljabar](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)#Formatting), untuk mendeskripsikan serangkaian langkah:

* setiap langkah individual *biasanya* menggunakan huruf kapital untuk bidak non-pion, meskipun, seperti disebutkan di atas, dalam beberapa keadaan (konvensi) huruf kapital P dapat digunakan untuk menunjukkan langkah pion.
* serangkaian langkah catur adalah urutan dari `<langkah bidak putih> <langkah bidak hitam>` pasang—perhatikan bahwa setiap pasangan langkah diberi nomor (lihat contoh di bawah)

### Notasi catur lainnya: FAN dan FEN

#### Notasi Aljabar Figurina (atau FAN)

Huruf khusus bahasa yang digunakan untuk merepresentasikan bidak catur sering diganti dengan simbol yang diakui secara universal yang merepresentasikan bidak catur. Representasi simbolik ini dikenal sebagai Notasi Aljabar Figurina, atau FAN. Misalnya, simbol ♞ (atau ♘) dapat digunakan sebagai pengganti N (untuk kuda).

Spesifikasi Unicode mengodekan karakter catur dalam [set Simbol Beragam](https://www.unicode.org/charts/PDF/U2600.pdf). Tabel berikut mencantumkan nilai Unicode, nama, dan simbol representatif untuk setiap karakter catur—glyph sebenarnya (desain karakter) yang digunakan untuk menampilkan simbol catur akan bergantung pada pengaturan font perangkat/peramban Anda.

| <p>Simbol representatif<br>(glyph)</p> | <p>Nilai Unicode<br>(dalam HEX)</p> | <p>Nama karakter Unicode<br>(formal)</p> |
| -------------------------------------- | ----------------------------------- | ---------------------------------------- |
| ♔                                      | 2654                                | RAJA CATUR PUTIH                         |
| ♕                                      | 2655                                | RATU CATUR PUTIH                         |
| ♖                                      | 2656                                | BENTENG CATUR PUTIH                      |
| ♗                                      | 2657                                | GAJAH CATUR PUTIH                        |
| ♘                                      | 2658                                | KUDA CATUR PUTIH                         |
| ♙                                      | 2659                                | PION CATUR PUTIH                         |
| ♚                                      | 265A                                | RAJA CATUR HITAM                         |
| ♛                                      | 265B                                | RATU CATUR HITAM                         |
| ♜                                      | 265C                                | BENTENG CATUR HITAM                      |
| ♝                                      | 265D                                | GAJAH CATUR HITAM                        |
| ♞                                      | 265E                                | KUDA CATUR HITAM                         |
| ♟                                      | 265F                                | PION CATUR HITAM                         |

#### Notasi Forsyth-Edwards (FEN)

Seperti disebutkan, PGN digunakan untuk penyimpanan dan pertukaran *seluruh permainan*, termasuk semua langkah yang dimainkan dalam permainan itu. Sebaliknya, [Notasi Forsyth-Edwards (FEN)](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) memberikan cuplikan permainan pada suatu titik waktu. Notasi FEN menggunakan huruf kapital dan huruf kecil untuk merepresentasikan bidak catur:

* bidak putih diidentifikasi dengan huruf kapital (PNBRQK)
* bidak hitam diidentifikasi dengan huruf kecil (pnbrqk)

di mana P adalah untuk pion putih dan p adalah untuk pion hitam.

Pembahasan rinci tentang FEN, dan perbandingannya dengan PGN, berada di luar cakupan artikel ini. Pembaca yang ingin lebih memahami perbedaan antara PGN dan FEN mungkin ingin menonton video berikut:

{% embed url="<https://www.youtube.com/embed/3PvmsmqKF_I>" %}

## Contoh pertama dengan paket xskak

### Membuat langkah Anda

Untuk menata langkah catur seiring permainan berlangsung, Anda menggunakan perintah `\mainline{*daftar langkah*}` di mana `*daftar langkah*` dinyatakan dalam [notasi catur aljabar](#algebraic-notation). Kita akan mendemonstrasikan penataan urutan langkah berikut:

1. **e4 e5**: pion putih bergerak ke **e4**, pion hitam bergerak ke **e5**
2. **Nf3 Nc6**: k**N**uda putih bergerak ke **f3**, k**N**uda putih bergerak ke **c6**
3. **Bb5 a6**: g **B**ajah putih bergerak ke **b5**, pion hitam bergerak ke **a6**

Urutan langkah ini dapat ditulis menggunakan [`xskak` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/xskak?lang=en) perintah `\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}`—perhatikan bahwa setiap pasangan langkah diberi nomor (misalnya, `**1.**e4 e5`):

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}
\showboard % Perintah paket skak. Contoh-contoh mendatang akan menggunakan \chessboard[...]
\end{document}
```

[Buka contoh ini di Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=First+xskak+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6%7D%0A%5Cshowboard+%25+A+skak+package+command.+Future+examples+will+use+%5Cchessboard%5B...%5D%0A%5Cend%7Bdocument%7D)

Ini `xskak` contoh menghasilkan keluaran berikut:

![](/files/36583ffccdbf6d87d86b8b4cae5e6a0517cdd796)

Perintah berikut digunakan:

* **`\newchessgame[〈daftar kunci=nilai〉]`**: memulai permainan baru dan menginisialisasi papan catur. The `[〈daftar kunci=nilai〉]` bersifat opsional sehingga Anda juga dapat menulis `\newchessgame` dan mengandalkan pengaturan papan bawaan. Himpunan kunci opsional dicantumkan dalam [`xskak` dokumentasi](https://texdoc.org/serve/xskak/0).
* **`\mainline{〈daftar langkah catur〉}`**: memproses `〈daftar langkah catur〉` dan memperbarui papan sehingga `\showboard` (atau `\chessboard`) menata status papan saat ini.
* **`\showboard`**: menata papan catur. `\showboard` perintah ini berasal dari paket `skak` dasar, yang `xskak` diperluas oleh [`chessboard` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/chessboard?lang=en), yang dimuat oleh `xskak`, menyediakan **`\chessboard[〈daftar kunci=nilai〉]`** perintah yang kepadanya `xskak` paket menambahkan kunci-kunci tambahan. Karena `\chessboard[...]` dimaksudkan untuk menggantikan `\showboard`, contoh-contoh selanjutnya dalam artikel ini hanya akan menggunakan `\chessboard[...]` perintah.

### Memperkenalkan perintah \chessboard

Perintah **`\chessboard[〈daftar kunci=nilai〉]`**: menata papan catur menggunakan sebuah `〈daftar kunci=nilai〉`opsional. Daftar `kunci` yang tersedia untuk digunakan adalah *secara luas*, yang memberikan kontrol besar atas ukuran, isi, tata letak, desain, anotasi, dll. papan catur. Pembaca dianjurkan untuk membaca dokumentasi paket yang sangat baik untuk [`chessboard` (PDF)](https://texdoc.org/serve/chessboard/0) dan [`xskak` (PDF)](https://texdoc.org/serve/xskak/0), keduanya berisi banyak contoh yang membantu—*banyak* lebih banyak daripada yang dapat kami demonstrasikan dalam artikel ini.

Karena kunci-kunci itu bersifat opsional, Anda dapat menulis `\chessboard` yang menggunakan nilai bawaan paket untuk menata sebuah papan catur; misalnya, kode berikut menata dua papan menggunakan `\chessboard` tanpa opsi apa pun. Anotasi tambahan, ditambahkan secara manual di Inkscape, menunjukkan *mover* (di sini sebagai kotak) yang secara bawaan ditata:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5}
\chessboard % sebagai pengganti \showboard

\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}
\chessboard % sebagai pengganti \showboard
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=chessboard+command+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5%7D%0A%5Cchessboard+%25+instead+of+%5Cshowboard%0A%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6%7D%0A%5Cchessboard+%25+instead+of+%5Cshowboard%0A%5Cend%7Bdocument%7D)

Grafik berikut menunjukkan dua papan catur yang dihasilkan oleh kode di atas, keduanya ditata menggunakan `\chessboard`:

![](/files/17f5f2ed02e759a0e58745d89f19696f73c5af59)

Tak mengherankan, berbagai kunci disediakan untuk mengontrol mover, termasuk menampilkan atau menyembunyikannya; misalnya, untuk menyembunyikan mover Anda dapat menggunakan `showmover` kunci dengan nilai `false`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}\par
\chessboard[showmover=false] % Sembunyikan mover
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Hiding+the+chessboard+mover\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6%7D%5Cpar%0A%5Cchessboard%5Bshowmover%3Dfalse%5D+%25+Hide+the+mover%0A%5Cend%7Bdocument%7D)

Contoh ini menghasilkan keluaran berikut—sebuah papan catur tanpa mover:

![](/files/b500f67f3696e805a6db1bad54d3542e0c304fdb)

Fitur [`chessboard` dokumentasi paket (PDF)](https://texdoc.org/serve/chessboard/0) menyediakan daftar kunci untuk menyesuaikan mover, bersama catatan tentang cara merancang mover Anda sendiri!

## Contoh xskak tambahan

### Komentar teks

Spesifikasi PGN mendukung penambahan komentar dengan menggunakan tanda kurung kurawal di sekitar teks komentar: `{〈Teks〉}`; namun, `xskak` paket ini lebih menyukai komentar teks yang ditulis sebagai `\xskakcomment{〈Teks〉}`, seperti ditunjukkan pada contoh berikut:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame % Mulai permainan catur baru
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6 \xskakcomment{ Ini adalah komentar. }}\vspace{3mm}

\chessboard
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=xskak+chess+comment+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame+%25Start+a+new+chess+game%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6+%5Cxskakcomment%7B+This+is+a+comment.+%7D%7D%5Cvspace%7B3mm%7D%0A%0A%5Cchessboard%0A%5Cend%7Bdocument%7D)

Contoh ini menghasilkan keluaran berikut:

![](/files/5afc2832c370b8a3af56e6a44da19094d8646f14)

### Menginisialisasi papan menggunakan notasi FEN

Anda dapat menggunakan FEN untuk memulai papan pada posisi apa pun. Contoh berikut menggunakan `setfen` masukkan sebuah `\chessboard` perintah untuk mendemonstrasikan contoh FEN yang diambil dari `skak` dokumentasi paket:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\chessboard[setfen=r5k1/1b1p1ppp/p7/1p1Q4/2p1r3/PP4Pq/BBP2b1P/R4R1K w - - 0 20]
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=FEN+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cchessboard%5Bsetfen%3Dr5k1%2F1b1p1ppp%2Fp7%2F1p1Q4%2F2p1r3%2FPP4Pq%2FBBP2b1P%2FR4R1K+w+-+-+0+20%5D%0A%5Cend%7Bdocument%7D)

Contoh ini menghasilkan keluaran berikut:

![](/files/ea370a8809288d636e08f4f6ec5d5dd93802f9b4)

Notasi FEN mengisi papan mulai dari baris teratas (peringkat 8) dan bekerja ke bawah untuk mengisi baris-baris berikutnya. Misalnya, untuk menginisialisasi papan di atas, baris 8 dijelaskan menggunakan **r5k1**:

* **r**ook
* **5** petak kosong
* situs web **k**ing
* **1** petak kosong

karena itu menggunakan notasi **r5k1**. Perhatikan penggunaan huruf kecil untuk mendeskripsikan bidak catur hitam bersama dengan penggunaan huruf kapital **P** untuk pion putih dan huruf kecil **p** untuk pion hitam.

### Menggunakan \lastmove

Fitur `\lastmove` perintah dapat digunakan untuk memberi komentar pada langkah terakhir yang dibuat:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4}

\chessboard

\lastmove{} adalah langkah pembukaan yang paling umum.
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=xskak+lastmove+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4%7D%0A%0A%5Cchessboard%0A%0A%5Clastmove%7B%7D+is+the+most+common+opening+move.%0A%5Cend%7Bdocument%7D)

Contoh ini menghasilkan keluaran berikut:

![](/files/b4f8be34f032ca26afa049a92779a7121fc365a4)

### Variasi dan contoh notasi ...

Berikut ini mereproduksi contoh yang terdapat dalam `skak` dokumentasi paket, diperbarui untuk menggunakan `xskak` perintah. Di sini, kita melihat contoh `\variation` perintah dan sintaks tiga titik (...) [yang digunakan untuk menandakan langkah hitam](#three-dots-black-piece-move-indication):

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5}

\chessboard

\mainline{3...a6}

Varian \variation{3...Nf6} digunakan di sini untuk menunjukkan perintah \texttt{\string\variation}.

\mainline{4.Ba4}

\chessboard
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=xskak+variations+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5%7D%0A%0A%5Cchessboard%0A%0A%5Cmainline%7B3...a6%7D%0A%0AA+variant+%5Cvariation%7B3...Nf6%7D+is+used+here+to+show+a+%5Ctexttt%7B%5Cstring%5Cvariation%7D+command.%0A%0A%5Cmainline%7B4.Ba4%7D%0A%0A%5Cchessboard%0A%5Cend%7Bdocument%7D)

Contoh ini menghasilkan keluaran berikut:

![](/files/f034bdc40ccda3a76000086d2d59a347459131c9)

### Menampilkan hanya bidak catur tertentu

Karena `xskak` memuat `chessboard` di paket ini Anda dapat menggunakan perintah yang sangat kuat **`\chessboard[〈daftar kunci=nilai〉]`** untuk menampilkan atau menyembunyikan area papan, atau kumpulan bidak catur, yang menarik. Dokumentasi [chessboard](https://texdoc.org/serve/chessboard/0) berisi banyak contoh, seperti yang direproduksi di bawah ini.

#### Menggunakan kunci untuk menyembunyikan petak tertentu

Contoh ini menggunakan kunci `hideall`, `showpieces` dan `addpieces`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\chessboard[hideall,
showpieces={P,p},
addpieces=pe5]
\end{document}
```

[Buka contoh ini di Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Showing+selected+pieces+in+xskak+example+1\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cchessboard%5Bhideall%2C%0Ashowpieces%3D%7BP%2Cp%7D%2C%0Aaddpieces%3Dpe5%5D%0A%5Cend%7Bdocument%7D)

Ini `xskak` contoh menghasilkan keluaran berikut:

![](/files/46f000e7427ee8807b89d30d20512b46bf000163)

Contoh ini menggunakan kunci `hidefiles`, `showfiles` dan `showranks`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\def\myfiles{a,b}
\chessboard[hidefiles=\myfiles,
addpieces=Ra2,
showfiles=a,
showranks=2]
\end{document}
```

[Buka contoh ini di Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Showing+selected+pieces+in+xskak+example+2\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cdef%5Cmyfiles%7Ba%2Cb%7D%0A%5Cchessboard%5Bhidefiles%3D%5Cmyfiles%2C%0Aaddpieces%3DRa2%2C%0Ashowfiles%3Da%2C%0Ashowranks%3D2%5D%0A%5Cend%7Bdocument%7D)

Ini `xskak` contoh menghasilkan keluaran berikut:

![](/files/9d686a454312fcd85ac07fe5260667cf41859606)

#### Menggunakan kunci untuk menyembunyikan semua bidak putih atau semua bidak hitam

Contoh berikut mendemonstrasikan kunci `hidewhite` dan `hideblack`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6}\chessboard[hidewhite]

\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6}\chessboard[hideblack]
\end{document}
```

[Buka contoh ini di Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Showing+selected+pieces+in+xskak+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6%7D%5Cchessboard%5Bhidewhite%5D%0A%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6%7D%5Cchessboard%5Bhideblack%5D%0A%5Cend%7Bdocument%7D)

Ini `xskak` contoh menghasilkan keluaran berikut:

![](/files/72bebd526c29013b580e2001984e6bc59eff6de4)

## Contoh lebih lanjut dari tex.stackexchange

Contoh berikut menggunakan solusi yang ditemukan di [tex.stackexchange.com](https://tex.stackexchange.com).

### Bagaimana menyorot petak?

Sumber: berdasarkan <https://tex.stackexchange.com/a/215334>

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newgame
\chessboard[setfen=8/8/8/3Q4/8/8/8/8 w - - 0 0,
            pgfstyle=border,markfields={d4,d6},
            color=blue!50,
            colorbackfield=c5,
            pgfstyle=color,
            opacity=0.5,
            color=red,
            markfield={d5}]
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Highlighting+chess+board+squares\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewgame%0A%5Cchessboard%5Bsetfen%3D8%2F8%2F8%2F3Q4%2F8%2F8%2F8%2F8+w+-+-+0+0%2C%0A++++++++++++pgfstyle%3Dborder%2Cmarkfields%3D%7Bd4%2Cd6%7D%2C%0A++++++++++++color%3Dblue%2150%2C%0A++++++++++++colorbackfield%3Dc5%2C%0A++++++++++++pgfstyle%3Dcolor%2C%0A++++++++++++opacity%3D0.5%2C%0A++++++++++++color%3Dred%2C%0A++++++++++++markfield%3D%7Bd5%7D%5D%0A%5Cend%7Bdocument%7D)

![](/files/787a12bb5b65ee55c5f90a7168a7bf8da2c51c19)

### Membuat gaya papan yang berbeda

Sumber: berdasarkan <https://tex.stackexchange.com/a/358041>

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\storechessboardstyle{4x16}{%
  maxfield=d16,
  borderwidth=1mm,
  color=white,
  colorwhitebackfields,
  color=black,
  colorblackbackfields,
  blackfieldmaskcolor=black,
  whitepiececolor=yellow,
  whitepiecemaskcolor=red,
  blackpiececolor=cyan,
  blackpiecemaskcolor=blue,
  addfontcolors,
  pgfstyle=border,
  color=white,
  markregion=a1-d16,
  showmover=false,
  hlabelwidth=18pt,
  vlabellift=16pt}
  \chessboard[
    style=4x16,
    setpieces={Qa8,Qb4,Qc1,Qd3,Qb16,Qc12,Qa7,Qc15,qa1,qb14,qc11,qd13,qb6,qc2,qa4,qc5},
    padding=1ex,
  ]
\end{document}
```

[Buka contoh ini di Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+custom+chess+board\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cstorechessboardstyle%7B4x16%7D%7B%25%0A++maxfield%3Dd16%2C%0A++borderwidth%3D1mm%2C%0A++color%3Dwhite%2C%0A++colorwhitebackfields%2C%0A++color%3Dblack%2C%0A++colorblackbackfields%2C%0A++blackfieldmaskcolor%3Dblack%2C%0A++whitepiececolor%3Dyellow%2C%0A++whitepiecemaskcolor%3Dred%2C%0A++blackpiececolor%3Dcyan%2C%0A++blackpiecemaskcolor%3Dblue%2C%0A++addfontcolors%2C%0A++pgfstyle%3Dborder%2C%0A++color%3Dwhite%2C%0A++markregion%3Da1-d16%2C%0A++showmover%3Dfalse%2C%0A++hlabelwidth%3D18pt%2C%0A++vlabellift%3D16pt%7D%0A++%5Cchessboard%5B%0A++++style%3D4x16%2C%0A++++setpieces%3D%7BQa8%2CQb4%2CQc1%2CQd3%2CQb16%2CQc12%2CQa7%2CQc15%2Cqa1%2Cqb14%2Cqc11%2Cqd13%2Cqb6%2Cqc2%2Cqa4%2Cqc5%7D%2C%0A++++padding%3D1ex%2C%0A++%5D%0A%5Cend%7Bdocument%7D)

Ini `xskak` contoh menghasilkan keluaran berikut:

![](/files/c42bd94262a4f4b90a705c76963ffbcf19c11755)

## Bacaan lanjutan

Untuk informasi lebih lanjut lihat:

* [Membuat dokumen di LaTeX](/latex/id/dasar-dasar-latex/01-learn-latex-in-30-minutes.md)
* [Menyisipkan Gambar](/latex/id/topik-lainnya/27-inserting-images.md)
* [Penempatan gambar dan tabel](/latex/id/gambar-dan-tabel/02-positioning-images-and-tables.md)
* [Dukungan bahasa internasional](/latex/id/bahasa/03-international-language-support.md)
* [Ukuran font, keluarga font, dan gaya](/latex/id/font/01-font-sizes-families-and-styles.md)
* [Jenis huruf](/latex/id/font/02-font-typefaces.md)
* [Pengelolaan dalam proyek besar](/latex/id/struktur-dokumen/07-management-in-a-large-project.md)
* [Fitur `skak` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/skak?lang=en)
* [Fitur `xskak` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/xskak?lang=en)
* [Notasi aljabar dalam catur (di Wikipedia)](http://en.wikipedia.org/wiki/Algebraic_notation_\(chess\))
* [Notasi Forsyth-Edwards (FEN) (di Wikipedia)](http://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation)
* [Fitur `chessboard` ke preambel dokumen Anda (seperti disarankan](https://ctan.org/pkg/chessboard?lang=en)
* [Teks standar PGN](https://tim-mann.org/Standard)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/id/bidang-khusus/05-chess-notation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
