Che cos'è il formato di file PGN?
.pgn (Portable Game Notation) è lo standard di dati per le partite di scacchi più popolare. I file .pgn memorizzano le mosse delle partite di scacchi insieme a data, luogo, nome dell'evento, turno, risultato della partita e nomi dei giocatori.
Struttura dei dati di un file .pgn
I dati dell'intestazione in un file .pgn sono formattati utilizzando coppie di tag tra parentesi quadre. Il set obbligatorio - il Seven Tag Roster - copre [Event], [Site], [Date], [Round], [White], [Black] e [Result]. I movimenti dei giocatori seguono in una sezione *movetext* utilizzando la Notazione Algebrica Standard (SAN), con commenti tra parentesi { } e annotazioni come ! o ?. Non esiste una firma binaria; i file .pgn sono identificati dal tag di apertura [Event ".
Dati salvati in formato testo
I file .pgn memorizzano le informazioni in formato testo semplice (ASCII) e possono quindi essere facilmente letti sia dagli esseri umani che dai programmi. Più partite possono essere concatenate in un unico file .pgn, il che è comune per i libri di aperture e i database dei tornei. I formati di posizione correlati includono .FEN per le singole posizioni sulla scacchiera e .EPD per le descrizioni estese delle posizioni.
Standard comunemente usato
Il formato .pgn è comunemente usato per memorizzare e condividere (anche online) i dati delle partite di scacchi tramite piattaforme come Lichess e Chess.com. I file .pgn possono essere utilizzati per l'analisi post-partita e dei progressi dei giocatori, l'addestramento dei motori scacchistici e l'archiviazione dei record dei tornei.
Sicurezza e incolumità
RISCHIO: LOWIl PGN è testo semplice senza contenuti eseguibili, quindi i file sono intrinsecamente sicuri da aprire. Le uniche avvertenze: un PGN malformato o enorme potrebbe stressare un parser scritto male e, come sempre, scarica i software di scacchi dai siti ufficiali piuttosto che da portali «visualizzatori PGN» pieni di pubblicità. Non esiste capacità di macro o script nel formato.
Dettagli del formato
in sintesiProgrammi che aprono file PGN
Dettagli tecnici
specifiche approfondite| Tipo MIME | application/x-chess-pgn |
| Codifica file | Testo semplice ASCII a 7 bit |
| Firma del file | Nessun magic byte binario; identificato in pratica dal tag di apertura [Event "..."] |
| Struttura del file | Layout a due sezioni: coppie di tag tra parentesi (intestazione) seguite dal movetext (mosse della partita) |
| Tag di intestazione obbligatori | Seven Tag Roster - [Event], [Site], [Date], [Round], [White], [Black], [Result] |
| Notazione delle mosse | Notazione Algebrica Standard (SAN) |
| Glifi di annotazione | Numeric Annotation Glyphs (NAGs) $1-$255; abbreviazioni comuni: !, ?, !!, ??, !?, ?! |
| Sintassi dei commenti | Commenti a blocco tra parentesi { }; commenti di riga dopo ; (fino a fine riga) |
| Supporto varianti | Recursive Analysis Variations (RAVs) codificate in parentesi tonde nidificate |
| Supporto multi-partita | Più partite complete possono essere concatenate in un singolo file .pgn |
| Valori del risultato | Vocabolario fisso: 1-0 (vince il Bianco), 0-1 (vince il Nero), 1/2-1/2 (patta), * (sconosciuto/in corso) |
| Lunghezza riga | Le specifiche raccomandano ≤ 80 caratteri per riga; accettati finali di riga LF o CRLF |
| Sviluppatore | Steven J. Edwards (specifica sviluppata dalla comunità) |
| Rilasciato | 1994 (PGN specification) |
| Standard aperto | Sì · royalty-free |
| Specifica | www.thechessdrum.net |