Comandă încorporată în PGN

PGN înseamnă Portable Game Notation, un format text pentru înregistrarea partidelor. O comandă încorporată în PGN adaugă date lizibile de programe, păstrând compatibilitatea cu cititoarele care cunosc numai comentariile obișnuite. Este scrisă într-un comentariu între acolade definit de sintaxa comentariilor PGN. Forma generală începe cu [%, continuă cu numele comenzii și parametrii săi și se încheie cu ].

În {[%clk 1:05:23]}, clk este numele comenzii, iar 1:05:23 este parametrul. Suplimentul care documentează convenția propune clk pentru înregistrarea timpului afișat pe ceas după o mutare. El descrie și alte comenzi legate de timp.

Convenția provine dintr-un supliment aflat în stadiu de proiect final, nu din nucleul specificației PGN inițiale. Suplimentul nu stabilește în mod deliberat o listă universală a tuturor comenzilor posibile. Prin urmare, interoperabilitatea depinde de atribuirea aceluiași sens numelui folosit de către producător și cititor.

Un program care nu recunoaște o comandă ar trebui să o păstreze nemodificată ca parte a comentariului. Aceasta o deosebește de o pereche de etichete PGN, care păstrează o informație descriptivă în secțiunea inițială a partidei, nu într-un comentariu asociat mutărilor.