Le format PGN expliqué : comment lire et écrire la notation d’échecs

Tout sur le standard PGN en langage clair : balises, texte des coups, annotations et résultats pour lire, créer et corriger n’importe quel fichier de partie.

Le PGN — Portable Game Notation— est le standard en texte brut que presque tous les logiciels d’échecs utilisent pour enregistrer les parties. Il peut sembler austère la première fois qu’on l’ouvre dans un éditeur de texte, mais sa logique est limpide dès lors que l’on comprend son découpage. Voici le rôle de chaque élément d’un fichier PGN.

Les deux sections de tout fichier PGN

Une partie au format PGN comporte toujours deux blocs distincts : une série de balises d’en-tête (tag pairs) en haut, suivie du texte des coups (movetext) en dessous. Les balises décrivent les circonstances du match ; le texte des coups constitue la partie proprement dite.

Les balises d’en-tête (Tag pairs)

Une balise se présente sous la forme [Event "Championnat du Monde"] — un intitulé entre crochets suivi de la valeur entre guillemets. La norme PGN fixe une liste minimale de sept balises indispensables appelée le Seven Tag Roster :

• Event— l’intitulé du tournoi ou de la rencontre.
• Site — le lieu où la partie a été disputée.
• Date — au format AAAA.MM.JJ, avec ?? pour les éléments inconnus.
• Round — le numéro de la ronde, le cas échéant.
• White et Black — les noms des deux joueurs.
• Result — 1-0, 0-1, 1/2-1/2 ou *si la partie n’est pas terminée.

La plupart des outils exportent aussi des balises optionnelles comme ECO(code de l’ouverture), WhiteElo, BlackElo ou TimeControl. Aucune n’est strictement exigée pour qu’un logiciel puisse lire les coups — un analyseur n’a besoin que du texte des coups —, mais les renseigner aide à bien classer sa bibliothèque de parties.

Le texte des coups (Movetext)

Après les balises viennent les coups réels, formulés selon la notation algébrique standard avec numérotation :

1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 4. Ba4 Nf6 5. O-O Be7 1-0

Chaque coup blanc est précédé de son numéro et d’un point ; la réponse noire s’enchaîne sans numéro supplémentaire (bien que la mention 5...Be7soit autorisée et fréquente lorsqu’un commentaire s’intercale). Le texte s’achève obligatoirement par le score final, identique à celui de la balise Result.

Commentaires et annotations

Les remarques en texte libre s’insèrent entre accolades : 3. Bb5 {Partie Espagnole}. Les variantes secondaires envisagées par le commentateur se placent entre parenthèses et peuvent s’imbriquer. Les symboles d’annotation numérique (NAG), tels que $1 (bon coup, « ! ») ou $4(gaffe, « ?? »), fournissent un moyen universel et compact de qualifier la qualité du jeu. La grande majorité des analyseurs nettoie automatiquement ces annotations pour ne dérouler que la variante maîtresse.

Un exemple minimal et parfaitement valide

Au-delà du canevas de base, les balises sont facultatives et peuvent rester vides. L’exemple suivant constitue un fichier PGN complet et valide :

[Event "?"] [Site "?"] [Date "????.??.??"] [Round "?"] [White "?"] [Black "?"] [Result "*"] 1. e4 e5 *

C’est pour cette raison que recopier une feuille de partie à la main fonctionne très bien : il est inutile de renseigner chaque champ pour qu’un programme reconnaisse et analyse le fichier. Retrouvez d’autres exemples de PGN prêts à l’emploi si vous souhaitez copier des parties complètes.

Erreurs de mise en forme fréquentes

Quelques écueils peuvent bloquer les lecteurs stricts : employer la notation descriptive au lieu de la notation algébrique (P-K4 au lieu de e4), oublier de refermer des parenthèses ou accolades, et omettre le score final. Un lecteur tolérant passera sur une balise manquante, mais une ligne de coups mal syntaxée reste la première cause de rejet d’un import.

Une fois votre fichier au point, collez-le dans Chesslume pour lancer une analyse Stockfish immédiate — sans installation et sans avoir à mémoriser les spécifications techniques du format.