> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/specifique-a-un-domaine/05-chess-notation.md). # Notation des échecs ## Introduction Cet article explore les bases de la composition typographique des échecs, notamment [de brefs aperçus/résumés de certaines conventions d'échecs](#chess-conventions-a-brief-review) que vous pourriez rencontrer dans la documentation des packages LaTeX pour les échecs. Les lecteurs qui n'ont pas besoin de ce matériel introductif peuvent passer directement aux [exemples de packages LaTeX](#a-first-example-with-the-xskak-package). ## Un seul package pour les gouverner tous Le dépôt CTAN répertorie un certain nombre de [packages liés aux échecs](https://ctan.org/search?phrase=chess\&ext=false&_PKG=\&PKG=on&_AUTHORS=\&AUTHORS=on&_TOPICS=\&TOPICS=on&_FILES=&_PORTAL=\&PORTAL=on\&wildcard=on\&max=32), vous vous demandez peut-être lequel choisir ? Cet article utilise [`xskak` package](https://ctan.org/pkg/xskak?lang=en), qui est fortement recommandé pour la composition des échecs en raison de sa large gamme de fonctionnalités, de ses nombreuses options de configuration et de son excellente documentation. `xskak` charge et étend le [`skak` package](https://ctan.org/pkg/skak?lang=en) et charge également le [`chessboard` package](https://ctan.org/pkg/chessboard?lang=en) qui offre un vaste éventail d'options pour configurer et créer des échiquiers. Les exemples fournis dans cet article ne peuvent pas remplacer la *excellente* documentation accompagnant les [`xskak`](https://texdoc.org/serve/xskak/0) et [`chessboard`](https://texdoc.org/serve/chessboard/0) packages, que nous vous encourageons vivement à parcourir, consulter et explorer, car les deux ensembles de documentation contiennent de nombreux exemples très utiles. **Remarque**: Les deux `skak` et `xskak` peuvent analyser et composer des parties d'échecs dans (un sous-ensemble de) la [Portable Game Notation (PGN)](#portable-game-notation). `xskak` étend le sous-ensemble de PGN pris en charge par `skak`. **Anecdote**: « skak » est le mot danois pour échecs. ### Quelques remarques Voici quelques points importants notés dans la `xskak` documentation : > `xskak` chargera le package `skak` sans option (et ne lui transmettra pas d'options). Donc, si vous voulez charger `skak` avec des options, vous devez le faire avant de charger le package `xskak`. > `xskak` est une extension (et non un remplacement) du **le travail principal est toujours effectué par le package `skak`**... veuillez d'abord lire la documentation du package `skak`... * **Remarque**: Parmi les packages liés aux échecs [répertoriés sur CTAN](https://ctan.org/search?phrase=chess\&ext=false&_PKG=\&PKG=on&_AUTHORS=\&AUTHORS=on&_TOPICS=\&TOPICS=on&_FILES=&_PORTAL=\&PORTAL=on\&wildcard=on\&max=32) se trouve un package appelé [`skaknew`](https://ctan.org/pkg/skaknew). Malgré son nom, le `skaknew` package est *ne* une nouvelle version ou une version améliorée du `skak` package : il s'agit d'un ensemble de polices d'échecs Type 1. Le `xskak` package utilise les `skaknew` polices, donc il n'est pas nécessaire de les charger manuellement dans votre projet. ### Exemple minimal avec xskak Pour planter le décor, et sans explication supplémentaire, voici un exemple minimal `xskak` de package qui compose deux échiquiers : l'un est vide, l'autre contient toutes les pièces d'échecs dans leur position initiale : ```latex \documentclass{article} % Remarque : il suffit de charger xskak, % pas les packages skak ou chessboard. \usepackage{xskak} \begin{document} % Cette commande \chessboard dessine % un échiquier vide : l'option % showmover=false sera abordée % plus loin dans l'article \chessboard[showmover=false] % La commande \newchessgame % initialise une nouvelle partie : \newchessgame % Parce qu'une nouvelle partie a été initialisée, % \chessboard dessine maintenant un % échiquier avec des pièces d'échecs : \chessboard Le petit carré blanc à droite du deuxième échiquier s'appelle l'\textit{indicateur de trait}. \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=A+basic+xskak+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Note%3A+you+only+need+to+load+xskak%2C%0A%25+not+the+skak+or+chessboard+packages.%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%25+This+%5Cchessboard+command+draws+%0A%25+an+empty+chess+board%3A+the+option%0A%25+showmover%3Dfalse+will+be+discussed%0A%25+later+in+the+article%0A%5Cchessboard%5Bshowmover%3Dfalse%5D%0A%25+The+%5Cnewchessgame+command+%0A%25+initializes+a+new+game%3A%0A%5Cnewchessgame%0A%25+Because+a+new+game+was+initialized%2C+%0A%25+%5Cchessboard+now+draws+a+%0A%25+board+with+chess+pieces%3A%0A%5Cchessboard%0AThe+small+white+square+to+the+right+of+the+second+board+is+called+the+%5Ctextit%7Bmover%7D.%0A%5Cend%7Bdocument%7D) Ce `xskak` produit le résultat suivant : ![](/files/af33a93792280bb5910ba7b5f6036718b81a9a88) ## Conventions d'échecs : bref rappel À l'intention des lecteurs nouveaux aux échecs, en particulier à leur composition typographique, les sections suivantes fournissent *de brèves* introductions aux sujets et conventions que vous rencontrerez dans les packages LaTeX pour les échecs et leur documentation associée. Les lecteurs familiers des conventions des échecs peuvent sauter ces sections et passer aux exemples LaTeX. ### Portable Game Notation Les packages skak et xskak prennent en charge un sous-ensemble de la [Portable Game Notation](https://en.wikipedia.org/wiki/Portable_Game_Notation) (PGN), une norme inventée vers 1994 par [Steven Edwards](https://www.chessprogramming.org/Steven_Edwards). La spécification originale de PGN, datée de 1994, est [disponible sur archive.org](https://archive.org/details/pgn-standard-1994-03-12). Un lien direct vers la norme est . Selon [le texte de la norme PGN](https://tim-mann.org/Standard): > PGN est l'abréviation de « Portable Game Notation », une norme conçue pour représenter les données des parties d'échecs à l'aide de fichiers texte ASCII. PGN est structuré pour être facilement lu et écrit par des humains et pour être facilement analysé et généré par des programmes informatiques... PGN est proposé comme une représentation portable universelle pour l'échange de données. Notez que les fichiers PGN sont conçus pour l' *échange de **partie** données*; c'est-à-dire que les fichiers PGN sont conçus pour contenir *la partie complète* des informations — telles que le nom des joueurs, les détails de l'événement/de la date, etc. — ainsi qu'un enregistrement, en notation algébrique, de *tous les coups* de la partie. **Remarque**: Pour une autre courte introduction à PGN, visitez ### Rangs et colonnes de l'échiquier Un échiquier est une grille 8×8 de cases qui pourrait, normalement, être décrite comme 8 rangées horizontales et 8 colonnes verticales ; toutefois, une terminologie différente est utilisée pour décrire un échiquier : * il y a 8 ***rangs*** (au lieu de rangées) * il y a 8 ***fichiers*** (au lieu de colonnes) Chaque case de l'échiquier peut être identifiée (nommée) à l'aide de [plusieurs conventions](https://en.wikipedia.org/wiki/Chessboard#Board_notation) mais le [notation algébrique](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) (système de coordonnées) est la norme internationale acceptée. ### Notation algébrique Dans le système de notation algébrique, les rangs et colonnes sont étiquetés comme suit : * les 8 ***rangs*** sont étiquetées à l'aide des chiffres `1` à `8` * les 8 ***fichiers*** sont étiquetées à l'aide des lettres `a` à `h`. Le diagramme suivant montre un échiquier avec les étiquettes de notation algébrique utilisées pour les colonnes et les rangs : ![](/files/c3dc1647f62b6ebb28b8f65c5fe76541ec38b87c) Chaque case de l'échiquier se trouve à l'intersection d'une colonne (file) et d'un rang (row) particuliers : la valeur correspondante de la colonne et du rang peut être utilisée comme coordonnées pour identifier de manière unique chaque case afin de décrire la position et le déplacement des pièces d'échecs. À titre d'exemple, le diagramme suivant montre la case située en **e7** suivie d'un second échiquier qui énumère l'emplacement des 64 cases : ![](/files/58a96f5f5826e68dbbbe40156bcdc70873b0a9e7) Si vous débutez aux échecs, la page Wikipédia [Notation algébrique](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) contient quelques informations de contexte utiles, dont nous résumons certaines ci-dessous. ### Notation des pièces d'échecs Chaque type de pièce d'échecs, généralement à l'exception des pions, est identifié par une lettre majuscule qui peut varier selon la langue utilisée. Les joueurs anglophones utilisent les lettres suivantes : | Lettre | Pièces | | ------ | -------- | | K | Roi | | Q | Dame | | R | Tour | | B | Fou | | N | Cavalier | Dans la notation algébrique standard, les pions ne sont pas *généralement* identifiés par une lettre majuscule ; ils sont plutôt reconnaissables à l' *absence* d'une lettre majuscule. Cependant, cette convention n'est pas toujours adoptée ; la lettre majuscule P peut être utilisée pour identifier les pions. Dans [Forsyth-Edwards Notation (FEN)](#forsyth-edwards-notation-fen) les lettres majuscules et minuscules sont utilisées pour représenter les pièces d'échecs. ### Notation pour un coup individuel Pour enregistrer le déplacement d'une pièce d'échecs, vous devez identifier la pièce et sa case de destination. Cela peut être fait en utilisant la lettre majuscule de la pièce plus les coordonnées de la case de destination. **Remarque**: lorsqu'on décrit un coup de pion, une lettre indiquant que la pièce est un pion n'est pas *généralement* utilisée ; seule la case de destination est *généralement* indiquée, comme le montrent les exemples suivants : * *non-pion* coups : * **Be5**: **B**le fou se déplace vers la case **e5** * **Nf3**: le c**N**avalier se déplace vers la case **f3** * *pion* coups : * **c5**: un pion se déplace vers la case **c5** * **Remarque**: dans certaines circonstances (par ex., certaines commandes LaTeX), les pions *sont identifiés* par une lettre majuscule **P**; ainsi **c5** pourrait être écrit **Pc5**. #### Trois points (...) indication d'un coup des pièces noires La section 8.2.2.2 de la [norme Portable Game Notation](https://tim-mann.org/Standard) explique l'utilisation de trois points (...) après un indicateur de numéro de coup (par ex., **3...e6**): > Un indicateur de numéro de coup blanc est formé à partir de l'entier donnant le numéro du coup complet auquel on ajoute un seul point. Un indicateur de numéro de coup noir est formé à partir de l'entier donnant le numéro du coup complet auquel on ajoute ***trois points***. ### Convention pour une série de coups Comme expliqué dans l'article Wikipédia sur [Notation algébrique](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)#Formatting), pour décrire une série de coups : * chaque coup individuel *généralement* utilise des lettres majuscules pour les pièces autres que les pions, bien que, comme indiqué ci-dessus, dans certaines circonstances (conventions) un P majuscule puisse être utilisé pour indiquer un coup de pion. * une série de coups d'échecs est une séquence de ` ` paires — notez que chaque paire de coups est numérotée (voir l'exemple ci-dessous) ### Autres notations d'échecs : FAN et FEN #### Figurine Algebraic Notation (ou FAN) Les lettres propres à une langue utilisées pour représenter les pièces d'échecs sont souvent remplacées par des symboles universellement reconnus représentant les pièces d'échecs. Cette représentation symbolique est connue sous le nom de Figurine Algebraic Notation, ou FAN. Par exemple, le symbole ♞ (ou ♘) peut être utilisé à la place de N (pour knight). La spécification Unicode encode les caractères d'échecs dans l'ensemble des [symboles divers](https://www.unicode.org/charts/PDF/U2600.pdf). Le tableau suivant répertorie la valeur Unicode, le nom et le symbole représentatif de chaque caractère d'échecs — les glyphes réels (dessins de caractères) utilisés pour afficher les symboles d'échecs dépendront des paramètres de polices de votre appareil/navigateur. |

