gmasclet/prettier-plugin-pgn: Plugin yang lebih cantik untuk memformat file PGN

Prettier adalah pemformat kode yang berpendirian keras. Ini menerapkan gaya yang konsisten dengan menguraikan kode Anda dan mencetak ulang dengan aturannya sendiri yang memperhitungkan panjang baris maksimum, membungkus kode bila diperlukan.

Plugin ini menambahkan dukungan untuk format Notasi Game Portabel ke Prettier.

Notasi Permainan Portabel (PGN) adalah format teks biasa standar untuk merekam permainan catur (baik gerakan maupun data terkait), yang dapat dibaca oleh manusia dan juga didukung oleh sebagian besar perangkat lunak catur.

Contoh permainan ini:

(Event "Immortal Game")(Date "1851.06.21")(White "Anderssen, Adolf")(Black
"Kieseritzky, Lionel")(Result "*") 1.e2-e4 e7-e5 f4 exf4 3.Bc4 3...Qh4+
4.Kf1 b5 {C33 King's Gambit Accepted: Bishop's Gambit, Bryan
Countergambit} 5.Bxb5 Nf6 6.Nf3 Qh6 7.d3 Nh5 8.Nh4 ?! {Inaccuracy. Rg1 was
best.} (8.Rg1 c6 9.Bc4 Be7 10.Nc3 O-O 11.Kf2 Nf6 12.Re1 Ng4+ 13.Kg1 Ba6
14.Bxa6 Nxa6 15.Qe2 Bc5+ 16.d4 Bxd4+ 17.Nxd4) 8...Qg5 9.Nf5 c6 {White
eventually won by checkmate after 23 moves.} *

akan diubah menjadi ini:

(Event "Immortal Game")
(Date "1851.06.21")
(White "Anderssen, Adolf")
(Black "Kieseritzky, Lionel")
(Result "*")

1.e4 e5 2.f4 exf4 3.Bc4 Qh4+ 4.Kf1 b5
  {C33 King's Gambit Accepted: Bishop's Gambit, Bryan Countergambit}
5.Bxb5 Nf6 6.Nf3 Qh6 7.d3 Nh5 8.Nh4?!
  {Inaccuracy. Rg1 was best.}
  (8.Rg1 c6 9.Bc4 Be7 10.Nc3 O-O 11.Kf2 Nf6 12.Re1 Ng4+ 13.Kg1 Ba6 14.Bxa6 Nxa6
  15.Qe2 Bc5+ 16.d4 Bxd4+ 17.Nxd4)
8...Qg5 9.Nf5 c6
  {White eventually won by checkmate after 23 moves.}
*

Untuk berlari prettier dengan plugin PGN, Anda memerlukannya simpul.

Memasang prettier dan plugin menggunakan npm CLI:

# Install locally if you intent to use Prettier in a specific folder
npm install --save-dev prettier prettier-plugin-pgn

# Or globally, which can be handy to format PGN files in any folder
npm install --global prettier prettier-plugin-pgn

Plugin ini dapat diaktifkan di Anda File konfigurasi yang lebih cantik:

{
  "plugins": ("prettier-plugin-pgn")
}

Alternatifnya, hal ini dapat dideklarasikan langsung di CLI, menggunakan --plugin pilihan:

npx prettier --plugin="prettier-plugin-pgn" --write "path/to/file.pgn" 

Plugin ini mendukung sebagian besar spesifikasi PGN. Secara khusus, ini mendukung:

• Variasi (termasuk yang bersarang).
• Anotasi (baik NAG, atau anotasi literal yang paling umum).
• Komentar (hanya yang berada di dalam kurung kurawal).
• File PGN dengan banyak permainan didukung.
• Jika memungkinkan, pluginnya lunak. Perusahaan akan menerima game PGN non kanonik asalkan tidak ambigu.

Fitur-fitur PGN berikut saat ini tidak didukung oleh plugin ini:

• Komentar “Sisa baris” (yang dimulai dengan karakter titik koma dan berlanjut hingga akhir baris).
• Garis yang lolos menggunakan karakter tanda persen (%).

Paket ini tersedia sebagai sumber terbuka berdasarkan ketentuan Lisensi SAYA.