Eingebetteter PGN-Befehl

PGN steht für Portable Game Notation, ein Textformat zur Aufzeichnung von Partien. Ein eingebetteter PGN-Befehl fügt maschinenlesbare Daten hinzu und bleibt zugleich mit Lesern kompatibel, die nur gewöhnliche Kommentare verstehen. Er steht in einem Kommentar in geschweiften Klammern gemäß der PGN-Kommentarsyntax. Die allgemeine Form beginnt mit [%, wird mit einem Befehlsnamen und Parametern fortgesetzt und endet mit ].

In {[%clk 1:05:23]} ist clk der Befehlsname und 1:05:23 sein Parameter. Der Zusatz, der diese Konvention dokumentiert, schlägt clk vor, um die Uhrenanzeige nach einem Zug aufzuzeichnen. Er beschreibt außerdem mehrere weitere zeitbezogene Befehle.

Die Konvention stammt aus einem Zusatz mit dem Status Final Draft und nicht aus der ursprünglichen PGN-Kernspezifikation. Der Zusatz verzichtet bewusst darauf, eine universelle Liste aller möglichen Befehle festzulegen. Die Interoperabilität hängt daher davon ab, dass Erzeuger und Leser einem Befehlsnamen dieselbe Bedeutung zuweisen.

Software, die einen Befehl nicht erkennt, sollte ihn unverändert als Teil des Kommentars bewahren. Darin unterscheidet er sich von einem PGN-Tag-Paar, das beschreibende Daten im Anfangsabschnitt der Partie speichert und nicht als Befehl in einem zugbezogenen Kommentar.