Fichiers PGN : lire, créer et partager une partie

PGN, ou Portable Game Notation, est un format de texte brut destiné à enregistrer des parties d'échecs. Un enregistrement PGN associe des paires de balises — comme les noms des joueurs et le résultat — aux coups en notation algébrique, aux commentaires et aux variantes facultatives. Il est lisible par les humains et importable dans la plupart des logiciels d'échecs.

Ce guide appartient à la collection des outils d'échecs. Associez une exportation PGN propre à la check-list d'analyse de partie pour préserver à la fois les coups et le raisonnement derrière les décisions critiques.

Les deux parties d'une partie PGN

Un enregistrement PGN contient :

1. des paires de balises entre crochets ; et
2. le texte des coups, avec les coups numérotés et le résultat.

Exemple :

[Event "Training Game"]
[Site "Online"]
[Date "2026.07.16"]
[Round "1"]
[White "Player A"]
[Black "Player B"]
[Result "1-0"]

1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 1-0

La ligne vide entre les balises et les coups améliore la compatibilité et la lisibilité.

Les sept balises standard

La liste standard est :

• Event : tournoi ou nom de la partie ;
• Site : lieu ou plateforme ;
• Date : normalement YYYY.MM.DD ;
• Round : identifiant de la ronde ;
• White : joueur avec les Blancs ;
• Black : joueur avec les Noirs ; et
• Result : 1-0, 0-1, 1/2-1/2 ou *.

Des balises supplémentaires peuvent conserver les classements, les codes d'ouverture, la cadence, la cause de la fin, l'annotateur ou d'autres métadonnées. Leur prise en charge varie selon les logiciels.

Les coups emploient la notation algébrique

Des coups comme e4, Nf3, Bxc6, O-O et e8=Q suivent la notation algébrique. Les numéros organisent les tours des Blancs et des Noirs.

Le résultat final dans le texte des coups doit correspondre à la balise Result. Apprenez les symboles dans le guide de la notation algébrique aux échecs.

Commentaires

Les accolades contiennent les commentaires :

12. d5 {Les Blancs ferment le centre et gagnent de l'espace à l'aile dame.}

Dans certains contextes PGN, un point-virgule peut introduire un commentaire jusqu'à la fin de la ligne. Les accolades restent plus claires pour des annotations portables.

Les commentaires utiles expliquent :

• la menace ;
• les coups candidats ;
• la structure de pions ;
• le temps à la pendule ;
• l'évaluation en toutes lettres ; et
• la leçon tirée d'une erreur.

Évitez de remplir le fichier de nombres de moteur non expliqués.

Variantes

Les parenthèses contiennent les variantes :

10. Re1 (10. d4 exd4 11. cxd4) 10...O-O

Les variantes peuvent être imbriquées, mais une grande profondeur devient difficile à lire. Gardez la principale solution de remplacement instructive et supprimez les branches qui n'expliquent aucune décision.

Symboles d'annotation et NAG

Les symboles lisibles comprennent !, ?, !? et ?!. Les Numeric Annotation Glyphs (NAG) utilisent des codes comme $1 pour signaler un bon coup dans les PGN destinés aux logiciels.

Les applications peuvent afficher différemment le même symbole. Employez un commentaire lorsque la raison compte.

Commencer depuis une position personnalisée

Une partie qui ne débute pas dans la position initiale standard utilise des balises de configuration :

[SetUp "1"]
[FEN "8/8/8/4k3/8/4K3/4P3/8 w - - 0 1"]

Le FEN doit contenir les six champs et les coups doivent être légaux depuis cette position. Lisez le guide des positions FEN avant de créer un PGN à position initiale personnalisée.

PGN ou FEN

• Le PGN conserve une partie, ses coups, ses métadonnées, ses commentaires et ses variantes.
• Le FEN conserve l'instantané d'une position et un état limité.

Utilisez le PGN pour revoir et rejouer une partie. Employez le FEN pour partager un seul problème ou une position d'analyse.

Importer un PGN en toute sécurité

Avant l'importation :

1. confirmez que le fichier est en texte brut ;
2. recherchez les informations privées dans les balises ;
3. vérifiez la concordance du résultat ;
4. validez la légalité des coups ;
5. contrôlez tout FEN de départ personnalisé ;
6. conservez le fichier d'origine ; et
7. vérifiez que l'application cible accepte commentaires et variantes.

Un analyseur peut rejeter une partie mal formée alors que les autres parties du fichier restent valides.

Problèmes de syntaxe fréquents

• Guillemet ou crochet fermant absent dans une balise.
• Désaccord entre la balise de résultat et le résultat final des coups.
• Coup algébrique illégal ou ambigu.
• Accolades de commentaire ou parenthèses de variante non équilibrées.
• Position personnalisée sans SetUp "1".
• FEN incomplet.
• Encodage de caractères non standard.
• Plusieurs parties sans séparation claire.

Validez le fichier après toute modification manuelle.

Partage et confidentialité

Les balises PGN peuvent révéler noms, pseudonymes, lieux, dates, classements et annotations. Avant de publier :

• retirez les données personnelles inutiles à l'analyse ;
• demandez l'autorisation pour les commentaires privés ;
• évitez d'exposer l'identité ou l'emploi du temps d'un enfant ;
• vérifiez les conditions de réutilisation des parties sur la plateforme ; et
• conservez l'attribution lorsqu'elle est requise.

Le texte brut se copie facilement, ce qui rend la vérification de la confidentialité particulièrement importante.

Une méthode d'annotation utile

1. Exportez la partie d'origine.
2. Ajoutez vos pensées sans moteur.
3. Repérez les positions critiques.
4. Ajoutez une ou deux variantes candidates.
5. Vérifiez avec un moteur.
6. Remplacez les évaluations brutes par des explications.
7. Enregistrez une nouvelle copie annotée.

Conservez l'original intact afin de pouvoir récupérer l'historique des coups et les métadonnées.

Questions fréquentes

Un fichier PGN peut-il contenir plusieurs parties ?

Oui. Elles sont enregistrées sous forme de blocs PGN successifs, chacun avec ses propres balises et son texte de coups.

Le PGN est-il une vidéo ou une image de l'échiquier ?

Non. C'est du texte. Le logiciel d'échecs reconstruit l'échiquier à partir des coups.

Le PGN peut-il stocker des variantes d'analyse ?

Oui. Les parenthèses contiennent les variantes récursives d'annotation et les accolades contiennent les commentaires.

Pourquoi mon PGN ne s'importe-t-il pas ?

Vérifiez les guillemets des balises, la cohérence du résultat, l'équilibre des accolades et des parenthèses, la légalité de la notation et tout FEN personnalisé.

Référence : Portable Game Notation Specification.