> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/latex/it/specifico-per-argomento/05-chess-notation.md).

# Notazione scacchistica

## Introduzione

Questo articolo esplora le basi dell'impaginazione degli scacchi, tra cui [brevi recensioni/riassunti di alcune convenzioni scacchistiche](#chess-conventions-a-brief-review) che potresti incontrare nella documentazione del pacchetto LaTeX per gli scacchi. I lettori che non hanno bisogno di questo materiale introduttivo possono passare direttamente agli [esempi del pacchetto LaTeX](#a-first-example-with-the-xskak-package).

## Un solo pacchetto per domarli tutti

Il repository CTAN elenca una serie di [pacchetti relativi agli scacchi](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), quindi potresti chiederti quale scegliere? Questo articolo usa [`xskak` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/xskak?lang=en), che è altamente raccomandato per l'impaginazione degli scacchi grazie alla sua ampia gamma di funzionalità, alle numerose opzioni di configurazione e all'ottima documentazione. `xskak` carica ed estende l'originale [`skak` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/skak?lang=en) e carica anche [`chessboard` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/chessboard?lang=en) che offre un'enorme gamma di opzioni per configurare e creare scacchiere.

Gli esempi forniti in questo articolo non possono sostituire la *eccellente* documentazione che accompagna i [`xskak`](https://texdoc.org/serve/xskak/0) e [`chessboard`](https://texdoc.org/serve/chessboard/0) pacchetti, che ti incoraggiamo vivamente a consultare, esaminare ed esplorare perché entrambi i set di documentazione contengono numerosi, e molto utili, esempi.

**Nota**: Entrambi `skak` e `xskak` possono analizzare e impaginare partite di scacchi in (un sottoinsieme della [Portable Game Notation (PGN)](#portable-game-notation). `xskak` estende il sottoinsieme di PGN supportato da `skak`.

**Curiosità**: skak è la parola danese per scacchi.

### Alcune note

Ecco alcuni punti importanti segnalati nella `xskak` documentazione:

> `xskak` caricherà il pacchetto `skak` senza opzioni (e non gli passerà opzioni). Quindi, se vuoi caricare `skak` con opzioni, devi farlo prima di caricare il pacchetto `xskak`.

> `xskak` è un'estensione (e non un sostituto) dell' **il lavoro principale è ancora svolto dal pacchetto `skak`**... leggi prima la documentazione del pacchetto `skak`...

* **Nota**: Tra i pacchetti relativi agli scacchi [elencati su 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) ce n'è uno chiamato [`skaknew`](https://ctan.org/pkg/skaknew). Nonostante il nome, il `skaknew` pacchetto è *non* una nuova versione o una versione migliorata dell'originale `skak` pacchetto: è un insieme di font per scacchi di tipo 1. Il `xskak` pacchetto utilizza i `skaknew` font, quindi non c'è bisogno che tu li carichi manualmente nel tuo progetto.

### Esempio minimo di xskak

Per "impostare la scena", e senza ulteriori spiegazioni, ecco un esempio minimo di `xskak` esempio di pacchetto che compone due scacchiere: una è vuota, l'altra ha tutti i pezzi degli scacchi nelle loro posizioni iniziali:

```latex
\documentclass{article}
% Nota: devi caricare solo xskak,
% non i pacchetti skak o chessboard.
\usepackage{xskak}
\begin{document}
% Questo comando \chessboard disegna
% una scacchiera vuota: l'opzione
% showmover=false sarà discussa
% più avanti nell'articolo
\chessboard[showmover=false]
% Il comando \newchessgame
% inizializza una nuova partita:
\newchessgame
% Poiché è stata inizializzata una nuova partita,
% \chessboard ora disegna una
% scacchiera con i pezzi degli scacchi:
\chessboard
Il piccolo quadrato bianco a destra della seconda scacchiera si chiama \textit{mover}.
\end{document}
```

[Apri questo esempio in 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)

Questo `xskak` esempio produce il seguente output:

![](/files/a49021141ae7f98d969038bf67dd190c16addf3e)

## Convenzioni scacchistiche: una breve panoramica

A beneficio dei lettori che conoscono poco gli scacchi, soprattutto per quanto riguarda la loro impaginazione, le sezioni seguenti forniscono *brevi* introduzioni a temi e convenzioni che incontrerai nei pacchetti LaTeX per gli scacchi e nella relativa documentazione. I lettori che conoscono già le convenzioni scacchistiche possono saltare queste sezioni e passare agli esempi LaTeX.

### Portable Game Notation

I pacchetti skak e xskak supportano un sottoinsieme della [Portable Game Notation](https://en.wikipedia.org/wiki/Portable_Game_Notation) (PGN), uno standard inventato circa nel 1994 da [Steven Edwards](https://www.chessprogramming.org/Steven_Edwards). La specifica originale del PGN, datata 1994, è [disponibile su archive.org](https://archive.org/details/pgn-standard-1994-03-12). Un link diretto allo standard è <https://tim-mann.org/Standard>.

Secondo [il testo dello standard PGN](https://tim-mann.org/Standard):

> PGN è "Portable Game Notation", uno standard progettato per la rappresentazione dei dati delle partite di scacchi usando file di testo ASCII. PGN è strutturato per essere facilmente letto e scritto dagli utenti umani e per essere facilmente analizzato e generato dai programmi informatici... PGN è proposto come rappresentazione portatile universale per lo scambio di dati.

Nota che i file PGN sono progettati per lo *scambio di **dati di** partita*; cioè, i file PGN sono progettati per contenere *informazioni complete sulla partita* —come il nome dei giocatori, i dettagli dell'evento/data ecc., insieme a una registrazione, in notazione algebrica, di *tutte le mosse* della partita.

**Nota**: Per un'altra breve introduzione al PGN visita <http://www.enpassant.dk/chess/palview/p3manual/p3pgn.htm>

### Traverse e colonne della scacchiera

Una scacchiera è una griglia 8×8 di case che, normalmente, potrebbe essere descritta come 8 righe orizzontali e 8 colonne verticali; tuttavia, per descrivere una scacchiera si usa una terminologia diversa:

* ci sono 8 ***traverse*** (anziché righe)
* ci sono 8 ***colonne*** (anziché colonne)

Ogni casa sulla scacchiera può essere identificata (nominata) usando [diverse convenzioni](https://en.wikipedia.org/wiki/Chessboard#Board_notation) ma la [la notazione algebrica](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) (sistema di coordinate) è lo standard internazionale accettato.

### Notazione algebrica

All'interno del sistema di notazione algebrica, le traverse e le colonne sono etichettate come segue:

* le 8 orizzontali ***traverse*** sono etichettate usando i numeri `1` su `8`
* le 8 verticali ***colonne*** sono etichettate usando le lettere `un` su `h`.

Il diagramma seguente mostra una scacchiera con le etichette della notazione algebrica usate per colonne e traverse:

![](/files/0b61ad6d234bb8515f7a0b09cd618ed084239e78)

Ogni casa sulla scacchiera si trova all'incrocio di una specifica colonna e traversa: il corrispondente valore di colonna e traversa può essere usato come coordinate per identificare in modo univoco ogni casa, per descrivere la posizione e il movimento dei pezzi degli scacchi.

A titolo di esempio, il diagramma seguente mostra la casa situata in **e7** seguita da una seconda scacchiera che elenca la posizione di tutte le 64 case:

![](/files/55d6d1d97b3d69697c6ec113c65c7b2218fed440)

Se sei nuovo agli scacchi, la pagina di Wikipedia [Notazione algebrica](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) contiene alcune informazioni di sfondo utili, alcune delle quali riassumiamo di seguito.

### Notazione per i pezzi degli scacchi

Ogni tipo di pezzo degli scacchi, di solito ad eccezione dei pedoni, è identificato da una lettera maiuscola che può variare a seconda della lingua utilizzata. I giocatori anglofoni usano le seguenti lettere:

| Lettera | Pezzi   |
| ------- | ------- |
| K       | Re      |
| Q       | Donna   |
| R       | Torre   |
| B       | Alfiere |
| N       | Cavallo |

Nella notazione algebrica standard i pedoni di solito non sono *di solito* identificati da una lettera maiuscola; invece, sono riconoscibili per l' *assenza* di una lettera maiuscola. Tuttavia, quella convenzione non viene sempre adottata; la lettera maiuscola P può essere usata per identificare i pedoni. Nella [Forsyth-Edwards Notation (FEN)](#forsyth-edwards-notation-fen) le lettere maiuscole e minuscole sono usate per rappresentare i pezzi degli scacchi.

### Notazione per una singola mossa

Per registrare il movimento di un pezzo degli scacchi devi identificare il pezzo e la sua casa di destinazione. Questo può essere ottenuto usando la lettera maiuscola del pezzo più le coordinate della casa di destinazione.

**Nota**: quando si descrive la mossa di un pedone, una lettera che indichi che il pezzo è un pedone non è *di solito* usata; viene *di solito* fornita solo la casa di destinazione, come mostrano i seguenti esempi:

* *non pedone* mosse:
  * **Be5**: **B**l'alfiere si muove in **e5**
  * **Nf3**: c**N**avallo si muove in **f3**
* *pedone* mosse:
  * **c5**: un pedone si muove in **c5**
  * **Nota**: in determinate circostanze (ad es. alcuni comandi LaTeX) i pedoni *sono identificati* da una lettera maiuscola **P**; quindi **c5** potrebbe essere scritto **Pc5**.

#### Tre punti (...) indicazione della mossa del pezzo nero

La sezione 8.2.2.2 dello [standard Portable Game Notation](https://tim-mann.org/Standard) spiega l'uso di tre punti (...) dopo un indicatore del numero di mossa (ad es. **3...e6**):

> Un'indicazione del numero di mossa delle bianche è formata dall'intero che dà il numero di mossa completa con un singolo carattere punto aggiunto. Un'indicazione del numero di mossa delle nere è formata dall'intero che dà il numero di mossa completa con ***tre caratteri punto aggiunti***.

### Convenzione per una serie di mosse

Come spiegato nell'articolo di Wikipedia su [Notazione algebrica](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)#Formatting), per descrivere una serie di mosse:

* ogni mossa individuale *di solito* usa lettere maiuscole per i pezzi non pedone, anche se, come notato sopra, in alcune circostanze (convenzioni) una P maiuscola potrebbe essere usata per indicare una mossa di pedone.
* una serie di mosse degli scacchi è una sequenza di `<mossa del pezzo bianco> <mossa del pezzo nero>` coppie—nota che ogni coppia di mosse è numerata (vedi l'esempio sotto)

### Altre notazioni scacchistiche: FAN e FEN

#### Notazione algebrica figurina (o FAN)

Le lettere specifiche della lingua usate per rappresentare i pezzi degli scacchi sono spesso sostituite da simboli universalmente riconosciuti che rappresentano i pezzi degli scacchi. Questa rappresentazione simbolica è nota come Notazione algebrica figurina, o FAN. Per esempio, il simbolo ♞ (o ♘) può essere usato al posto di N (per cavallo).

La specifica Unicode codifica i caratteri degli scacchi all'interno del [insieme Simboli Vari](https://www.unicode.org/charts/PDF/U2600.pdf). La tabella seguente elenca il valore Unicode, il nome e il simbolo rappresentativo per ogni carattere degli scacchi: i glifi effettivi (i disegni dei caratteri) usati per visualizzare i simboli degli scacchi dipenderanno dalle impostazioni dei font del tuo dispositivo/browser.

| <p>Simbolo rappresentativo<br>(glifo)</p> | <p>Valore Unicode<br>(in HEX)</p> | <p>Nome del carattere Unicode<br>(formale)</p> |
| ----------------------------------------- | --------------------------------- | ---------------------------------------------- |
| ♔                                         | 2654                              | RE BIANCO DEGLI SCACCHI                        |
| ♕                                         | 2655                              | DONNA BIANCA DEGLI SCACCHI                     |
| ♖                                         | 2656                              | TORRE BIANCA DEGLI SCACCHI                     |
| ♗                                         | 2657                              | ALFIERE BIANCO DEGLI SCACCHI                   |
| ♘                                         | 2658                              | CAVALLO BIANCO DEGLI SCACCHI                   |
| ♙                                         | 2659                              | PEDONE BIANCO DEGLI SCACCHI                    |
| ♚                                         | 265A                              | RE NERO DEGLI SCACCHI                          |
| ♛                                         | 265B                              | DONNA NERA DEGLI SCACCHI                       |
| ♜                                         | 265C                              | TORRE NERA DEGLI SCACCHI                       |
| ♝                                         | 265D                              | ALFIERE NERO DEGLI SCACCHI                     |
| ♞                                         | 265E                              | CAVALLO NERO DEGLI SCACCHI                     |
| ♟                                         | 265F                              | PEDONE NERO DEGLI SCACCHI                      |

#### Forsyth-Edwards Notation (FEN)

Come notato, PGN viene usato per l'archiviazione e lo scambio di *partite complete*, incluse tutte le mosse giocate in quella partita. Al contrario, la [Forsyth-Edwards Notation (FEN)](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) fornisce un'istantanea di una partita in un dato momento. La notazione FEN usa lettere maiuscole e minuscole per rappresentare i pezzi degli scacchi:

* i pezzi bianchi sono identificati da lettere maiuscole (PNBRQK)
* i pezzi neri sono identificati da lettere minuscole (pnbrqk)

dove P è per un pedone bianco e p è per un pedone nero.

Una discussione dettagliata del FEN, e del suo confronto con PGN, esula dallo scopo di questo articolo. I lettori che desiderano comprendere meglio le differenze tra PGN e FEN potrebbero voler esplorare il seguente video:

{% embed url="<https://www.youtube.com/embed/3PvmsmqKF_I>" %}

## Un primo esempio con il pacchetto xskak

### Effettuare le tue mosse

Per impaginare le mosse degli scacchi man mano che la partita procede, si usa il comando `\mainline{*lista di mosse*}` dove `*lista di mosse*` è espresso in [notazione algebrica degli scacchi](#algebraic-notation). Dimostreremo la composizione della seguente sequenza di mosse:

1. **e4 e5**: il pedone bianco si muove in **e4**, il pedone nero si muove in **e5**
2. **Nf3 Nc6**: il cavallo bianco**N**si muove in **f3**, il cavallo nero**N**si muove in **c6**
3. **Bb5 a6**: il bianco **B**alfiere si muove in **b5**, il pedone nero si muove in **a6**

Questa sequenza di mosse può essere scritta usando [`xskak` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/xskak?lang=en) comando `\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}`—nota che ogni coppia di mosse è numerata (ad es., `**1.**e4 e5`):

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}
\showboard % Un comando del pacchetto skak. Gli esempi futuri useranno \chessboard[...]
\end{document}
```

[Apri questo esempio in 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)

Questo `xskak` esempio produce il seguente output:

![](/files/04211e086a1e573f5308e3e5903544f19cb55f43)

I seguenti comandi sono usati:

* **`\newchessgame[〈elenco chiave=valore〉]`**: avvia una nuova partita e inizializza la scacchiera. L' `[〈elenco chiave=valore〉]` è opzionale, quindi puoi anche scrivere `\newchessgame` e affidarti alla configurazione predefinita della scacchiera. L'insieme delle chiavi opzionali è elencato nella [`xskak` documentazione](https://texdoc.org/serve/xskak/0).
* **`\mainline{〈lista di mosse degli scacchi〉}`**: elabora la `〈lista di mosse degli scacchi〉` e aggiorna la scacchiera in modo che `\showboard` (o `\chessboard`) impagina lo stato attuale della scacchiera.
* **`\showboard`**: compone la scacchiera. Il `\showboard` comando ha origine dal `skak` pacchetto sottostante, che `xskak` estende. Il [`chessboard` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/chessboard?lang=en), che viene caricato da `xskak`, fornisce il molto versatile **`\chessboard[〈elenco chiave=valore〉]`** comando al quale il `xskak` pacchetto aggiunge chiavi aggiuntive. Poiché `\chessboard[...]` è destinato a sostituire `\showboard`, i futuri esempi in questo articolo useranno solo il `\chessboard[...]` comando.

### Introduzione al comando \chessboard

Il comando **`\chessboard[〈elenco chiave=valore〉]`**: compone scacchiere utilizzando un'opzionale `〈elenco chiave=valore〉`. L'elenco delle `chiavi` disponibili è *esteso*, offrendo un grande controllo su dimensioni, contenuto, layout, design, annotazione ecc. delle scacchiere. I lettori sono incoraggiati a leggere l'eccellente documentazione del pacchetto per [`chessboard` (PDF)](https://texdoc.org/serve/chessboard/0) e [`xskak` (PDF)](https://texdoc.org/serve/xskak/0), entrambe le quali contengono numerosi esempi utili—*molti* più di quanti possiamo mostrare in questo articolo.

Poiché le chiavi sono opzionali, puoi scrivere `\chessboard` che usa i valori predefiniti del pacchetto per comporre una scacchiera; per esempio, il seguente codice compone due scacchiere usando `\chessboard` senza alcuna opzione. Ulteriori annotazioni, aggiunte manualmente in Inkscape, mostrano i *mover* (qui come quadrati) composti per impostazione predefinita:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5}
\chessboard % invece di \showboard

\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}
\chessboard % invece di \showboard
\end{document}
```

[Apri questo esempio in 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)

Il grafico seguente mostra le due scacchiere prodotte dal codice sopra, entrambe sono state composte usando `\chessboard`:

![](/files/ccf64073e3196b370356ba1e9a190f760f08af93)

Non sorprende che siano disponibili varie chiavi per controllare il mover, inclusi mostrarlo o nasconderlo; per esempio, per nascondere il mover puoi usare la `showmover` chiave con un valore di `false`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}\par
\chessboard[showmover=false] % Nascondi il mover
\end{document}
```

[Apri questo esempio in 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)

Questo esempio produce il seguente output: una scacchiera senza il mover:

![](/files/9f6761cae35a48413e1ade75c17c3b4f23501d8a)

Il [`chessboard` documentazione del pacchetto (PDF)](https://texdoc.org/serve/chessboard/0) fornisce un elenco di chiavi per personalizzare il mover, insieme a una nota su come progettare il tuo mover!

## Esempi aggiuntivi di xskak

### Commenti testuali

La specifica PGN supporta l'inserimento di commenti usando parentesi graffe attorno al testo del commento: `{〈Text〉}`; tuttavia, il `xskak` pacchetto preferisce che i commenti testuali siano scritti come `\xskakcomment{〈Text〉}`, come dimostrato nel seguente esempio:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame %Avvia una nuova partita di scacchi
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6 \xskakcomment{ Questo è un commento. }}\vspace{3mm}

\chessboard
\end{document}
```

[Apri questo esempio in 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)

Questo esempio produce il seguente output:

![](/files/8259fec5e04eb62fa05abc31e9c39ef0554b571c)

### Inizializzazione di una scacchiera usando la notazione FEN

Puoi usare FEN per avviare la scacchiera in qualsiasi posizione. L'esempio seguente usa il `setfen` chiave in un `\chessboard` comando per mostrare un esempio FEN tratto dal `skak` documentazione del pacchetto:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\chessboard[setfen=r5k1/1b1p1ppp/p7/1p1Q4/2p1r3/PP4Pq/BBP2b1P/R4R1K w - - 0 20]
\end{document}
```

[Apri questo esempio in 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)

Questo esempio produce il seguente output:

![](/files/c52a53802b806c466fa3ef9cf4288d670e83ade2)

La notazione FEN riempie la scacchiera iniziando dalla traversa più alta (numero 8) e procede verso il basso per riempire le traverse successive. Per esempio, per inizializzare la scacchiera sopra la traversa 8 si usa **r5k1**:

* **r**torre
* **5** caselle vuote
* le **re**e
* **1** casella vuota

quindi usando la notazione **r5k1**. Nota l'uso delle lettere minuscole per descrivere i pezzi neri degli scacchi insieme all'uso delle maiuscole **P** per i pedoni bianchi e delle minuscole **p** per i pedoni neri.

### Uso di \lastmove

Il `\lastmove` il comando può essere usato per commentare l'ultima mossa effettuata:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4}

\chessboard

\lastmove{} è la mossa di apertura più comune.
\end{document}
```

[Apri questo esempio in 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)

Questo esempio produce il seguente output:

![](/files/12187d38ca9eef36a91e38adb3423f2855d2dae5)

### Varianti e un esempio della notazione ...

Quanto segue riproduce un esempio contenuto nella `skak` documentazione del pacchetto, aggiornato per usare `xskak` comandi. Qui vediamo un esempio del `\variation` comando e della sintassi con i tre puntini (...) [usata per indicare una mossa nera](#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}

Qui viene usata una variante \variation{3...Nf6} per mostrare un comando \texttt{\string\variation}.

\mainline{4.Ba4}

\chessboard
\end{document}
```

[Apri questo esempio in 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)

Questo esempio produce il seguente output:

![](/files/075484453c206ba4a122e6f3310c2beb78c13aaf)

### Mostrare solo alcuni pezzi degli scacchi

Poiché `xskak` carica il `chessboard` pacchetto puoi usare l'estremamente potente **`\chessboard[〈elenco chiave=valore〉]`** comando per mostrare o nascondere aree della scacchiera, o raccolte di pezzi degli scacchi, che sono di interesse. La [documentazione di chessboard](https://texdoc.org/serve/chessboard/0) contiene numerosi esempi, come quelli riprodotti qui sotto.

#### Uso delle chiavi per nascondere determinate caselle

Questo esempio usa le chiavi `hideall`, `showpieces` e `addpieces`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\chessboard[hideall,
showpieces={P,p},
addpieces=pe5]
\end{document}
```

[Apri questo esempio in 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)

Questo `xskak` esempio produce il seguente output:

![](/files/e05ba86c544cfa3a754cd289185d48c76d006cd0)

Questo esempio usa le chiavi `hidefiles`, `showfiles` e `showranks`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\def\myfiles{a,b}
\chessboard[hidefiles=\myfiles,
addpieces=Ra2,
showfiles=a,
showranks=2]
\end{document}
```

[Apri questo esempio in 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)

Questo `xskak` esempio produce il seguente output:

![](/files/d24e9a7021f48f1e0fd45f4a4a9ed1e1a57c9710)

#### Uso delle chiavi per nascondere tutti i pezzi bianchi o tutti i pezzi neri

L'esempio seguente mostra le chiavi `hidewhite` e `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}
```

[Apri questo esempio in 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)

Questo `xskak` esempio produce il seguente output:

![](/files/71faf40a6f307302300b37f034ac61f4799ffc31)

## Ulteriori esempi da tex.stackexchange

I seguenti esempi utilizzano soluzioni trovate su [tex.stackexchange.com](https://tex.stackexchange.com).

### Come evidenziare le caselle?

Fonte: basato su <https://tex.stackexchange.com/a/215334>

```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}
```

[Apri questo esempio in 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/6c3861357c09864b8686fa0b6786b9104c95c166)

### Creazione di diversi stili di scacchiera

Fonte: basato su <https://tex.stackexchange.com/a/358041>

```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}
```

[Apri questo esempio in 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)

Questo `xskak` esempio produce il seguente output:

![](/files/4f240a4b2c4d5a6daecdbc9aa13e7b410fbaa3ee)

## Approfondimenti

Per ulteriori informazioni vedi:

* [Creazione di un documento in LaTeX](/latex/it/concetti-di-base-di-latex/01-learn-latex-in-30-minutes.md)
* [Inserimento di immagini](/latex/it/altri-argomenti/27-inserting-images.md)
* [Posizionamento di immagini e tabelle](/latex/it/figure-e-tabelle/02-positioning-images-and-tables.md)
* [Supporto per le lingue internazionali](/latex/it/lingue/03-international-language-support.md)
* [Dimensioni, famiglie e stili dei caratteri](/latex/it/caratteri/01-font-sizes-families-and-styles.md)
* [Caratteri tipografici](/latex/it/caratteri/02-font-typefaces.md)
* [Gestione in un grande progetto](/latex/it/struttura-del-documento/07-management-in-a-large-project.md)
* [Il `skak` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/skak?lang=en)
* [Il `xskak` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/xskak?lang=en)
* [Notazione algebrica negli scacchi (su Wikipedia)](http://en.wikipedia.org/wiki/Algebraic_notation_\(chess\))
* [Notazione Forsyth-Edwards (FEN) (su Wikipedia)](http://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation)
* [Il `chessboard` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/chessboard?lang=en)
* [Testo dello standard 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://ayakaleaf-pro.ayaka.space/latex/it/specifico-per-argomento/05-chess-notation.md?ask=<question>&goal=<endgoal>
```

`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.
