Объяснение
PGN означает Portable Game Notation, текстовый формат записи партий. Пара тегов PGN хранит один описательный факт о партии. Она состоит из четырёх последовательных частей: открывающей квадратной скобки, имени тега, значения в кавычках и закрывающей квадратной скобки. В [White "Carlsen, Magnus"] элемент White является именем, а Carlsen, Magnus является значением.
Имя может содержать только буквы, цифры и знаки подчёркивания и чувствительно к регистру. Поэтому White и white являются разными именами. Одно и то же имя тега не должно встречаться более одного раза в разделе тегов одной партии.
Внутри значения перед буквальной кавычкой ставится обратная косая черта, а буквальная обратная косая черта удваивается. Переносы строк и символы табуляции внутри строки в кавычках не допускаются.
Пары тегов группируются в начале партии перед . Такие теги, как Event, Date, White и Result, описывают событие, дату, игроков и результат. Другие теги могут содержать дополнительные сведения, например нестандартную начальную позицию или контроль времени.
требует ровно одного пробела между именем и значением, по одной паре на строку и пустой строки после раздела. Формат импорта допускает более гибкое использование пробелов и переносов строк. Логическая структура пары тегов остаётся той же.
Распространённые заблуждения
Пара тегов и список семи тегов
Пара тегов представляет один факт. Список семи тегов является обязательным набором из семи конкретных пар тегов.
Открыть терминТег Result и конечный маркер
Result находится в заголовке как описательные данные. То же значение должно повторяться в конце текста ходов.
Источники
- 1.Standard: Portable Game Notation Specification and Implementation Guide, Steven J. Edwards / ChessGML
