> 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/el/eidiko-pedio/05-chess-notation.md). # Σημειογραφία σκακιού ## Εισαγωγή Αυτό το άρθρο εξερευνά τα βασικά της στοιχειοθεσίας σκακιού, συμπεριλαμβανομένων [σύντομων ανασκοπήσεων/περιλήψεων ορισμένων σκακιστικών συμβάσεων](#chess-conventions-a-brief-review) που μπορεί να συναντήσετε στην τεκμηρίωση των πακέτων σκακιού της LaTeX. Οι αναγνώστες που δεν χρειάζονται αυτό το εισαγωγικό υλικό μπορούν να περάσουν κατευθείαν στα [παραδείγματα του πακέτου LaTeX](#a-first-example-with-the-xskak-package). ## Ένα πακέτο για να τα κυβερνά όλα Το αποθετήριο 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), οπότε ίσως αναρωτιέστε ποιο να επιλέξετε; Το παρόν άρθρο χρησιμοποιεί το [`xskak` πακέτο](https://ctan.org/pkg/xskak?lang=en), το οποίο συνιστάται ιδιαίτερα για στοιχειοθεσία σκακιού λόγω του ευρέος φάσματος δυνατοτήτων του, των εκτεταμένων επιλογών ρύθμισης και της εξαιρετικής τεκμηρίωσής του. `xskak` φορτώνει και επεκτείνει το αρχικό [`skak` πακέτο](https://ctan.org/pkg/skak?lang=en) και επίσης φορτώνει το [`chessboard` πακέτο](https://ctan.org/pkg/chessboard?lang=en) το οποίο παρέχει ένα τεράστιο εύρος επιλογών για τη ρύθμιση και τη δημιουργία σκακιερών. Τα παραδείγματα που παρέχονται από αυτό το άρθρο δεν μπορούν να υποκαταστήσουν τη *εξαιρετική* τεκμηρίωση που συνοδεύει τα [`xskak`](https://texdoc.org/serve/xskak/0) και [`chessboard`](https://texdoc.org/serve/chessboard/0) πακέτα, την οποία σας ενθαρρύνουμε θερμά να περιηγηθείτε, να εξετάσετε και να διερευνήσετε, επειδή και τα δύο σύνολα τεκμηρίωσης περιέχουν πολυάριθμα και πολύ χρήσιμα παραδείγματα. **Σημείωση**: Και τα δύο `skak` και `xskak` μπορούν να αναλύουν και να στοιχειοθετούν παρτίδες σκακιού σε (υποσύνολο της) [Φορητή Σημειογραφία Παρτίδας (PGN)](#portable-game-notation). `xskak` επεκτείνει το υποσύνολο της PGN που υποστηρίζεται από το `skak`. **Πληροφοριακά**: Το skak είναι η δανέζικη λέξη για το σκάκι. ### Ορισμένες σημειώσεις Ακολουθούν ορισμένα σημαντικά σημεία που σημειώνονται στην `xskak` τεκμηρίωση: > `xskak` θα φορτώσει το πακέτο `skak` χωρίς επιλογή (και δεν θα του περάσει επιλογές). Άρα, αν θέλετε να φορτώσετε το `skak` με επιλογές, πρέπει να το κάνετε πριν φορτώσετε το πακέτο `xskak`. > `xskak` είναι μια επέκταση (και όχι αντικατάσταση) του **η κύρια δουλειά εξακολουθεί να γίνεται από το πακέτο `skak`**... διαβάστε πρώτα την τεκμηρίωση του πακέτου `skak`... * **Σημείωση**: Μεταξύ των πακέτων σχετικά με το σκάκι [που παρατίθενται στο 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) υπάρχει ένα που ονομάζεται [`skaknew`](https://ctan.org/pkg/skaknew). Παρά το όνομά του, το `skaknew` πακέτο είναι *όχι* μια νέα ή βελτιωμένη έκδοση του αρχικού `skak` πακέτου: είναι ένα σύνολο σκακιστικών γραμματοσειρών Type 1. Το `xskak` πακέτο χρησιμοποιεί τις `skaknew` γραμματοσειρές, οπότε δεν χρειάζεται να τις φορτώσετε χειροκίνητα στο έργο σας. ### Ελάχιστο παράδειγμα xskak Για να «στήσουμε το σκηνικό» και χωρίς περαιτέρω εξήγηση, εδώ είναι ένα ελάχιστο `xskak` παράδειγμα πακέτου που στοιχειοθετεί δύο σκακιέρες: η μία είναι άδεια, η άλλη έχει όλα τα πιονιά στις αρχικές τους θέσεις: ```latex \documentclass{article} % Σημείωση: χρειάζεται να φορτώσετε μόνο το xskak, % όχι τα πακέτα skak ή chessboard. \usepackage{xskak} \begin{document} % Αυτή η εντολή \chessboard σχεδιάζει % μια άδεια σκακιέρα: η επιλογή % showmover=false θα συζητηθεί % αργότερα στο άρθρο \chessboard[showmover=false] % Η εντολή \newchessgame % αρχικοποιεί μια νέα παρτίδα: \newchessgame % Επειδή αρχικοποιήθηκε μια νέα παρτίδα, % το \chessboard τώρα σχεδιάζει μια % σκακιέρα με πιονιά: \chessboard Το μικρό λευκό τετράγωνο στα δεξιά της δεύτερης σκακιέρας ονομάζεται το \textit{mover}. \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το `xskak` το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/4689e30cc29e238cd03a35b1aadf42f921e6fb49) ## Σκακιστικές συμβάσεις: μια σύντομη ανασκόπηση Προς όφελος των αναγνωστών που είναι νέοι στο σκάκι, ιδίως στη στοιχειοθεσία του, οι ακόλουθες ενότητες παρέχουν *σύντομες* εισαγωγές σε θέματα και συμβάσεις που θα συναντήσετε στα πακέτα σκακιού της LaTeX και στην αντίστοιχη τεκμηρίωσή τους. Οι αναγνώστες που είναι εξοικειωμένοι με τις σκακιστικές συμβάσεις μπορούν να παραλείψουν αυτές τις ενότητες και να περάσουν στα παραδείγματα LaTeX. ### Φορητή Σημειογραφία Παρτίδας Τα πακέτα skak και xskak υποστηρίζουν ένα υποσύνολο της [Φορητή Σημειογραφία Παρτίδας](https://en.wikipedia.org/wiki/Portable_Game_Notation) (PGN), ενός προτύπου που επινοήθηκε περίπου το 1994 από τον [Steven Edwards](https://www.chessprogramming.org/Steven_Edwards). Η αρχική προδιαγραφή PGN, με ημερομηνία 1994, είναι [διαθέσιμη στο archive.org](https://archive.org/details/pgn-standard-1994-03-12). Ένας άμεσος σύνδεσμος προς το πρότυπο είναι . Σύμφωνα με [το κείμενο του προτύπου PGN](https://tim-mann.org/Standard): > Η PGN είναι «Portable Game Notation», ένα πρότυπο σχεδιασμένο για την αναπαράσταση δεδομένων σκακιστικών παρτίδων με χρήση αρχείων κειμένου ASCII. Η PGN είναι δομημένη για εύκολη ανάγνωση και γραφή από ανθρώπινους χρήστες και για εύκολη ανάλυση και παραγωγή από προγράμματα υπολογιστή... Η PGN προτείνεται ως μια καθολική φορητή αναπαράσταση για ανταλλαγή δεδομένων. Σημειώστε ότι τα αρχεία PGN έχουν σχεδιαστεί για την *ανταλλαγή **παρτίδας** δεδομένων*· δηλαδή, τα αρχεία PGN έχουν σχεδιαστεί να περιέχουν *πλήρη* πληροφορίες—όπως τα ονόματα των παικτών, λεπτομέρειες του γεγονότος/ημερομηνίας κ.λπ., μαζί με μια καταγραφή, σε αλγεβρική σημειογραφία, όλων των *κινήσεων* στην παρτίδα. **Σημείωση**: Για μια ακόμη σύντομη εισαγωγή στην PGN επισκεφθείτε ### Γραμμές και στήλες σκακιέρας Μια σκακιέρα είναι ένα πλέγμα 8×8 τετραγώνων που συνήθως θα μπορούσε να περιγραφεί ως 8 οριζόντιες σειρές και 8 κάθετες στήλες· ωστόσο, χρησιμοποιείται διαφορετική ορολογία για την περιγραφή μιας σκακιέρας: * υπάρχουν 8 οριζόντιες ***γραμμές*** (αντί για σειρές) * υπάρχουν 8 κάθετες ***αρχεία*** (αντί για στήλες) Κάθε τετράγωνο στη σκακιέρα μπορεί να αναγνωριστεί (να ονομαστεί) χρησιμοποιώντας [πολλές συμβάσεις](https://en.wikipedia.org/wiki/Chessboard#Board_notation) αλλά το [αλγεβρική σημειογραφία](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) (σύστημα συντεταγμένων) είναι το αποδεκτό διεθνές πρότυπο. ### Αλγεβρική σημειογραφία Στο σύστημα αλγεβρικής σημειογραφίας οι γραμμές και οι στήλες επισημαίνονται ως εξής: * οι 8 οριζόντιες ***γραμμές*** επισημαίνονται με τους αριθμούς `1` σε `8` * οι 8 κάθετες ***αρχεία*** επισημαίνονται με τα γράμματα `a` σε `h`. Το επόμενο διάγραμμα δείχνει μια σκακιέρα με τις ετικέτες αλγεβρικής σημειογραφίας που χρησιμοποιούνται για τις στήλες και τις γραμμές: ![](/files/4a217e7fd17394386b1fda6168e7779aafead6d7) Κάθε τετράγωνο στη σκακιέρα βρίσκεται στη διασταύρωση μιας συγκεκριμένης στήλης και γραμμής: η αντίστοιχη τιμή στήλης και γραμμής μπορεί να χρησιμοποιηθεί ως συντεταγμένες για τη μοναδική ταυτοποίηση κάθε τετραγώνου, ώστε να περιγράφεται η θέση και η κίνηση των σκακιστικών κομματιών. Για παράδειγμα, το ακόλουθο διάγραμμα δείχνει το τετράγωνο που βρίσκεται στο **e7** ακολουθούμενο από μια δεύτερη σκακιέρα που απαριθμεί τη θέση και των 64 τετραγώνων: ![](/files/355521f6a52e67dd391bb48ab043d455cdc9c79b) Αν είστε νέοι στο σκάκι, η σελίδα της Wikipedia [Αλγεβρική σημειογραφία](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) περιέχει μερικές χρήσιμες πληροφορίες υποβάθρου, ορισμένες από τις οποίες συνοψίζουμε παρακάτω. ### Σημειογραφία για τα σκακιστικά κομμάτια Κάθε τύπος σκακιστικού κομματιού, συνήθως εκτός από τα πιόνια, αναγνωρίζεται από ένα κεφαλαίο γράμμα που μπορεί να διαφέρει ανάλογα με τη γλώσσα που χρησιμοποιείται. Οι αγγλόφωνοι παίκτες χρησιμοποιούν τα ακόλουθα γράμματα: | Γράμμα | Κομμάτια | | ------ | ----------- | | K | Βασιλιάς | | Q | Βασίλισσα | | R | Πύργος | | B | Αξιωματικός | | N | Ίππος | Στην τυπική αλγεβρική σημειογραφία τα πιόνια δεν *συνήθως* αναγνωρίζονται από κεφαλαίο γράμμα· αντίθετα, αναγνωρίζονται από την *απουσία* ενός κεφαλαίου γράμματος. Ωστόσο, αυτή η σύμβαση δεν υιοθετείται πάντα· το κεφαλαίο γράμμα P μπορεί να χρησιμοποιηθεί για την αναγνώριση των πιονιών. Στη [Σημειογραφία Forsyth-Edwards (FEN)](#forsyth-edwards-notation-fen) χρησιμοποιούνται κεφαλαία και πεζά γράμματα για την αναπαράσταση των σκακιστικών κομματιών. ### Σημειογραφία για μια μεμονωμένη κίνηση Για να καταγράψετε την κίνηση ενός σκακιστικού κομματιού, πρέπει να προσδιορίσετε το κομμάτι και το τετράγωνο προορισμού του. Αυτό μπορεί να επιτευχθεί χρησιμοποιώντας το κεφαλαίο γράμμα του κομματιού μαζί με τις συντεταγμένες του τετραγώνου προορισμού. **Σημείωση**: όταν περιγράφεται μια κίνηση πιονιού, ένα γράμμα που να υποδεικνύει ότι το κομμάτι είναι πιόνι δεν *συνήθως* χρησιμοποιείται· δίνεται μόνο το τετράγωνο προορισμού *συνήθως* όπως φαίνεται στα ακόλουθα παραδείγματα: * *μη πιονιού* κινήσεις: * **Be5**: **B**αξιωματικός κινείται στο τετράγωνο **e5** * **Nf3**: λευκ**N**ίππος κινείται στο τετράγωνο **f3** * *πιόνι* κινήσεις: * **c5**: ένα πιόνι κινείται στο τετράγωνο **c5** * **Σημείωση**: σε ορισμένες περιπτώσεις (π.χ. σε ορισμένες εντολές LaTeX) τα πιόνια *αναγνωρίζονται* με κεφαλαίο γράμμα **Π**· έτσι **c5** μπορεί να γραφτεί **Pc5**. #### Τρεις τελείες (...) ένδειξη κίνησης μαύρου κομματιού Η ενότητα 8.2.2.2 του [προτύπου Portable Game Notation](https://tim-mann.org/Standard) εξηγεί τη χρήση των τριών τελειών (...) μετά από έναν δείκτη αριθμού κίνησης (π.χ., **3...e6**): > Μια ένδειξη αριθμού κίνησης για τα λευκά σχηματίζεται από τον ακέραιο που δίνει τον αριθμό πλήρους κίνησης, με την προσθήκη ενός μόνο χαρακτήρα τελείας. Μια ένδειξη αριθμού κίνησης για τα μαύρα σχηματίζεται από τον ακέραιο που δίνει τον αριθμό πλήρους κίνησης με ***τρεις χαρακτήρες τελείας στο τέλος***. ### Σύμβαση για μια σειρά κινήσεων Όπως εξηγείται στο λήμμα της Wikipedia για την [Αλγεβρική σημειογραφία](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)#Formatting)για να περιγραφεί μια σειρά κινήσεων: * κάθε μεμονωμένη κίνηση *συνήθως* χρησιμοποιεί κεφαλαία γράμματα για τα κομμάτια που δεν είναι πιόνια, αν και, όπως σημειώθηκε παραπάνω, σε ορισμένες περιπτώσεις (συμβάσεις) μπορεί να χρησιμοποιείται κεφαλαίο P για να δηλώνει κίνηση πιονιού. * μια σειρά σκακιστικών κινήσεων είναι μια ακολουθία από `<κίνηση λευκού κομματιού> <κίνηση μαύρου κομματιού>` ζεύγη—σημειώστε ότι κάθε ζεύγος κινήσεων αριθμείται (βλ. παράδειγμα παρακάτω) ### Άλλες σκακιστικές σημειογραφίες: FAN και FEN #### Εικονιδιακή Αλγεβρική Σημειογραφία (ή FAN) Τα γράμματα που εξαρτώνται από τη γλώσσα και χρησιμοποιούνται για την αναπαράσταση των σκακιστικών κομματιών συχνά αντικαθίστανται από ευρέως αναγνωρισμένα σύμβολα που αναπαριστούν σκακιστικά κομμάτια. Αυτή η συμβολική αναπαράσταση είναι γνωστή ως Εικονιδιακή Αλγεβρική Σημειογραφία, ή FAN. Για παράδειγμα, το σύμβολο ♞ (ή ♘) μπορεί να χρησιμοποιηθεί αντί του N (για ίππο). Η προδιαγραφή Unicode κωδικοποιεί τους σκακιστικούς χαρακτήρες μέσα στο [Miscellaneous Symbols](https://www.unicode.org/charts/PDF/U2600.pdf). Ο ακόλουθος πίνακας παραθέτει την τιμή Unicode, το όνομα και το αντιπροσωπευτικό σύμβολο για κάθε σκακιστικό χαρακτήρα—τα πραγματικά γλυφά (σχεδιασμοί χαρακτήρων) που χρησιμοποιούνται για την εμφάνιση των σκακιστικών συμβόλων θα εξαρτηθούν από τις ρυθμίσεις γραμματοσειρών της συσκευής/του προγράμματος περιήγησής σας. |

