Wyjaśnienie
PGN oznacza Portable Game Notation, tekstowy format zapisu partii. Osadzone polecenie PGN dodaje dane czytelne dla programu, zachowując zgodność z czytnikami, które rozumieją wyłącznie zwykłe komentarze. Występuje wewnątrz komentarza w nawiasach klamrowych zgodnego ze . Ogólna forma zaczyna się od [%, dalej zawiera nazwę polecenia i parametry, a kończy się znakiem ].
W {[%clk 1:05:23]} element clk jest nazwą polecenia, a 1:05:23 jego parametrem. Dodatek dokumentujący tę konwencję proponuje clk do zapisywania wskazania zegara po ruchu. Opisuje również kilka innych poleceń związanych z czasem.
Konwencja pochodzi z dodatku mającego status ostatecznego projektu, a nie z pierwotnej, podstawowej specyfikacji PGN. Dodatek celowo nie narzuca jednej uniwersalnej listy wszystkich możliwych poleceń. Interoperacyjność zależy więc od tego, czy program zapisujący i czytający przypisują nazwie polecenia to samo znaczenie.
Program, który nie rozpoznaje polecenia, powinien zachować je bez zmian jako część komentarza. Tym różni się ono od , która przechowuje dane opisowe w początkowej sekcji partii, a nie jako polecenie w komentarzu związanym z ruchami.
Częste nieporozumienia
Osadzone polecenie a podstawowy standard PGN
Forma [%command ...] jest udokumentowana w dodatku i mieści się w poprawnym komentarzu PGN, lecz nie należy do pierwotnej specyfikacji podstawowej.
Osadzone polecenie a para znaczników
Polecenie znajduje się w komentarzu tekstu ruchów. Para znaczników znajduje się w nagłówku i opisuje partię jako całość.
Zobacz terminŹródła
- 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
