PGN埋め込みコマンド

PGNはPortable Game Notationの略で、対局を記録するテキスト形式です。PGN埋め込みコマンドは、通常のコメントしか理解しない読み手との互換性を保ちながら、機械可読データを追加します。PGNコメント構文に従うブレースコメント内に置かれます。一般形は[%で始まり、コマンド名とパラメーターが続き、]で終わります。

{[%clk 1:05:23]}では、clkがコマンド名、1:05:23がそのパラメーターです。この規約を記述する補足仕様は、指し手の後に表示された時計時間を記録するコマンドとしてclkを提案しています。ほかにも時間関連のコマンドがいくつか説明されています。

この規約はPGN原仕様の中核ではなく、最終草案という状態の補足仕様に由来します。補足仕様は、利用可能なすべてのコマンドに共通する単一の一覧を意図的に定めていません。そのため相互運用性は、生成側と読み取り側が使用されたコマンド名に同じ意味を割り当てるかどうかに依存します。

認識できないコマンドでも、ソフトウェアはコメントの一部として変更せずに保持すべきです。これはPGNタグペアとは異なります。タグペアは指し手に付随するコメント内ではなく、対局冒頭のセクションに記述データを保存します。