Explication
PGN signifie Portable Game Notation, un format texte destiné à consigner des parties. Une paire de balises PGN stocke un fait descriptif sur une partie. Elle comporte quatre éléments consécutifs : un crochet ouvrant, un nom de balise, une valeur entre guillemets et un crochet fermant. Dans [White "Carlsen, Magnus"], White est le nom et Carlsen, Magnus la valeur.
Le nom ne peut contenir que des lettres, des chiffres et des traits de soulignement, et il distingue les majuscules des minuscules. White et white seraient donc des noms différents. Un même nom de balise ne doit pas apparaître plus d'une fois dans la section de balises d'une partie.
Dans la valeur, un guillemet littéral est précédé d'une barre oblique inverse, et une barre oblique inverse littérale est doublée. Les sauts de ligne et les tabulations ne sont pas autorisés à l'intérieur de la chaîne entre guillemets.
Les paires de balises sont regroupées au début de la partie, avant le . Des balises comme Event, Date, White et Result décrivent l'événement, la date, les joueurs et le résultat. D'autres balises peuvent contenir des informations supplémentaires, comme une position initiale non standard ou la cadence.
Le exige exactement un espace entre le nom et la valeur, une paire par ligne et une ligne vide après la section. Le format d'importation autorise des espacements et des sauts de ligne plus souples. La structure logique de la paire de balises reste identique.
Confusions fréquentes
Paire de balises et liste des sept balises
Une paire représente un seul fait. La liste des sept balises est l'ensemble obligatoire de sept paires précises.
Voir le termeBalise Result et marqueur final
Result apparaît dans l'en-tête comme donnée descriptive. La même valeur doit être répétée à la fin du texte des coups.
Sources
- 1.Standard: Portable Game Notation Specification and Implementation Guide, Steven J. Edwards / ChessGML
