> 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/ar/khas-balmjal/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` ؛ بل هي مجموعة من خطوط الشطرنج من النوع 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/e4346ed7b99023c38cf6beb660fa3b82c2c42a16)

## اصطلاحات الشطرنج: مراجعة موجزة

لفائدة القراء الجدد على الشطرنج، خاصةً تنضيده، تقدم الأقسام التالية *موجزة* مقدمات لموضوعات واصطلاحات ستصادفونها ضمن حِزم الشطرنج في 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). والرابط المباشر إلى المعيار هو <https://tim-mann.org/Standard>.

وفقاً لـ [نص معيار PGN](https://tim-mann.org/Standard):

> PGN هو "Portable Game Notation"، وهو معيار صُمم لتمثيل بيانات مباريات الشطرنج باستخدام ملفات نصية ASCII. وقد بُني PGN بحيث يسهل على المستخدمين البشر قراءته وكتابته، ويسهل على البرامج الحاسوبية تحليله وتوليده... ويُقترح PGN بوصفه تمثيلاً محمولاً عالمياً لتبادل البيانات.

لاحظ أن ملفات PGN مصممة من أجل *تبادل **بيانات** المباريات*؛ أي إن ملفات PGN مصممة لتحتوي على *معلومات المباراة الكاملة* — مثل أسماء اللاعبين، وتفاصيل الحدث/التاريخ، إلخ، إلى جانب سجلٍ، بالترميز الجبري، لـ *جميع الحركات* في المباراة.

**ملاحظة**: ولمقدمة قصيرة أخرى إلى PGN، زر <http://www.enpassant.dk/chess/palview/p3manual/p3pgn.htm>

### المراتب والملفات في رقعة الشطرنج

رقعة الشطرنج عبارة عن شبكة 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/005d6e77b41fb3640e89bbb8cfab7319e89fef72)

يقع كل مربع على رقعة الشطرنج عند تقاطع ملف (عمود) معين ومرتبة (صف): ويمكن استخدام قيمة الملف والمرتبة المقابلتين كإحداثيات للتعريف الفريد بكل مربع عند وصف موقع قطع الشطرنج وحركتها.

وعلى سبيل المثال، يوضح الرسم التالي المربع الواقع عند **e7** يتبعه لوح شطرنج ثانٍ يعدد مواقع جميع المربعات الـ 64:

![](/files/73dc2d2aa6bff78c3175d8c97ca9a7d0ee28daca)

إذا كنت جديداً على الشطرنج، فإن صفحة ويكيبيديا [الترميز الجبري](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)) تحتوي على بعض المعلومات الخلفية المفيدة، نلخص بعضها أدناه.

### ترميز قطع الشطرنج

يُعرَّف كل نوع من قطع الشطرنج، باستثناء البيادق عادةً، بحرف كبير قد يختلف بحسب اللغة المستخدمة. ويستخدم اللاعبون الناطقون بالإنجليزية الحروف التالية:

| الحرف | القطع   |
| ----- | ------- |
| K     | الملك   |
| Q     | الوزيرة |
| R     | القلعة  |
| B     | الفيل   |
| N     | الحصان  |

في الترميز الجبري القياسي لا تُعرَّف البيادق *عادةً* بحرف كبير؛ بل يمكن التعرّف عليها من خلال *غياب* حرف كبير. غير أن هذا الاصطلاح لا يُتَّبع دائماً؛ إذ قد يُستخدم الحرف الكبير P للدلالة على البيادق. في [ترميز فورسايث-إدواردز (FEN)](#forsyth-edwards-notation-fen) تُستخدم الأحرف الكبيرة والصغيرة لتمثيل قطع الشطرنج.

### ترميز نقلة فردية

لتسجيل حركة قطعة شطرنج، تحتاج إلى تحديد القطعة والمربع المقصود. ويمكن تحقيق ذلك باستخدام الحرف الكبير للقطعة بالإضافة إلى إحداثيات مربع الوجهة.

**ملاحظة**: عند وصف نقلة بيدق، لا يُستخدم حرف يشير إلى أن القطعة بيدق *عادةً* ؛ بل يُكتفى بمربع الوجهة *عادةً* كما هو موضح في الأمثلة التالية:

* *غير البيادق* حركات:
  * **Be5**: **B**يشير إلى أن الفيل يتحرك إلى المربع **e5**
  * **Nf3**: ال**N**حصان يتحرك إلى المربع **f3**
* *بيادق* حركات:
  * **c5**: يتحرك بيدق إلى المربع **c5**
  * **ملاحظة**: في ظروف معينة (مثل بعض أوامر LaTeX) تُعرَّف البيادق *على أنها مُعرَّفة* بحرف كبير **P**؛ لذا **c5** قد يُكتب **Pc5**.

#### ثلاث نقاط (...) للدلالة على حركة القطعة السوداء

القسم 8.2.2.2 من [معيار ترميز الألعاب المحمولة](https://tim-mann.org/Standard) يشرح استخدام ثلاث نقاط (...) بعد مؤشر رقم نقلة (مثلاً، **3...e6**):

> يُشكَّل مؤشر رقم النقلة البيضاء من العدد الصحيح الذي يعطي رقم النقلة الكاملة مع إضافة نقطة واحدة. ويُشكَّل مؤشر رقم النقلة السوداء من العدد الصحيح الذي يعطي رقم النقلة الكاملة مع ***ثلاث نقاط مضافة***.

### اصطلاح سلسلة من الحركات

كما هو موضح في مقال ويكيبيديا عن [الترميز الجبري](https://en.wikipedia.org/wiki/Algebraic_notation_\(chess\)#Formatting)، لوصف سلسلة من الحركات:

* كل نقلة فردية *عادةً* تستخدم أحرفاً كبيرة للقطع غير البيادق، مع أنه، كما ذُكر أعلاه، قد يُستخدم في بعض الظروف (الاصطلاحات) حرف P كبير للدلالة على نقلة بيدق.
* سلسلة من نقلات الشطرنج هي تسلسل من `<نقلة القطعة البيضاء> <نقلة القطعة السوداء>` أزواج—لاحظ أن كل زوج من النقلات مُرقَّم (انظر المثال أدناه)

### ترميزات شطرنجية أخرى: FAN وFEN

#### الترميز الجبري التصويري (أو FAN)

غالباً ما تُستبدل الحروف الخاصة بكل لغة والمستخدمة لتمثيل قطع الشطرنج برموز معترف بها عالمياً تمثل قطع الشطرنج. ويُعرف هذا التمثيل الرمزي باسم الترميز الجبري التصويري، أو FAN. فعلى سبيل المثال، يمكن استخدام الرمز ♞ (أو ♘) بدلاً من N (للحصان).

تُدرج مواصفة Unicode محارف الشطرنج ضمن [مجموعة الرموز المتنوعة](https://www.unicode.org/charts/PDF/U2600.pdf). يسرد الجدول التالي قيمة Unicode، والاسم، والرمز التمثيلي لكل محرف شطرنج — أما الرسوم الحرفية الفعلية (تصاميم المحارف) المستخدمة لعرض رموز الشطرنج فستعتمد على إعدادات الخطوط في جهازك/متصفحك.

| <p>الرمز التمثيلي<br>(الشكل الحرفي)</p> | <p>قيمة Unicode<br>(بالست عشري)</p> | <p>اسم محرف Unicode<br>(رسمي)</p> |
| --------------------------------------- | ----------------------------------- | --------------------------------- |
| ♔                                       | 2654                                | ملك الشطرنج الأبيض                |
| ♕                                       | 2655                                | وزيرة الشطرنج البيضاء             |
| ♖                                       | 2656                                | قلعة الشطرنج البيضاء              |
| ♗                                       | 2657                                | فيل الشطرنج الأبيض                |
| ♘                                       | 2658                                | حصان الشطرنج الأبيض               |
| ♙                                       | 2659                                | بيدق الشطرنج الأبيض               |
| ♚                                       | 265A                                | ملك الشطرنج الأسود                |
| ♛                                       | 265B                                | وزيرة الشطرنج السوداء             |
| ♜                                       | 265C                                | قلعة الشطرنج السوداء              |
| ♝                                       | 265D                                | فيل الشطرنج الأسود                |
| ♞                                       | 265E                                | حصان الشطرنج الأسود               |
| ♟                                       | 265F                                | بيدق الشطرنج الأسود               |

#### ترميز فورسايث-إدواردز (FEN)

كما ذُكر، يُستخدم PGN لتخزين وتبادل *المباريات الكاملة*، بما في ذلك جميع النقلات التي لُعبت في تلك المباراة. وعلى النقيض من ذلك، فإن [ترميز فورسايث-إدواردز (FEN)](https://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) يوفر لقطة لحالة مباراة في نقطة زمنية ما. ويستخدم ترميز FEN الحروف الكبيرة والصغيرة لتمثيل قطع الشطرنج:

* تُعرَّف القطع البيضاء بالحروف الكبيرة (PNBRQK)
* تُعرَّف القطع السوداء بالحروف الصغيرة (pnbrqk)

حيث P هو بيدق أبيض وp هو بيدق أسود.

ولا يتسع نطاق هذه المقالة لمناقشة FEN بالتفصيل ومقارنته بـ PGN. وقد يرغب القراء الذين يريدون فهم الفروق بين PGN وFEN بشكل أفضل في استكشاف الفيديو التالي:

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

## مثال أول مع حزمة 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/95e0edd3a89816c912366dd07a00ca3069305e48)

تُستخدم الأوامر التالية:

* **`\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〉]`**: ينضّد ألواح الشطرنج باستخدام `قائمة اختيارية من المفاتيح`. قائمة `المفاتيح` المتاحة للاستخدام هي *بشكل واسع*، مما يوفر قدراً كبيراً من التحكم في حجم لوح الشطرنج ومحتواه وتخطيطه وتصميمه وتعليقاته إلخ. ويُشجَّع القراء على قراءة توثيق الحزمة الممتاز لـ [`chessboard` (PDF)](https://texdoc.org/serve/chessboard/0) و [`xskak` (PDF)](https://texdoc.org/serve/xskak/0)، وكلاهما يحتوي على أمثلة مفيدة عديدة —*الكثير من* أكثر مما يمكننا عرضه في هذه المقالة.

وبما أن المفاتيح اختيارية يمكنك كتابة `\chessboard` الذي يستخدم القيم الافتراضية للحزمة لتنضيد لوحة شطرنج؛ فعلى سبيل المثال، ينضّد الكود التالي لوحتين باستخدام `\chessboard` من دون أي خيارات. وتوضح التعليقات الإضافية، المضافة يدوياً في Inkscape، *المحرِّكات* (هنا على هيئة مربعات) التي تُنضَّد افتراضياً:

```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/6927e5e29ed4a26a69c9845959b0a939111c45ec)

