Commande intégrée dans PGN

PGN signifie Portable Game Notation, un format texte destiné à consigner des parties. Une commande intégrée dans PGN ajoute des données lisibles par une machine tout en restant compatible avec les lecteurs qui ne comprennent que les commentaires ordinaires. Elle apparaît dans un commentaire entre accolades régi par la syntaxe des commentaires PGN. La forme générale commence par [%, se poursuit avec un nom de commande et des paramètres, puis se termine par ].

Dans {[%clk 1:05:23]}, clk est le nom de la commande et 1:05:23 son paramètre. Le supplément qui documente cette convention propose clk pour enregistrer l'affichage de l'horloge après un coup. Il décrit également plusieurs autres commandes liées au temps.

La convention provient d'un supplément dont le statut est celui de brouillon final, et non de la spécification PGN fondamentale d'origine. Le supplément évite délibérément d'imposer une liste universelle de toutes les commandes possibles. L'interopérabilité dépend donc du fait que le producteur et le lecteur attribuent la même signification au nom d'une commande.

Un logiciel qui ne reconnaît pas une commande doit la conserver sans modification comme partie du commentaire. Cela diffère d'une paire de balises PGN, qui stocke une donnée descriptive dans la section initiale de la partie plutôt qu'une commande à l'intérieur d'un commentaire associé aux coups.