Symbole représentatif
(glyphe)

|

Valeur Unicode
(en HEX)

|

Nom du caractère Unicode
(formel)

| | ---------------------------------------- | --------------------------------- | ------------------------------------------- | | ♔ | 2654 | ROI BLANC | | ♕ | 2655 | DAME BLANCHE | | ♖ | 2656 | TOUR BLANCHE | | ♗ | 2657 | FOU BLANC | | ♘ | 2658 | CAVALIER BLANC | | ♙ | 2659 | PION BLANC | | ♚ | 265A | ROI NOIR | | ♛ | 265B | DAME NOIRE | | ♜ | 265C | TOUR NOIRE | | ♝ | 265D | FOU NOIR | | ♞ | 265E | CAVALIER NOIR | | ♟ | 265F | PION NOIR | #### Forsyth-Edwards Notation (FEN) Comme indiqué, PGN est utilisé pour le stockage et l'échange de *parties entières*, y compris tous les coups joués dans cette partie. En revanche, le [Forsyth-Edwards Notation (FEN)](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) fournit un instantané d'une partie à un moment donné. La notation FEN utilise des lettres majuscules et minuscules pour représenter les pièces d'échecs : * les pièces blanches sont identifiées par des lettres majuscules (PNBRQK) * les pièces noires sont identifiées par des lettres minuscules (pnbrqk) où P désigne un pion blanc et p un pion noir. Une discussion détaillée de FEN, et de sa comparaison avec PGN, dépasse le cadre de cet article. Les lecteurs souhaitant mieux comprendre les différences entre PGN et FEN peuvent vouloir consulter la vidéo suivante : {% embed url="" %} ## Un premier exemple avec le package xskak ### Saisir vos coups Pour composer les coups d'échecs au fur et à mesure de la partie, vous utilisez la commande `\mainline{*list of moves*}` où `*liste des coups*` est exprimée en [notation algébrique des échecs](#algebraic-notation). Nous allons montrer la composition de la séquence de coups suivante : 1. **e4 e5**: le pion blanc va en **e4**, le pion noir va en **e5** 2. **Nf3 Nc6**: le c**N**avalier va en **f3**, le c**N**avalier va en **c6** 3. **Bb5 a6**: le **B**fou va en **b5**, le pion noir va en **a6** Cette séquence de coups peut être écrite à l'aide de la [`xskak` package](https://ctan.org/pkg/xskak?lang=en) commande `\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}`—notez que chaque paire de coups est numérotée (par ex., `**1.**e4 e5`): ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6} \showboard % Une commande du package skak. Les futurs exemples utiliseront \chessboard[...] \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=First+xskak+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6%7D%0A%5Cshowboard+%25+A+skak+package+command.+Future+examples+will+use+%5Cchessboard%5B...%5D%0A%5Cend%7Bdocument%7D) Ce `xskak` produit le résultat suivant : ![](/files/799daa1b7f70a0b3d99002feeea956f46d00df28) Les commandes suivantes sont utilisées : * **`\newchessgame[〈liste clé=valeur〉]`**: démarre une nouvelle partie et initialise l'échiquier. La `[〈liste clé=valeur〉]` est facultative, vous pouvez donc aussi écrire `\newchessgame` et vous appuyer sur la configuration par défaut de l'échiquier. L'ensemble des clés facultatives est répertorié dans la [`xskak` documentation](https://texdoc.org/serve/xskak/0). * **`\mainline{〈liste des coups d'échecs〉}`**: traite la `〈liste des coups d'échecs〉` et met à jour l'échiquier de sorte que `\showboard` (ou `\chessboard`) compose l'état actuel de l'échiquier. * **`\showboard`**: compose l'échiquier. La `\showboard` commande provient du package sous-jacent `skak` package, qui `xskak` étend. La [`chessboard` package](https://ctan.org/pkg/chessboard?lang=en), qui est chargé par `xskak`, fournit la très polyvalente **`\chessboard[〈liste clé=valeur〉]`** commande à laquelle le `xskak` package ajoute des clés supplémentaires. Comme `\chessboard[...]` est destinée à remplacer `\showboard`, les futurs exemples dans cet article utiliseront uniquement `\chessboard[...]` commande. ### Présentation de la commande \chessboard La commande **`\chessboard[〈liste clé=valeur〉]`**: compose des échiquiers à l'aide d'une `〈liste clé=valeur〉`. La liste des `clés` disponibles est *un usage*, offrant un grand contrôle sur la taille, le contenu, la mise en page, la conception, les annotations, etc. des échiquiers. Les lecteurs sont encouragés à lire l'excellente documentation du package [`chessboard` (PDF)](https://texdoc.org/serve/chessboard/0) et [`xskak` (PDF)](https://texdoc.org/serve/xskak/0), qui contiennent tous deux de nombreux exemples utiles —*de nombreuses* bien plus que nous ne pouvons en montrer dans cet article. Comme les clés sont facultatives, vous pouvez écrire `\chessboard` qui utilise les valeurs par défaut du package pour composer un échiquier ; par exemple, le code suivant compose deux échiquiers en utilisant `\chessboard` sans aucune option. Des annotations supplémentaires, ajoutées manuellement dans Inkscape, montrent les *indicateurs de trait* (ici sous forme de carrés) qui sont composés par défaut : ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5} \chessboard % au lieu de \showboard \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6} \chessboard % au lieu de \showboard \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=chessboard+command+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5%7D%0A%5Cchessboard+%25+instead+of+%5Cshowboard%0A%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6%7D%0A%5Cchessboard+%25+instead+of+%5Cshowboard%0A%5Cend%7Bdocument%7D) Le graphique suivant montre les deux échiquiers produits par le code ci-dessus ; ils ont tous deux été composés en utilisant `\chessboard`: ![](/files/0ec34ab443010428c20a1b0a640091a2f42f7b28) Sans surprise, diverses clés sont fournies pour contrôler l'indicateur de trait, notamment pour l'afficher ou le masquer ; par exemple, pour masquer l'indicateur de trait vous pouvez utiliser la `showmover` clé avec une valeur de `false`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}\par \chessboard[showmover=false] % Masquer l'indicateur de trait \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Hiding+the+chessboard+mover\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6%7D%5Cpar%0A%5Cchessboard%5Bshowmover%3Dfalse%5D+%25+Hide+the+mover%0A%5Cend%7Bdocument%7D) Cet exemple produit le résultat suivant — un échiquier sans l'indicateur de trait : ![](/files/1d2fbf600d46f5bda75efcb620ce68248c089c0b) Le [`chessboard` documentation du package (PDF)](https://texdoc.org/serve/chessboard/0) fournit une liste de clés pour personnaliser l'indicateur de trait, ainsi qu'une note sur la manière de concevoir votre propre indicateur de trait ! ## Exemples supplémentaires avec xskak ### Commentaires textuels La spécification PGN prend en charge l'ajout de commentaires en utilisant des accolades autour du texte du commentaire : `{〈Texte〉}`; cependant, le `xskak` package préfère que les commentaires textuels soient écrits sous la forme `\xskakcomment{〈Texte〉}`, comme le montre l’exemple suivant : ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame %Démarrer une nouvelle partie d'échecs \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6 \xskakcomment{ Ceci est un commentaire. }}\vspace{3mm} \chessboard \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=xskak+chess+comment+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame+%25Start+a+new+chess+game%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5+a6+%5Cxskakcomment%7B+This+is+a+comment.+%7D%7D%5Cvspace%7B3mm%7D%0A%0A%5Cchessboard%0A%5Cend%7Bdocument%7D) Cet exemple produit le résultat suivant : ![](/files/8f0a4a69ea0623883abd3ea5906f05e5fb946e37) ### Initialisation d’un échiquier à l’aide de la notation FEN Vous pouvez utiliser le FEN pour commencer l’échiquier dans n’importe quelle position. L’exemple suivant utilise la `setfen` clé dans une `\chessboard` commande pour illustrer un exemple de FEN tiré de la `skak` documentation du package : ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \chessboard[setfen=r5k1/1b1p1ppp/p7/1p1Q4/2p1r3/PP4Pq/BBP2b1P/R4R1K w - - 0 20] \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=FEN+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cchessboard%5Bsetfen%3Dr5k1%2F1b1p1ppp%2Fp7%2F1p1Q4%2F2p1r3%2FPP4Pq%2FBBP2b1P%2FR4R1K+w+-+-+0+20%5D%0A%5Cend%7Bdocument%7D) Cet exemple produit le résultat suivant : ![](/files/82586bc697e9258c225f6a5797fbfa6e33543597) La notation FEN remplit l’échiquier en commençant par la rangée la plus haute (numéro 8) et progresse vers le bas pour remplir les rangées suivantes. Par exemple, pour initialiser l’échiquier ci-dessus, la rangée 8 est décrite à l’aide de **r5k1**: * **r**tour * **5** cases vides * le **roi**roi * **1** case vide d’où l’utilisation de la notation **r5k1**. Notez l’utilisation de lettres minuscules pour décrire les pièces noires d’échecs, ainsi que l’utilisation de majuscules **P** pour les pions blancs et de minuscules **p** pour les pions noirs. ### Utilisation de \lastmove Le `\lastmove` peut être utilisée pour commenter le dernier coup joué : ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4} \chessboard \lastmove{} est le coup d’ouverture le plus courant. \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=xskak+lastmove+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4%7D%0A%0A%5Cchessboard%0A%0A%5Clastmove%7B%7D+is+the+most+common+opening+move.%0A%5Cend%7Bdocument%7D) Cet exemple produit le résultat suivant : ![](/files/024eac3b69a55ef97f1e922a9edf738a5ed116f9) ### Variations et un exemple de la notation ... Ce qui suit reproduit un exemple contenu dans la `skak` documentation du paquet, mis à jour pour utiliser `xskak` commandes. Ici, nous voyons un exemple de la `\variation` commande et de la syntaxe à trois points (...) [utilisée pour indiquer un coup des Noirs](#three-dots-black-piece-move-indication): ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5} \chessboard \mainline{3...a6} Une variante \variation{3...Nf6} est utilisée ici pour montrer une commande \texttt{\string\variation}. \mainline{4.Ba4} \chessboard \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=xskak+variations+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6+3.Bb5%7D%0A%0A%5Cchessboard%0A%0A%5Cmainline%7B3...a6%7D%0A%0AA+variant+%5Cvariation%7B3...Nf6%7D+is+used+here+to+show+a+%5Ctexttt%7B%5Cstring%5Cvariation%7D+command.%0A%0A%5Cmainline%7B4.Ba4%7D%0A%0A%5Cchessboard%0A%5Cend%7Bdocument%7D) Cet exemple produit le résultat suivant : ![](/files/3c0c0f16d39bcae0b3f48c3d7aed8d89f4f6c3af) ### Afficher seulement certaines pièces d’échecs Parce que `xskak` charge le `chessboard` du paquet, vous pouvez utiliser l’extrêmement puissante **`\chessboard[〈liste clé=valeur〉]`** commande pour afficher ou masquer des zones de l’échiquier, ou des collections de pièces d’échecs, qui vous intéressent. La [documentation de chessboard](https://texdoc.org/serve/chessboard/0) contient de nombreux exemples, comme ceux reproduits ci-dessous. #### Utilisation de clés pour masquer certains champs Cet exemple utilise les clés `hideall`, `showpieces` et `addpieces`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \chessboard[hideall, showpieces={P,p}, addpieces=pe5] \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Showing+selected+pieces+in+xskak+example+1\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cchessboard%5Bhideall%2C%0Ashowpieces%3D%7BP%2Cp%7D%2C%0Aaddpieces%3Dpe5%5D%0A%5Cend%7Bdocument%7D) Ce `xskak` produit le résultat suivant : ![](/files/65c1d2d33d6fea2bd59c9451bc92b6626ae00372) Cet exemple utilise les clés `hidefiles`, `showfiles` et `showranks`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \def\myfiles{a,b} \chessboard[hidefiles=\myfiles, addpieces=Ra2, showfiles=a, showranks=2] \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Showing+selected+pieces+in+xskak+example+2\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cdef%5Cmyfiles%7Ba%2Cb%7D%0A%5Cchessboard%5Bhidefiles%3D%5Cmyfiles%2C%0Aaddpieces%3DRa2%2C%0Ashowfiles%3Da%2C%0Ashowranks%3D2%5D%0A%5Cend%7Bdocument%7D) Ce `xskak` produit le résultat suivant : ![](/files/4b7ebf0a6f51ffab34c0a46a5ac95d9ddb711ed7) #### Utilisation de clés pour masquer toutes les pièces blanches ou toutes les pièces noires L’exemple suivant illustre les clés `hidewhite` et `hideblack`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6}\chessboard[hidewhite] \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6}\chessboard[hideblack] \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Showing+selected+pieces+in+xskak+example+3\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6%7D%5Cchessboard%5Bhidewhite%5D%0A%0A%5Cnewchessgame%0A%5Cmainline%7B1.e4+e5+2.Nf3+Nc6%7D%5Cchessboard%5Bhideblack%5D%0A%5Cend%7Bdocument%7D) Ce `xskak` produit le résultat suivant : ![](/files/c3e47a4a3ccaf24c836f4687b5a1067e72148f43) ## Autres exemples de tex.stackexchange Les exemples suivants utilisent des solutions trouvées sur [tex.stackexchange.com](https://tex.stackexchange.com). ### Comment mettre des cases en surbrillance ? Source : basé sur ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newgame \chessboard[setfen=8/8/8/3Q4/8/8/8/8 w - - 0 0, pgfstyle=border,markfields={d4,d6}, color=blue!50, colorbackfield=c5, pgfstyle=color, opacity=0.5, color=red, markfield={d5}] \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Highlighting+chess+board+squares\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewgame%0A%5Cchessboard%5Bsetfen%3D8%2F8%2F8%2F3Q4%2F8%2F8%2F8%2F8+w+-+-+0+0%2C%0A++++++++++++pgfstyle%3Dborder%2Cmarkfields%3D%7Bd4%2Cd6%7D%2C%0A++++++++++++color%3Dblue%2150%2C%0A++++++++++++colorbackfield%3Dc5%2C%0A++++++++++++pgfstyle%3Dcolor%2C%0A++++++++++++opacity%3D0.5%2C%0A++++++++++++color%3Dred%2C%0A++++++++++++markfield%3D%7Bd5%7D%5D%0A%5Cend%7Bdocument%7D) ![](/files/7fd9ef518361fc471170c0f57e2c1a626b2b45fd) ### Création de différents styles d’échiquier Source : basé sur ```latex \documentclass{article} \usepackage{xskak} \begin{document} \storechessboardstyle{4x16}{% maxfield=d16, borderwidth=1mm, color=white, colorwhitebackfields, color=black, colorblackbackfields, blackfieldmaskcolor=black, whitepiececolor=yellow, whitepiecemaskcolor=red, blackpiececolor=cyan, blackpiecemaskcolor=blue, addfontcolors, pgfstyle=border, color=white, markregion=a1-d16, showmover=false, hlabelwidth=18pt, vlabellift=16pt} \chessboard[ style=4x16, setpieces={Qa8,Qb4,Qc1,Qd3,Qb16,Qc12,Qa7,Qc15,qa1,qb14,qc11,qd13,qb6,qc2,qa4,qc5}, padding=1ex, ] \end{document} ``` [Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+custom+chess+board\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxskak%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cstorechessboardstyle%7B4x16%7D%7B%25%0A++maxfield%3Dd16%2C%0A++borderwidth%3D1mm%2C%0A++color%3Dwhite%2C%0A++colorwhitebackfields%2C%0A++color%3Dblack%2C%0A++colorblackbackfields%2C%0A++blackfieldmaskcolor%3Dblack%2C%0A++whitepiececolor%3Dyellow%2C%0A++whitepiecemaskcolor%3Dred%2C%0A++blackpiececolor%3Dcyan%2C%0A++blackpiecemaskcolor%3Dblue%2C%0A++addfontcolors%2C%0A++pgfstyle%3Dborder%2C%0A++color%3Dwhite%2C%0A++markregion%3Da1-d16%2C%0A++showmover%3Dfalse%2C%0A++hlabelwidth%3D18pt%2C%0A++vlabellift%3D16pt%7D%0A++%5Cchessboard%5B%0A++++style%3D4x16%2C%0A++++setpieces%3D%7BQa8%2CQb4%2CQc1%2CQd3%2CQb16%2CQc12%2CQa7%2CQc15%2Cqa1%2Cqb14%2Cqc11%2Cqd13%2Cqb6%2Cqc2%2Cqa4%2Cqc5%7D%2C%0A++++padding%3D1ex%2C%0A++%5D%0A%5Cend%7Bdocument%7D) Ce `xskak` produit le résultat suivant : ![](/files/35773492b8c615265b25f9b13c6333a95d44c56e) ## Lectures complémentaires Pour plus d'informations, voir : * [Créer un document en LaTeX](/latex/fr/bases-de-latex/01-learn-latex-in-30-minutes.md) * [Insertion d'images](/latex/fr/autres-sujets/27-inserting-images.md) * [Positionnement des images et des tableaux](/latex/fr/figures-et-tableaux/02-positioning-images-and-tables.md) * [Prise en charge des langues internationales](/latex/fr/langues/03-international-language-support.md) * [Tailles, familles et styles de police](/latex/fr/polices/01-font-sizes-families-and-styles.md) * [Familles de polices](/latex/fr/polices/02-font-typefaces.md) * [Gestion dans un grand projet](/latex/fr/structure-du-document/07-management-in-a-large-project.md) * [Le `skak` package](https://ctan.org/pkg/skak?lang=en) * [Le `xskak` package](https://ctan.org/pkg/xskak?lang=en) * [Notation algébrique aux échecs (sur Wikipédia)](http://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) * [Notation Forsyth-Edwards (FEN) (sur Wikipédia)](http://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) * [Le `chessboard` package](https://ctan.org/pkg/chessboard?lang=en) * [Texte de la norme PGN](https://tim-mann.org/Standard) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fr/specifique-a-un-domaine/05-chess-notation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.