وليس من المستغرب أن تُوفَّر مفاتيح مختلفة للتحكم في المحرِّك، بما في ذلك إظهاره أو إخفاؤه؛ فعلى سبيل المثال، لإخفاء المحرِّك يمكنك استخدام المفتاح `showmover` مع قيمة `خطأ`:

```latex
\documentclass{article}
\usepackage{xskak}
\begin{document}
\newchessgame
\mainline{1.e4 e5 2.Nf3 Nc6 3.Bb5 a6}\par
\chessboard[showmover=false] % إخفاء المحرِّك
\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)

ينتج هذا المثال المخرجات التالية — لوحة شطرنج من دون المحرِّك:

![](/files/2d8e15b174813f2eaf7573b07495bfcb6cb24204)

ال [`chessboard` وثائق الحزمة (PDF)](https://texdoc.org/serve/chessboard/0) يوفر قائمة بالمفاتيح لتخصيص المحرِّك، إلى جانب ملاحظة حول كيفية تصميم محرِّكك الخاص!

## أمثلة إضافية على 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/d8eaeeb91116666b896afdc13c20eec15ae9d6ef)

### تهيئة رقعة باستخدام ترميز 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/95b8ba48669ec73a01523458fa48a926f1b1d64a)

يملأ ترميز FEN الرقعة بدءًا من الصف الأعلى (الرتبة 8) ويتجه إلى الأسفل لملء الصفوف اللاحقة. على سبيل المثال، لتهيئة الرقعة أعلاه تُوصف الرتبة 8 باستخدام **r5k1**:

* **r**رخ
* **5** مربعات فارغة
* موقع **ك**ينغ
* **1** مربع فارغ

ومن ثم باستخدام الترميز **r5k1**. لاحظ استخدام الأحرف الصغيرة لوصف قطع الشطرنج السوداء إلى جانب استخدام الأحرف الكبيرة **P** للبيدق الأبيض والأحرف الصغيرة **ص** للبيدق الأسود.

### باستخدام \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/dc47758af482f3de02c8d5be1684dc4b296d870e)

### التفرعات ومثال على الترميز ...

ما يلي يعيد إنتاج مثال وارد في `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/8130fed80b46b923c8708e3b2e9b4e34376799c9)