Αντιπροσωπευτικό σύμβολο
(γλυφός)

|

Τιμή Unicode
(σε HEX)

|

Όνομα χαρακτήρα Unicode
(επίσημο)

| | ------------------------------------------- | ------------------------------- | ------------------------------------------- | | ♔ | 2654 | ΛΕΥΚΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΒΑΣΙΛΙΑΣ | | ♕ | 2655 | ΛΕΥΚΗ ΣΚΑΚΙΣΤΙΚΗ ΒΑΣΙΛΙΣΣΑ | | ♖ | 2656 | ΛΕΥΚΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΠΥΡΓΟΣ | | ♗ | 2657 | ΛΕΥΚΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΑΞΙΩΜΑΤΙΚΟΣ | | ♘ | 2658 | ΛΕΥΚΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΙΠΠΟΣ | | ♙ | 2659 | ΛΕΥΚΟ ΣΚΑΚΙΣΤΙΚΟ ΠΙΟΝΙ | | ♚ | 265A | ΜΑΥΡΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΒΑΣΙΛΙΑΣ | | ♛ | 265B | ΜΑΥΡΗ ΣΚΑΚΙΣΤΙΚΗ ΒΑΣΙΛΙΣΣΑ | | ♜ | 265C | ΜΑΥΡΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΠΥΡΓΟΣ | | ♝ | 265D | ΜΑΥΡΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΑΞΙΩΜΑΤΙΚΟΣ | | ♞ | 265E | ΜΑΥΡΟΣ ΣΚΑΚΙΣΤΙΚΟΣ ΙΠΠΟΣ | | ♟ | 265F | ΜΑΥΡΟ ΣΚΑΚΙΣΤΙΚΟ ΠΙΟΝΙ | #### Σημειογραφία Forsyth-Edwards (FEN) Όπως σημειώθηκε, η PGN χρησιμοποιείται για την αποθήκευση και την ανταλλαγή *ολόκληρων παρτίδων*, συμπεριλαμβανομένων όλων των κινήσεων που παίχτηκαν σε εκείνη την παρτίδα. Αντίθετα, το [Σημειογραφία Forsyth-Edwards (FEN)](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) παρέχει ένα στιγμιότυπο μιας παρτίδας σε κάποια χρονική στιγμή. Η σημειογραφία FEN χρησιμοποιεί κεφαλαία και πεζά γράμματα για την αναπαράσταση των σκακιστικών κομματιών: * τα λευκά κομμάτια αναγνωρίζονται από κεφαλαία γράμματα (PNBRQK) * τα μαύρα κομμάτια αναγνωρίζονται από πεζά γράμματα (pnbrqk) όπου το P αντιστοιχεί σε λευκό πιόνι και το p σε μαύρο πιόνι. Μια λεπτομερής συζήτηση της FEN και της σύγκρισής της με την PGN είναι εκτός του πεδίου αυτού του άρθρου. Οι αναγνώστες που θέλουν να κατανοήσουν καλύτερα τις διαφορές μεταξύ PGN και FEN ίσως θελήσουν να δουν το ακόλουθο βίντεο: {% embed url="" %} ## Ένα πρώτο παράδειγμα με το πακέτο xskak ### Καταγράφοντας τις κινήσεις σας Για να στοιχειοθετήσετε τις σκακιστικές κινήσεις καθώς εξελίσσεται η παρτίδα χρησιμοποιείτε την εντολή `\mainline{*λίστα κινήσεων*}` όπου `*λίστα κινήσεων*` εκφράζεται σε [αλγεβρική σκακιστική σημειογραφία](#algebraic-notation). Θα δείξουμε τη στοιχειοθέτηση της ακόλουθης ακολουθίας κινήσεων: 1. **e4 e5**: το λευκό πιόνι κινείται στο **e4**, το μαύρο πιόνι κινείται στο **e5** 2. **Nf3 Nc6**: λευκ**N**ίππος κινείται στο **f3**, μαύρ**N**ίππος κινείται στο **c6** 3. **Bb5 a6**: λευκός **B**αξιωματικός κινείται στο **b5**, το μαύρο πιόνι κινείται στο **a6** Αυτή η ακολουθία κινήσεων μπορεί να γραφτεί χρησιμοποιώντας το [`xskak` πακέτο](https://ctan.org/pkg/xskak?lang=en) εντολή `\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}`—σημειώστε ότι κάθε ζεύγος κινήσεων αριθμείται (π.χ., `**1.**e4 e5`): ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6} \showboard % Εντολή του πακέτου skak. Τα μελλοντικά παραδείγματα θα χρησιμοποιούν \chessboard[...] \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το `xskak` το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/6a112785357c9079dfd0ca98f63a7f4148cb863c) Χρησιμοποιούνται οι ακόλουθες εντολές: * **`\newchessgame[〈key=value list〉]`**: ξεκινά μια νέα παρτίδα και αρχικοποιεί τη σκακιέρα. Το `[〈key=value list〉]` είναι προαιρετικό, οπότε μπορείτε επίσης να γράψετε `\newchessgame` και να βασιστείτε στην προεπιλεγμένη αρχική διάταξη της σκακιέρας. Το σύνολο των προαιρετικών κλειδιών παρατίθεται στο [`xskak` τεκμηρίωση](https://texdoc.org/serve/xskak/0). * **`\mainline{〈list of chess moves〉}`**: επεξεργάζεται τη `〈list of chess moves〉` και ενημερώνει τη σκακιέρα έτσι ώστε `\showboard` (ή `\chessboard`) στοιχειοθετεί την τρέχουσα κατάσταση της σκακιέρας. * **`\showboard`**: στοιχειοθετεί τη σκακιέρα. Η `\showboard` εντολή προέρχεται από το υποκείμενο `skak` πακέτο, το οποίο `xskak` επεκτείνει. Το [`chessboard` πακέτο](https://ctan.org/pkg/chessboard?lang=en), το οποίο φορτώνεται από `xskak`, παρέχει την εξαιρετικά ευέλικτη **`\chessboard[〈key=value list〉]`** εντολή στην οποία το `xskak` πακέτο προσθέτει επιπλέον κλειδιά. Επειδή `\chessboard[...]` προορίζεται να αντικαταστήσει το `\showboard`, τα μελλοντικά παραδείγματα σε αυτό το άρθρο θα χρησιμοποιούν μόνο την `\chessboard[...]` εντολή. ### Παρουσίαση της εντολής \chessboard Η εντολή **`\chessboard[〈key=value list〉]`**: στοιχειοθετεί σκακιέρες χρησιμοποιώντας ένα προαιρετικό `〈key=value list〉`. Η λίστα των `κλειδιών` που είναι διαθέσιμα για χρήση είναι *εκτεταμένη*, προσφέροντας μεγάλο βαθμό ελέγχου στο μέγεθος, το περιεχόμενο, τη διάταξη, τον σχεδιασμό, τις σημειώσεις κ.λπ. των σκακιερών. Οι αναγνώστες ενθαρρύνονται να διαβάσουν την εξαιρετική τεκμηρίωση του πακέτου για [`chessboard` (PDF)](https://texdoc.org/serve/chessboard/0) και [`xskak` (PDF)](https://texdoc.org/serve/xskak/0), και οι δύο από τις οποίες περιέχουν πολυάριθμα χρήσιμα παραδείγματα—*πολλές* περισσότερα από όσα μπορούμε να δείξουμε σε αυτό το άρθρο. Επειδή τα κλειδιά είναι προαιρετικά, μπορείτε να γράψετε `\chessboard` το οποίο χρησιμοποιεί τις προεπιλεγμένες τιμές του πακέτου για να στοιχειοθετήσει μια σκακιέρα· για παράδειγμα, ο ακόλουθος κώδικας στοιχειοθετεί δύο σκακιέρες χρησιμοποιώντας `\chessboard` χωρίς καμία επιλογή. Πρόσθετες σημειώσεις, που προστέθηκαν χειροκίνητα στο Inkscape, δείχνουν τα *movers* (εδώ ως τετράγωνα) που στοιχειοθετούνται από προεπιλογή: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5} \chessboard % αντί για \showboard \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6} \chessboard % αντί για \showboard \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Το ακόλουθο γραφικό δείχνει τις δύο σκακιέρες που παράγονται από τον παραπάνω κώδικα, και οι δύο στοιχειοθετήθηκαν χρησιμοποιώντας `\chessboard`: ![](/files/0ba0587cc33930f1501ec1a70391d0c414ed7e05) Όπως είναι αναμενόμενο, παρέχονται διάφορα κλειδιά για τον έλεγχο του mover, συμπεριλαμβανομένης της εμφάνισης ή απόκρυψής του· για παράδειγμα, για να αποκρύψετε το mover μπορείτε να χρησιμοποιήσετε το `showmover` κλειδί με τιμή `false`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}\par \chessboard[showmover=false] % Απόκρυψη του mover \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το παράδειγμα παράγει το ακόλουθο αποτέλεσμα—μια σκακιέρα χωρίς το mover: ![](/files/2f178c2b4e288ed44f06bdf03e71a21d3b2c9fbc) Η [`chessboard` τεκμηρίωση του πακέτου (PDF)](https://texdoc.org/serve/chessboard/0) παρέχει μια λίστα κλειδιών για την προσαρμογή του mover, μαζί με μια σημείωση για το πώς να σχεδιάσετε το δικό σας mover! ## Πρόσθετα παραδείγματα xskak ### Κειμενικά σχόλια Η προδιαγραφή PGN υποστηρίζει την προσθήκη σχολίων χρησιμοποιώντας αγκύλες γύρω από το κείμενο του σχολίου: `{〈Text〉}`· ωστόσο, το `xskak` πακέτο προτιμά τα κειμενικά σχόλια να γράφονται ως `\xskakcomment{〈Text〉}`, όπως φαίνεται στο ακόλουθο παράδειγμα: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame % Ξεκινά μια νέα σκακιστική παρτίδα \mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6 \xskakcomment{ Αυτό είναι ένα σχόλιο. }}\vspace{3mm} \chessboard \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/0ea90535e7d921ae3769cb06bc446befbb8ef04d) ### Αρχικοποίηση σκακιέρας με σημειογραφία FEN Μπορείτε να χρησιμοποιήσετε τη FEN για να ξεκινήσετε τη σκακιέρα από οποιαδήποτε θέση. Το ακόλουθο παράδειγμα χρησιμοποιεί το `setfen` κλειδί σε ένα `\chessboard` εντολή για την επίδειξη ενός παραδείγματος FEN που έχει ληφθεί από το `skak` τεκμηρίωση του πακέτου: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \chessboard[setfen=r5k1/1b1p1ppp/p7/1p1Q4/2p1r3/PP4Pq/BBP2b1P/R4R1K w - - 0 20] \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/dfa780bad81799e96c5d068052cfae0089ed5949) Η σημειογραφία FEN συμπληρώνει τη σκακιέρα ξεκινώντας από την ανώτατη σειρά (αριθμός 8) και προχωρά προς τα κάτω για να συμπληρώσει τις επόμενες σειρές. Για παράδειγμα, για να αρχικοποιηθεί η σκακιέρα παραπάνω, η σειρά 8 περιγράφεται χρησιμοποιώντας **r5k1**: * **r**ook * **5** κενά τετράγωνα * το **k**ing * **1** κενό τετράγωνο επομένως χρησιμοποιώντας τη σημειογραφία **r5k1**. Σημειώστε τη χρήση πεζών γραμμάτων για την περιγραφή των μαύρων σκακιστικών κομματιών μαζί με τη χρήση κεφαλαίων **Π** για τα λευκά πιόνια και πεζά **σ** για τα μαύρα πιόνια. ### Χρησιμοποιώντας το \lastmove Η `\lastmove` η εντολή μπορεί να χρησιμοποιηθεί για σχολιασμό της τελευταίας κίνησης που έγινε: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \mainline{1.e4} \chessboard \lastmove{} είναι η πιο συνηθισμένη εναρκτήρια κίνηση. \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/7d30d514e75cf11b29d6e75fed8cc8d5932960b3) ### Παραλλαγές και ένα παράδειγμα της σημειογραφίας ... Τα παρακάτω αναπαράγουν ένα παράδειγμα που περιλαμβάνεται στο `skak` τεκμηρίωση του πακέτου, ενημερωμένη ώστε να χρησιμοποιεί `xskak` εντολές. Εδώ, βλέπουμε ένα παράδειγμα της `\variation` εντολής και της σύνταξης με τις τρεις τελείες (...) [που χρησιμοποιείται για να υποδείξει μια μαύρη κίνηση](#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} Μια παραλλαγή \variation{3...Nf6} χρησιμοποιείται εδώ για να δείξει μια εντολή \texttt{\string\variation}. \mainline{4.Ba4} \chessboard \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/f33214473d8133149bfd73367a99c05f426758ae) ### Εμφάνιση μόνο ορισμένων σκακιστικών κομματιών Επειδή `xskak` φορτώνει το `chessboard` πακέτο μπορείτε να χρησιμοποιήσετε την εξαιρετικά ισχυρή **`\chessboard[〈key=value list〉]`** εντολή για να εμφανίσετε ή να αποκρύψετε περιοχές της σκακιέρας, ή συλλογές σκακιστικών κομματιών, που σας ενδιαφέρουν. Η [τεκμηρίωση του chessboard](https://texdoc.org/serve/chessboard/0) περιέχει πολλά παραδείγματα, όπως αυτά που αναπαράγονται παρακάτω. #### Χρήση κλειδιών για την απόκρυψη ορισμένων πεδίων Αυτό το παράδειγμα χρησιμοποιεί τα κλειδιά `hideall`, `showpieces` και `addpieces`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \chessboard[hideall, showpieces={P,p}, addpieces=pe5] \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το `xskak` το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/2679e637c3848f4124aae19c16142d34ef098c55) Αυτό το παράδειγμα χρησιμοποιεί τα κλειδιά `hidefiles`, `showfiles` και `showranks`: ```latex \documentclass{article} \usepackage{xskak} \begin{document} \newchessgame \def\myfiles{a,b} \chessboard[hidefiles=\myfiles, addpieces=Ra2, showfiles=a, showranks=2] \end{document} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το `xskak` το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/0bd2d295817c929217ae287f5f392b6005c190ee) #### Χρήση κλειδιών για την απόκρυψη όλων των λευκών ή όλων των μαύρων κομματιών Το ακόλουθο παράδειγμα δείχνει τα κλειδιά `hidewhite` και `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} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το `xskak` το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/0e97dfc28981010809cad49e4db6185ef81b50f6) ## Περισσότερα παραδείγματα από το tex.stackexchange Τα ακόλουθα παραδείγματα χρησιμοποιούν λύσεις που βρέθηκαν στο [tex.stackexchange.com](https://tex.stackexchange.com). ### Πώς να τονίσετε τετράγωνα; Πηγή: βασισμένο σε ```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} ``` [Ανοίξτε αυτό το παράδειγμα στο 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/1e32e0318ec31c05714c7e6b83bec1a2210907e4) ### Δημιουργία διαφορετικών στυλ σκακιέρας Πηγή: βασισμένο σε ```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} ``` [Ανοίξτε αυτό το παράδειγμα στο 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) Αυτό το `xskak` το παράδειγμα παράγει το ακόλουθο αποτέλεσμα: ![](/files/795a701db396aa75a73e6a61870d9d2c4e558639) ## Περαιτέρω ανάγνωση Για περισσότερες πληροφορίες δείτε: * [Δημιουργία εγγράφου σε LaTeX](/latex/el/ta-vasika-toy-latex/01-learn-latex-in-30-minutes.md) * [Εισαγωγή εικόνων](/latex/el/perissotera-themata/27-inserting-images.md) * [Τοποθέτηση εικόνων και πινάκων](/latex/el/sximata-kai-pinakes/02-positioning-images-and-tables.md) * [Υποστήριξη διεθνών γλωσσών](/latex/el/glosses/03-international-language-support.md) * [Μεγέθη, οικογένειες και στυλ γραμματοσειρών](/latex/el/grammatoseires/01-font-sizes-families-and-styles.md) * [Τύποι γραμματοσειρών](/latex/el/grammatoseires/02-font-typefaces.md) * [Διαχείριση σε ένα μεγάλο έργο](/latex/el/domi-eggrafoy/07-management-in-a-large-project.md) * [Η `skak` πακέτο](https://ctan.org/pkg/skak?lang=en) * [Η `xskak` πακέτο](https://ctan.org/pkg/xskak?lang=en) * [Αλγεβρική σημειογραφία στο σκάκι (στη Wikipedia)](http://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) * [Σημειογραφία Forsyth-Edwards (FEN) (στη Wikipedia)](http://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) * [Η `chessboard` πακέτο](https://ctan.org/pkg/chessboard?lang=en) * [Κείμενο του προτύπου 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/el/eidiko-pedio/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.