> 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/fi/alakohtaiset/05-chess-notation.md). # Shakkimerkintä ## Johdanto Tämä artikkeli käsittelee shakin asettelun perusteita, mukaan lukien [lyhyitä katsauksia/tiivistelmiä joistakin shakkikäytännöistä](#chess-conventions-a-brief-review) joita saatat kohdata LaTeXin shakkipakettien dokumentaatiossa. Lukijat, jotka eivät tarvitse tätä johdantomateriaalia, voivat hypätä suoraan [LaTeX-pakettiesimerkkeihin](#a-first-example-with-the-xskak-package). ## Yksi paketti hallitsemaan niitä kaikkia CTAN-arkisto luettelee useita [shakkiin liittyviä paketteja](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), joten saatat miettiä, minkä niistä valitsisit? Tässä artikkelissa käytetään [`xskak` paketti](https://ctan.org/pkg/xskak?lang=en), jota suositellaan vahvasti shakin asetteluun sen laajan ominaisuusvalikoiman, laajojen määritysvalintojen ja erinomaisen dokumentaation vuoksi. `xskak` lataa ja laajentaa alkuperäistä [`skak` paketti](https://ctan.org/pkg/skak?lang=en) ja lataa myös [`chessboard` paketti](https://ctan.org/pkg/chessboard?lang=en) joka tarjoaa valtavan valikoiman vaihtoehtoja shakkilautojen määrittämiseen ja luomiseen. Tämän artikkelin tarjoamat esimerkit eivät voi korvata *erinomaista* paketteja täydentävää dokumentaatiota [`xskak`](https://texdoc.org/serve/xskak/0) ja [`chessboard`](https://texdoc.org/serve/chessboard/0) , joita kannustamme lämpimästi selaamaan, tarkastelemaan ja tutkimaan, koska molemmissa dokumentaatiosarjoissa on lukuisia ja erittäin hyödyllisiä esimerkkejä. **Huomaa**: Molemmat `skak` ja `xskak` pystyvät jäsentämään ja asettelemaan shakkipelejä (osan) [Portable Game Notation (PGN)](#portable-game-notation). `xskak` laajentaa PGN:n tukemaa osajoukkoa, jota `skak`. **Pieni trivia**: skak on tanskankielinen sana shakille. ### Muutamia huomioita Tässä on joitakin tärkeitä huomioita `xskak` dokumentaatiosta: > `xskak` lataa paketin `skak` ilman valintoja (eikä välitä sille valintoja). Joten jos haluat ladata `skak` valinnoilla, sinun täytyy tehdä se ennen paketin lataamista `xskak`. > `xskak` on laajennus (eikä korvike) alkuperäiselle **päätyön tekee edelleen paketti `skak`**... lue ensin paketin dokumentaatio `skak`... * **Huomaa**: Shakkiin liittyvien pakettien joukossa [CTANissa luetelluista](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) on yksi nimeltä [`skaknew`](https://ctan.org/pkg/skaknew). Nimestään huolimatta `skaknew` paketti on *sisällä* uusi tai parannettu versio alkuperäisestä `skak` paketista: se on joukko Type 1 -shakkifontteja. Paketti `xskak` käyttää `skaknew` fontteja, joten sinun ei tarvitse ladata niitä manuaalisesti projektiisi. ### Minimalistinen xskak-esimerkki Taustan luomiseksi, ja ilman lisäselityksiä, tässä on yksinkertainen `xskak` pakettiesimerkki, joka asettelee kaksi shakkilautaa: toinen on tyhjä, toisessa kaikki shakkinappulat ovat lähtöasemissaan: ```latex \documentclass{article} % Huom: sinun tarvitsee ladata vain xskak, % ei skak- tai chessboard-paketteja. \usepackage{xskak} \begin{document} % Tämä \chessboard-komento piirtää % tyhjän shakkilaudan: valinta % showmover=false käsitellään % myöhemmin artikkelissa \chessboard[showmover=false] % The \newchessgame-komento % alustaa uuden pelin: \newchessgame % Koska uusi peli alustettiin, % \chessboard piirtää nyt % laudan shakkinappuloineen: \chessboard Pientä valkoista neliötä toisen laudan oikealla puolella kutsutaan moveriksi. \end{document} ``` [Avaa tämä esimerkki Overleafissa](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) Tämä `xskak` esimerkki tuottaa seuraavan tulosteen: ![](/files/c5128695b3b49728a66bf336533ff11181ab2df4) ## Shakkikäytännöt: lyhyt katsaus Shakkiin, erityisesti sen asetteluun, vasta-alkajien eduksi seuraavat osiot tarjoavat *lyhyen* johdatuksen aiheisiin ja käytäntöihin, joita kohtaat LaTeXin shakkipaketeissa ja niiden mukana tulevassa dokumentaatiossa. Shakkikäytännöt tuntevat lukijat voivat ohittaa nämä osiot ja siirtyä suoraan LaTeX-esimerkkeihin. ### Portable Game Notation skak- ja xskak-paketit tukevat osajoukkoa [Portable Game Notation](https://en.wikipedia.org/wiki/Portable_Game_Notation) (PGN), standardia, jonka kehitti noin vuonna 1994 [Steven Edwards](https://www.chessprogramming.org/Steven_Edwards). Alkuperäinen PGN-määrittely vuodelta 1994 on [saatavilla archive.orgissa](https://archive.org/details/pgn-standard-1994-03-12). Suora linkki standardiin on . Mukaan [PGN-standardin teksti](https://tim-mann.org/Standard): > PGN on "Portable Game Notation", standardi, joka on suunniteltu shakkipelidatan esittämiseen ASCII-tekstitiedostoina. PGN on rakennettu niin, että ihmisten on helppo lukea ja kirjoittaa sitä ja tietokoneohjelmien on helppo jäsentää ja tuottaa sitä... PGN:ää ehdotetaan yleispäteväksi siirrettäväksi esitystavaksi tiedonvaihtoon. Huomaa, että PGN-tiedostot on suunniteltu *vaihtoon **peli-** datan*; eli PGN-tiedostojen on tarkoitus sisältää *koko pelin* tiedot—kuten pelaajien nimet, tapahtuman/päivämäärän yksityiskohdat jne.—sekä tallenne algebrallisessa notaatiossa *kaikista siirroista* pelissä. **Huomaa**: Jos haluat toisen lyhyen johdatuksen PGN:ään, käy osoitteessa ### Shakkilaudan rivit ja sarakkeet Shakkilauta on 8×8-ruudukko, joka voitaisiin normaalisti kuvata kahdeksaksi vaakasuuntaiseksi riviksi ja kahdeksaksi pystysuuntaiseksi sarakkeeksi; shakkilaudan kuvaamiseen käytetään kuitenkin toista terminologiaa: * on 8 vaakasuuntaista ***riviä*** (rivin sijaan) * on 8 pystysuuntaista ***tiedostoja*** (sarakkeen sijaan) Jokainen shakkilaudan ruutu voidaan tunnistaa (nimetä) käyttämällä [useita käytäntöjä](https://en.wikipedia.org/wiki/Chessboard#Board_notation) mutta [algebrallinen notaatio](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) (koordinaatistojärjestelmä) on hyväksytty kansainvälinen standardi. ### Algebrallinen notaatio Algebrallisen notaation järjestelmässä rivit ja sarakkeet merkitään seuraavasti: * 8 vaakasuuntaista ***riviä*** merkitään numeroilla `1` kohteeseen `8` * 8 pystysuuntaista ***tiedostoja*** merkitään kirjaimilla `a` kohteeseen `h`. Seuraava kuva näyttää shakkilaudan, jossa sarakkeiden ja rivien algebrallisen notaation merkinnät: ![](/files/9d8ac8deeacf5c87892392a3eaa9c430f1d03372) Jokainen shakkilaudan ruutu sijaitsee tietyn sarakkeen (column) ja rivin (row) leikkauskohdassa: vastaavia sarakkeen ja rivin arvoja voidaan käyttää koordinaatteina tunnistamaan jokainen ruutu yksikäsitteisesti shakkinappuloiden sijainnin ja liikkeen kuvaamiseen. Esimerkiksi seuraava kuva näyttää ruudun, joka sijaitsee kohdassa **e7** ja sitä seuraa toinen shakkilauta, jossa on lueteltu kaikkien 64 ruudun sijainnit: ![](/files/e2d2a49240ffe2593b740cc0f825575e6c07ec4f) Jos olet uusi shakin parissa, Wikipedian sivu [Algebrallinen notaatio](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) sisältää hyödyllistä taustatietoa, josta osan tiivistämme alla. ### Merkintätapa shakkinappuloille Jokainen shakkinappulatyyppi, yleensä sotilaita lukuun ottamatta, tunnistetaan isolla kirjaimella, joka voi vaihdella käytettävän kielen mukaan. Englanninkieliset pelaajat käyttävät seuraavia kirjaimia: | Kirjain | Nappulat | | ------- | ---------- | | K | Kuningas | | Q | Kuningatar | | R | Torni | | B | Lähetti | | N | Ratsu | Tavanomaisessa algebrallisessa notaatiossa sotilaita ei *yleensä* tunnisteta isolla kirjaimella; sen sijaan ne tunnistaa *puuttumisesta* ison kirjaimen puuttumisesta. Tätä käytäntöä ei kuitenkaan aina noudateta; sotilaiden tunnistamiseen voidaan käyttää isoa kirjainta P. [Forsyth-Edwards Notation (FEN)](#forsyth-edwards-notation-fen) isoja ja pieniä kirjaimia käytetään shakkinappuloiden esittämiseen. ### Yksittäisen siirron merkintätapa Tallentaaksesi shakkinappulan liikkeen sinun on tunnistettava nappula ja sen kohderuutu. Tämä onnistuu käyttämällä nappulan isoa kirjainta sekä kohderuudun koordinaatteja. **Huomaa**: kun kuvaillaan sotilaan siirtoa, nappulaa osoittavaa kirjainta ei *yleensä* käytetä; vain kohderuutu *yleensä* annetaan, kuten seuraavissa esimerkeissä: * *ei-sotilaan* siirrot: * **Be5**: **B**lähetti siirtyy ruutuun **e5** * **Nf3**: r**N**atsu siirtyy ruutuun **f3** * *sotilas* siirrot: * **c5**: sotilas siirtyy ruutuun **c5** * **Huomaa**: tietyissä olosuhteissa (esim. jotkin LaTeX-komennot) sotilaat *tunnistetaan* isolla kirjaimella **S**; joten **c5** voitaisiin kirjoittaa **Pc5**. #### Kolme pistettä (...) mustan siirron merkintä Osio 8.2.2.2 [Portable Game Notation -standardista](https://tim-mann.org/Standard) selittää kolmen pisteen (...) käytön siirtonumeron ilmaisimen jälkeen (esim. **3...e6**): > Valkoisen siirtonumeron merkintä muodostetaan kokonaisluvusta, joka antaa täyden siirron numeron, johon lisätään yksi piste. Mustan siirtonumeron merkintä muodostetaan kokonaisluvusta, joka antaa täyden siirron numeron, johon lisätään ***kolme pisteen merkkiä***. ### Käytäntö siirtosarjalle Kuten Wikipedian artikkelissa [Algebrallinen notaatio](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)#Formatting)mainitaan, siirtosarjan kuvaamiseen: * jokainen yksittäinen siirto *yleensä* käyttää isoa kirjainta ei-sotilaille, vaikka kuten edellä todettiin, joissakin olosuhteissa (käytännöissä) isoa P-kirjainta voidaan käyttää sotilaan siirron osoittamiseen. * shakkisiirtojen sarja on sekvenssi ` ` pareista—huomaa, että jokainen siirtopari numeroidaan (katso esimerkki alla) ### Muut shakkimerkinnät: FAN ja FEN #### Figurine Algebraic Notation (tai FAN) Kielikohtaiset kirjaimet, joita käytetään shakkinappuloiden esittämiseen, korvataan usein yleisesti tunnistettavilla symboleilla, jotka esittävät shakkinappuloita. Tätä symbolista esitystapaa kutsutaan Figurine Algebraic Notationiksi eli FAN:iksi. Esimerkiksi symbolia ♞ (tai ♘) voidaan käyttää N:n (ratsua varten) tilalla. Unicode-määritys koodaa shakkimerkit [Miscellaneous Symbols -joukkoon](https://www.unicode.org/charts/PDF/U2600.pdf). Seuraava taulukko luettelee kunkin shakkimerkin Unicode-arvon, nimen ja edustavan symbolin—varsinaiset glyphit (merkistömallit), joita käytetään shakkisymbolien näyttämiseen, riippuvat laitteesi/selaimesi fonttiasetuksista. | Edustava symboli\n(glyph) | Unicode-arvo\n(heksana) | Unicode-merkin nimi\n(virallinen) | | ------------------------- | ----------------------- | --------------------------------- | | ♔ | 2654 | VALKOINEN SHAKKIKUNINGAS | | ♕ | 2655 | VALKOINEN SHAKKIKUNINGATAR | | ♖ | 2656 | VALKOINEN SHAKKITORNI | | ♗ | 2657 | VALKOINEN SHAKKILÄHETTI | | ♘ | 2658 | VALKOINEN SHAKKIRATSU | | ♙ | 2659 | VALKOINEN SHAKKISOTILAS | | ♚ | 265A | MUSTA SHAKKIKUNINGAS | | ♛ | 265B | MUSTA SHAKKIKUNINGATAR | | ♜ | 265C | MUSTA SHAKKITORNI | | ♝ | 265D | MUSTA SHAKKILÄHETTI | | ♞ | 265E | MUSTA SHAKKIRATSU | | ♟ | 265F | MUSTA SHAKKISOTILAS | #### Forsyth-Edwards Notation (FEN) Kuten todettu, PGN:ää käytetään *kokonaisten pelien*, mukaan lukien kaikki pelissä tehdyt siirrot. Sitä vastoin [Forsyth-Edwards Notation (FEN)](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) tarjoaa tilannekuvan pelistä jollakin ajanhetkellä. FEN-merkintä käyttää isoja ja pieniä kirjaimia shakkinappuloiden esittämiseen: * valkoiset nappulat tunnistetaan isoilla kirjaimilla (PNBRQK) * mustat nappulat tunnistetaan pienillä kirjaimilla (pnbrqk) missä P tarkoittaa valkoista sotilasta ja p mustaa sotilasta. Yksityiskohtainen FEN-keskustelu ja sen vertailu PGN:ään on tämän artikkelin ulkopuolella. Lukijat, jotka haluavat ymmärtää paremmin PGN:n ja FEN:n erot, voivat katsoa seuraavan videon: {% embed url="" %} ## Ensimmäinen esimerkki xskak-paketilla ### Siirtojen tekeminen Jos haluat asettaa shakkisiirrot pelin edetessä, käytä komentoa `\mainline{*siirtolista*}` jossa `*siirtolista*` esitetään [shakin algebrallisella notaatiolla](#algebraic-notation). Näytämme seuraavan siirtosarjan asettelun: 1. **e4 e5**: valkoinen sotilas siirtyy ruutuun **e4**, musta sotilas siirtyy ruutuun **e5** 2. **Nf3 Nc6**: valkoinen r**N**atsu siirtyy ruutuun **f3**, musta r**N**atsu siirtyy ruutuun **c6** 3. **Bb5 a6**: valkoinen **B**lähetti siirtyy ruutuun **b5**, musta sotilas siirtyy ruutuun **a6** Tämä siirtosarja voidaan kirjoittaa käyttämällä [`xskak` paketti](https://ctan.org/pkg/xskak?lang=en) komento `\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}`—huomaa, että jokainen siirtopari numeroidaan (esim. `**1.**e4 e5`): ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6} \showboard % skak-paketin komento. Tulevissa esimerkeissä käytetään \chessboard[...] \end{document} ``` [Avaa tämä esimerkki Overleafissa](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) Tämä `xskak` esimerkki tuottaa seuraavan tulosteen: ![](/files/dcaa72059b481a3c77707221ff4708de67a4b551) Käytetään seuraavia komentoja: * **`\newchessgame[〈key=value list〉]`**: aloittaa uuden pelin ja alustaa shakkilaudan. `[〈key=value list〉]` on valinnainen, joten voit myös kirjoittaa `\newchessgame` ja luottaa laudan oletusasetuksiin. Valinnaiset avaimet on lueteltu [`xskak` dokumentaatiota](https://texdoc.org/serve/xskak/0). * **`\mainline{〈list of chess moves〉}`**: käsittelee `〈shakkisiirtojen lista〉` ja päivittää laudan niin että `\showboard` (tai `\chessboard`) asettelee laudan nykyisen tilan. * **`\showboard`**: asettelee shakkilaudan. Komento `\showboard` on peräisin taustalla olevasta `skak` paketista, jota `xskak` laajentaa. Paketti [`chessboard` paketti](https://ctan.org/pkg/chessboard?lang=en), jonka lataa `xskak`, tarjoaa erittäin monipuolisen **`\chessboard[〈key=value list〉]`** komennon, johon `xskak` paketti lisää lisäavaimia. Koska `\chessboard[...]` on tarkoitettu korvaamaan `\showboard`, tämän artikkelin tulevissa esimerkeissä käytetään vain `\chessboard[...]` komento. ### \chessboard-komennon esittely Komento **`\chessboard[〈key=value list〉]`**: asettelee shakkilautoja käyttäen valinnaista `〈key=value list〉`. Käytettävissä olevien `avainten` luettelo on *laajalti*, ja tarjoaa paljon hallintaa shakkilautojen koon, sisällön, asettelun, suunnittelun, merkintöjen jne. suhteen. Lukijoita kannustetaan lukemaan erinomainen dokumentaatio [`chessboard` (PDF)](https://texdoc.org/serve/chessboard/0) ja [`xskak` (PDF)](https://texdoc.org/serve/xskak/0), joista molemmat sisältävät lukuisia hyödyllisiä esimerkkejä—*monien* enemmän kuin voimme tässä artikkelissa esittää. Koska avaimet ovat valinnaisia, voit kirjoittaa `\chessboard` joka käyttää paketin oletusarvoja shakkilaudan asetteluun; esimerkiksi seuraava koodi asettelee kaksi lautaa käyttäen `\chessboard` ilman mitään valintoja. Lisämerkinnät, jotka on lisätty käsin Inkscapessa, näyttävät *moverit* (tässä ruutuina), jotka asetellaan oletuksena: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5} \chessboard % \showboardin sijaan \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6} \chessboard % \showboardin sijaan \end{document} ``` [Avaa tämä esimerkki Overleafissa.](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) Seuraava kuva näyttää yllä olevan koodin tuottamat kaksi shakkilautaa, jotka molemmat aseteltiin käyttäen `\chessboard`: ![](/files/caaf99736c20f157f623f964191fef2191b4adde) Ei yllättävää, moverin hallintaan on tarjolla useita avaimia, mukaan lukien sen näyttäminen tai piilottaminen; esimerkiksi moverin piilottamiseen voit käyttää `showmover` avainta arvolla `epätosi`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}\par \chessboard[showmover=false] % Piilota mover \end{document} ``` [Avaa tämä esimerkki Overleafissa.](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) Tämä esimerkki tuottaa seuraavan tulosteen—shakkilaudan ilman moveria: ![](/files/ad15d69ea23341b169835220c7b4b63e042e9e17) Se [`chessboard` paketin dokumentaatio (PDF)](https://texdoc.org/serve/chessboard/0) tarjoaa luettelon avaimista moverin mukauttamiseen sekä huomautuksen siitä, miten voit suunnitella oman moverisi! ## Lisää xskak-esimerkkejä ### Tekstikommentit PGN-määritys tukee kommenttien tekemistä käyttämällä aaltosulkeita kommentin tekstin ympärillä: `{〈Text〉}`; kuitenkin `xskak` paketti suosii tekstikommenttien kirjoittamista muodossa `\xskakcomment{〈Text〉}`, kuten seuraavassa esimerkissä on havainnollistettu: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame %Aloita uusi shakkipeli \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6 \xskakcomment{ Tämä on kommentti. }}\vspace{3mm} \chessboard \end{document} ``` [Avaa tämä esimerkki Overleafissa.](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) Tämä esimerkki tuottaa seuraavan tulosteen: ![](/files/1111a2a619591375becd3257698d2d95985478c8) ### Laudan alustaminen FEN-merkinnällä Voit käyttää FEN:iä laudan aloittamiseen missä tahansa asemassa. Seuraava esimerkki käyttää `setfen` avain a:ssa `\chessboard` komento, jolla demonstroidaan FEN-esimerkki, joka on otettu `skak` paketin dokumentaatiossa: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \chessboard[setfen=r5k1/1b1p1ppp/p7/1p1Q4/2p1r3/PP4Pq/BBP2b1P/R4R1K w - - 0 20] \end{document} ``` [Avaa tämä esimerkki Overleafissa.](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) Tämä esimerkki tuottaa seuraavan tulosteen: ![](/files/756709e961a0266dd1b7f37ad1296d235e137142) FEN-merkintä täyttää laudan alkaen ylimmästä rivistä (numero 8) ja etenee alaspäin täyttämään seuraavat rivit. Esimerkiksi yllä olevan laudan alustaminen riviltä 8 kuvataan käyttämällä **r5k1**: * **r**torni * **5** tyhjät ruudut * sivustolta **k**ing * **1** tyhjä ruutu siksi käyttäen merkintää **r5k1**. Huomaa pienaakkosten käyttö mustien shakkinappuloiden kuvaamiseen sekä isojen **S** kirjainten käyttö valkoisille sotilaille ja pienaakkosten **p** kirjainten käyttö mustille sotilaille. ### Käyttäen \lastmove Se `\lastmove` komentoa voidaan käyttää viimeisimmän tehdyn siirron kommentoimiseen: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4} \chessboard \lastmove{} on yleisin aloitussiirto. \end{document} ``` [Avaa tämä esimerkki Overleafissa.](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) Tämä esimerkki tuottaa seuraavan tulosteen: ![](/files/2dc67a23ae9fc4a75e84ebfd240e8280e61a24b7) ### Muunnelmat ja esimerkki ...-merkinnästä Seuraava toistaa esimerkin, joka sisältyy `skak` paketin dokumentaatioon, päivitettynä käyttämään `xskak` komentoja. Tässä näemme esimerkin `\variation` komennosta ja kolmen pisteen (...) syntaksista [jota käytetään osoittamaan mustan siirtoa](#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} Tässä käytetään muunnelmaa \variation{3...Nf6} näyttämään \texttt{\string\variation}-komentoa. \mainline{4.Ba4} \chessboard \end{document} ``` [Avaa tämä esimerkki Overleafissa.](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) Tämä esimerkki tuottaa seuraavan tulosteen: ![](/files/b6af15c0286400672425fc5a1f379a1f631e8d4c) ### Vain tiettyjen shakkinappuloiden näyttäminen Koska `xskak` lataa `chessboard` paketissa voit käyttää erittäin tehokasta **`\chessboard[〈key=value list〉]`** komentoa näyttämään tai piilottamaan kiinnostavia laudan alueita tai shakkinappularyhmiä. [chessboard-dokumentaatio](https://texdoc.org/serve/chessboard/0) sisältää lukuisia esimerkkejä, kuten alla olevat. #### Avainten käyttäminen tiettyjen kenttien piilottamiseen Tämä esimerkki käyttää avaimia `hideall`, `showpieces` ja `addpieces`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \chessboard[hideall, showpieces={P,p}, addpieces=pe5] \end{document} ``` [Avaa tämä esimerkki Overleafissa](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) Tämä `xskak` esimerkki tuottaa seuraavan tulosteen: ![](/files/792f69da3de3d9291c52f925efa318f09ae59eb6) Tämä esimerkki käyttää avaimia `hidefiles`, `showfiles` ja `showranks`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \def\myfiles{a,b} \chessboard[hidefiles=\myfiles, addpieces=Ra2, showfiles=a, showranks=2] \end{document} ``` [Avaa tämä esimerkki Overleafissa](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) Tämä `xskak` esimerkki tuottaa seuraavan tulosteen: ![](/files/4ea855ae508fbea768f8ed24214217bf44ecb462) #### Avainten käyttäminen kaikkien valkoisten tai kaikkien mustien nappuloiden piilottamiseen Seuraava esimerkki havainnollistaa avaimia `hidewhite` ja `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} ``` [Avaa tämä esimerkki Overleafissa](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) Tämä `xskak` esimerkki tuottaa seuraavan tulosteen: ![](/files/448a36ece1d51f6d2f9d61595b523c046f1340c8) ## Lisää esimerkkejä tex.stackexchange-sivustolta Seuraavat esimerkit käyttävät ratkaisuja, jotka löytyvät [tex.stackexchange.com](https://tex.stackexchange.com). ### Miten ruutuja korostetaan? Lähde: perustuu ```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} ``` [Avaa tämä esimerkki Overleafissa.](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/06a8fd0ee80ebe877b50653d0e09c7ed2bb70ead) ### Erilaisten laudan tyylien luominen Lähde: perustuu ```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} ``` [Avaa tämä esimerkki Overleafissa.](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) Tämä `xskak` esimerkki tuottaa seuraavan tulosteen: ![](/files/0d3a8fbd010347d2698b479c6f3e6a4e320339a5) ## Lisälukemista Lisätietoja löydät: * [Asiakirjan luominen LaTeXissa](/latex/fi/latexin-perusteet/01-learn-latex-in-30-minutes.md) * [Kuvien lisääminen](/latex/fi/lisaa-aiheita/27-inserting-images.md) * [Kuvien ja taulukoiden sijoittelu](/latex/fi/kuvat-ja-taulukot/02-positioning-images-and-tables.md) * [Kansainvälinen kielituki](/latex/fi/kielet/03-international-language-support.md) * [Kirjasinkoot, -perheet ja -tyylit](/latex/fi/fontit/01-font-sizes-families-and-styles.md) * [Kirjasinlajit](/latex/fi/fontit/02-font-typefaces.md) * [Hallinta suuressa projektissa](/latex/fi/asiakirjan-rakenne/07-management-in-a-large-project.md) * [Se `skak` paketti](https://ctan.org/pkg/skak?lang=en) * [Se `xskak` paketti](https://ctan.org/pkg/xskak?lang=en) * [Algebrallinen merkintä shakissa (Wikipediassa)](http://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) * [Forsyth-Edwardsin merkintä (FEN) (Wikipediassa)](http://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) * [Se `chessboard` paketti](https://ctan.org/pkg/chessboard?lang=en) * [PGN-standardin teksti](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/fi/alakohtaiset/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.