설명
PGN은 대국을 기록하는 텍스트 형식인 휴대용 게임 기보법을 뜻한다. PGN 내장 명령은 일반 주석만 이해하는 리더와의 호환성을 유지하면서 기계가 읽을 수 있는 데이터를 추가한다. 이 정한 중괄호 주석 안에 나타난다. 일반 형식은 [%로 시작해 명령 이름과 매개변수가 이어지고 ]로 끝난다.
{[%clk 1:05:23]}에서 clk는 명령 이름이고 1:05:23은 매개변수다. 이 관례를 문서화한 보충 명세는 한 수를 둔 뒤 시계 표시를 기록하는 명령으로 clk를 제안한다. 그 밖의 여러 시간 관련 명령도 설명한다.
이 관례는 원래 PGN 핵심 명세가 아니라 최종 초안 상태의 보충 명세에서 나왔다. 보충 명세는 가능한 모든 명령의 보편적인 목록을 의도적으로 강제하지 않는다. 따라서 상호 운용성은 생성 프로그램과 읽는 프로그램이 명령 이름에 같은 의미를 부여하는지에 달려 있다.
명령을 인식하지 못하는 소프트웨어는 이를 주석의 일부로서 변경 없이 보존해야 한다. 이는 수와 관련된 주석 속 명령이 아니라 대국의 시작 부분에 설명 데이터를 저장하는 과 다르다.
자주 혼동하는 개념
내장 명령과 PGN 핵심 명세
[%command ...] 형식은 보충 명세에 문서화되어 있고 유효한 PGN 주석 안에 들어가지만, 원래 핵심 명세의 일부는 아니다.
내장 명령과 태그 쌍
명령은 수순 텍스트 주석 안에 있다. 태그 쌍은 헤더에 있으며 대국 전체를 설명한다.
용어 보기출처
- 1.Standard: Portable Game Notation Specification and Implementation Guide (Supplement), Alan Cowderoy et al. / pgn-spec-commented
- 2.Standard: Portable Game Notation Specification and Implementation Guide, Steven J. Edwards / ChessGML