### إظهار بعض قطع الشطرنج فقط

لأن `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/af6214ed594f24dd59a9948fdd1ea150118c570d)

يستخدم هذا المثال المفاتيح `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/3025dea8443b5a0caa306c8b27a44d176a86a1ae)

#### استخدام المفاتيح لإخفاء جميع القطع البيضاء أو جميع القطع السوداء

يوضح المثال التالي المفاتيح `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/5d0fa7eea7e28b7e730c37c6d86603582ae70ff2)

## أمثلة إضافية من tex.stackexchange

تستخدم الأمثلة التالية حلولًا وُجدت على [tex.stackexchange.com](https://tex.stackexchange.com).

### كيف يمكن تمييز المربعات؟

المصدر: بناءً على <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}
```

[افتح هذا المثال في 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/d5c84cba7a279bfe6522c45233834dfbfe865d99)

### إنشاء أنماط مختلفة للرقعة

المصدر: بناءً على <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}
```

[افتح هذا المثال في 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/2981bb1bbbeb1c3c27ec686b6d68b1a6f0f19d46)

## قراءة إضافية

لمزيد من المعلومات، انظر:

* [إنشاء مستند في LaTeX](/latex/ar/asasyat-latex/01-learn-latex-in-30-minutes.md)
* [إدراج الصور](/latex/ar/mzyd-mn-almwdhwaat/27-inserting-images.md)
* [تموضع الصور والجداول](/latex/ar/alashkal-waljdawl/02-positioning-images-and-tables.md)
* [دعم اللغات الدولية](/latex/ar/allghat/03-international-language-support.md)
* [أحجام الخطوط، والعائلات، والأنماط](/latex/ar/alkhtwt/01-font-sizes-families-and-styles.md)
* [وجوه الخطوط](/latex/ar/alkhtwt/02-font-typefaces.md)
* [الإدارة في مشروع كبير](/latex/ar/bnyh-almstnd/07-management-in-a-large-project.md)
* [ال `skak` الحزمة](https://ctan.org/pkg/skak?lang=en)
* [ال `xskak` الحزمة](https://ctan.org/pkg/xskak?lang=en)
* [الترميز الجبري في الشطرنج (على ويكيبيديا)](http://en.wikipedia.org/wiki/Algebraic_notation_\(chess\))
* [ترميز فورسايث-إدواردز (FEN) (على ويكيبيديا)](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/ar/khas-balmjal/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.