Встроенная команда PGN

PGN означает Portable Game Notation, текстовый формат записи партий. Встроенная команда PGN добавляет машиночитаемые данные, оставаясь совместимой с программами, которые понимают только обычные комментарии. Она находится внутри комментария в фигурных скобках, подчиняющегося синтаксису комментариев PGN. Общая форма начинается с [%, продолжается именем команды и параметрами и заканчивается ].

В {[%clk 1:05:23]} элемент clk является именем команды, а 1:05:23 является её параметром. Дополнение, документирующее это соглашение, предлагает clk для записи показания часов после хода. Оно также описывает несколько других команд, связанных со временем.

Соглашение описано в дополнении со статусом окончательного проекта, а не в исходной основной спецификации PGN. Дополнение намеренно не навязывает единый универсальный список всех возможных команд. Поэтому совместимость зависит от того, придают ли создатель и программа чтения одинаковый смысл имени команды.

Программа, не распознающая команду, должна сохранить её без изменений как часть комментария. В этом встроенная команда отличается от пары тегов PGN, которая хранит описательные данные в начальном разделе партии, а не внутри комментария к ходам.