PGN嵌入命令与[%...]语法

解释

PGN指Portable Game Notation，是记录对局的文本格式。PGN嵌入命令可以加入机器可读数据，同时仍兼容只理解普通注释的读取器。它位于受约束的花括号注释内。一般形式以[%开始，随后是命令名称和参数，并以]结束。

在{[%clk 1:05:23]}中，clk是命令名称，1:05:23是其参数。记录这一约定的补充文档建议使用clk保存一着棋走完后的棋钟显示，并描述了其他几种与时间相关的命令。

这一约定来自状态为最终草案的补充文档，而不是原始PGN核心规范。该补充文档有意不规定所有可能命令的统一完整列表。因此，互操作性取决于生成程序和读取程序是否赋予命令名称相同含义。

软件若不认识某条命令，应将其作为注释的一部分原样保留。这不同于，后者把说明性数据保存在对局开头的区段，而不是保存在与着法相关的注释命令中。

嵌入命令与PGN核心规范

[%command ...]形式记录在补充文档中，并承载于有效的PGN注释内，但它不属于原始核心规范。

嵌入命令与标签对

嵌入命令位于着法文本注释内，标签对位于头部并描述整盘对局。