> 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/asasyat-latex/01-learn-latex-in-30-minutes.md). # إنشاء أول مستند LaTeX لك **جديد: زر** [**مركز تعلم Overleaf**](https://learn.overleaf.com/) **لاستكشاف دورات مجانية عبر الإنترنت وندوات مباشرة عبر الويب — كل ما تحتاجه لإتقان LaTeX والاستفادة القصوى من Overleaf.** هذا الدرس التعريفي لا يفترض أي خبرة سابقة في LaTeX، ولكن نأمل أنه بحلول الوقت الذي تنتهي فيه، لن تكون قد كتبت أول مستند LaTeX فحسب، بل ستكون قد اكتسبت أيضًا معرفة وثقة كافيتين لاتخاذ الخطوات التالية نحو إتقان LaTeX. ## ما هو LaTeX؟ LaTeX (يُنطق «*LAY*-tek» أو «*LAH*-tek») هو أداة لإعداد مستندات ذات مظهر احترافي. ومع ذلك، فإن طريقة عمل LaTeX مختلفة تمامًا عن العديد من تطبيقات إنتاج المستندات الأخرى التي ربما استخدمتها، مثل Microsoft Word أو LibreOffice Writer: فهذه الأدوات «[WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG)» توفر للمستخدمين صفحة تفاعلية يكتبون ويحررون فيها نصهم ويطبقون أشكالًا مختلفة من التنسيق. يعمل LaTeX بطريقة مختلفة جدًا: فبدلًا من ذلك، يكون مستندك ملف نص عادي تتخلله أوامر LaTeX *الأوامر* المستخدمة للتعبير عن النتائج المطلوبة (المُنضَّدة). ولإنتاج مستند مرئي ومُنضَّد، تتم معالجة ملف LaTeX الخاص بك بواسطة جزء من البرمجيات يُسمى *محرك TeX* ويستخدم الأوامر المضمنة في ملفك النصي لتوجيه عملية التنضيد والتحكم فيها، محولًا أوامر LaTeX ونص المستند إلى ملف PDF منسق باحتراف. وهذا يعني أنك تحتاج فقط إلى التركيز على *المحتوى* محتوى *المظهر البصري* (التنسيق). ## لماذا تتعلم LaTeX؟ يمكن طرح حجج مختلفة مع أو ضد تعلم استخدام LaTeX بدلًا من تطبيقات أخرى لكتابة المستندات؛ لكن في النهاية، إنه اختيار شخصي يعتمد على التفضيلات والميول ومتطلبات التوثيق. تشمل الحجج المؤيدة لـ LaTeX ما يلي: * دعم تنضيد الرياضيات المعقدة للغاية والجداول والمحتوى التقني في العلوم الفيزيائية؛ * أدوات للحواشي السفلية والإحالات المتقاطعة وإدارة المراجع الببليوغرافية؛ * سهولة إنتاج عناصر المستندات المعقدة أو المرهقة مثل الفهارس، والمعاجم، وفهرس المحتويات، وقوائم الأشكال؛ * إمكانية تخصيص عالية لإنتاج مستندات مخصصة بفضل قابليته البرمجية الجوهرية وقابليته للتوسعة عبر آلاف من [الحزم الإضافية المجانية](https://www.ctan.org/pkg). بوجه عام، يمنح LaTeX المستخدمين قدرًا كبيرًا من التحكم في إنتاج مستندات تُنضَّد وفق أعلى المعايير. وبالطبع، توجد أنواع من المستندات أو المنشورات لا يبرع فيها LaTeX، بما في ذلك كثير من تصميمات الصفحات «الحرة» الموجودة عادةً في المنشورات من نوع المجلات. تتمثل إحدى الفوائد المهمة لـ LaTeX في الفصل بين محتوى المستند وأسلوبه: فبمجرد كتابة محتوى مستندك، يمكن تغيير مظهره بسهولة. وبالمثل، يمكنك إنشاء ملف LaTeX يعرّف التخطيط/الأسلوب لنوع معين من المستندات ويمكن استخدام هذا الملف كـ *نموذج* لتوحيد تأليف/إنتاج مستندات إضافية من ذلك النوع؛ فعلى سبيل المثال، يتيح ذلك للناشرين العلميّين إنشاء قوالب للمقالات، في LaTeX، يستخدمها المؤلفون لكتابة الأبحاث المقدمة إلى المجلات. لدى Overleaf [معرض يضم آلاف القوالب](https://www.overleaf.com/gallery)، يغطي نطاقًا هائلًا من أنواع المستندات—من المقالات العلمية والتقارير والكتب إلى السير الذاتية والعروض التقديمية. وبما أن هذه القوالب تحدد تخطيط المستند وأسلوبه، فما على المؤلفين إلا فتحها في Overleaf — بإنشاء مشروع جديد — والبدء بالكتابة لإضافة محتواهم. ## كتابة أول جزء لك من LaTeX الخطوة الأولى هي إنشاء مشروع LaTeX جديد. يمكنك القيام بذلك على جهازك الخاص بإنشاء `.tex` ملف جديد؛ أو يمكنك [بدء مشروع جديد في Overleaf](/latex/ar/qaadh-almarfh/031-creating-a-document-in-overleaf.md). لنبدأ بأبسط مثال عملي، والذي يمكن فتحه مباشرةً في Overleaf: ```latex \documentclass{article} \begin{document} المستند الأول. هذا مثال بسيط، من دون أي معاملات أو حزم إضافية مضمنة. \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Simplest+working+example+LaTeX+document\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AFirst+document.+This+is+a+simple+example%2C+with+no+%0Aextra+parameters+or+packages+included.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![مستند مثال](/files/dee02e1738eb7d478aaf58da3dedc412e98ff3fe) يمكنك أن ترى أن LaTeX قام تلقائيًا بإزاحة السطر الأول من الفقرة، متكفلًا بذلك التنسيق نيابةً عنك. لنلقِ نظرة أقرب على ما يفعله كل جزء من شفرتنا. السطر الأول من الشفرة، `\documentclass{article}`، يصرّح بنوع المستند المعروف باسم *الصنف*، والذي يتحكم في المظهر العام للمستند. تتطلب الأنواع المختلفة من المستندات فئات مختلفة؛ أي إن السيرة الذاتية/الـ CV ستتطلب فئة مختلفة عن الورقة العلمية التي قد تستخدم فئة LaTeX القياسية `article` فئة. قد تتطلب أنواع أخرى من المستندات التي قد تعمل عليها فئات مختلفة مثل `book` أو `التقرير`. وللحصول على فكرة عن الأنواع العديدة من فئات LaTeX المتاحة، [زر الصفحة ذات الصلة على CTAN (شبكة أرشيف TeX الشاملة)](https://www.ctan.org/topic/class). بعد ضبط فئة المستند، يُكتب محتوانا، المعروف باسم *جسم* المستند، بين `\begin{document}` و `\end{document}` الوسوم. بعد فتح المثال أعلاه، يمكنك إجراء تغييرات على النص، وعند الانتهاء، عرض ملف PDF الناتج المصفوف عن طريق *إعادة تجميع المستند*. للقيام بذلك في Overleaf، ما عليك سوى الضغط على **إعادة التحويل**، كما هو موضح في هذا المقطع المصور القصير: {% embed url="" %} يمكن تهيئة أي مشروع في Overleaf لإعادة التجميع تلقائيًا كلما تم تحريره: انقر السهم الصغير بجوار **إعادة التحويل** الزر واضبط **الترجمة التلقائية** إلى **تشغيل**، كما هو موضح في لقطة الشاشة التالية: ![لقطة شاشة توضح كيفية ضبط الترجمة التلقائية على تشغيل أو إيقاف](/files/d67eed5f7432f4cf15061ce6deb6ce9cdb8dcce9) بعد أن رأينا كيفية إضافة المحتوى إلى مستندنا، فإن الخطوة التالية هي إعطاؤه عنوانًا. للقيام بذلك، يجب أن نتحدث بإيجاز عن **المقدمة**. ## الجزء التمهيدي من المستند تُظهر لقطة الشاشة أعلاه أن Overleaf يخزن مستند LaTeX كملف يُسمى `main.tex`: `.tex` امتداد الملف يُستخدم، بحسب العرف، عند تسمية الملفات التي تحتوي على شفرة LaTeX الخاصة بمستندك. أظهر المثال السابق كيف تم إدخال محتوى المستند بعد `\begin{document}` الأمر؛ ومع ذلك، فإن كل ما في `.tex` الملف الذي يظهر *قبل أن* تلك النقطة يُسمى *المقدمة*، وهو يعمل كقسم «الإعداد» للمستند. داخل الجزء التمهيدي، تحدد فئة المستند (نوعه) إلى جانب تفاصيل مثل اللغات التي ستُستخدم عند كتابة المستند؛ وتحميل *الحزم* التي ترغب في استخدامها (المزيد حول هذا [لاحقًا](#finding-and-using-latex-packages))، وهو أيضًا المكان الذي تطبق فيه أنواعًا أخرى من الإعدادات. قد يبدو الجزء التمهيدي الأدنى للمستند هكذا: ```latex \documentclass[12pt, letterpaper]{article} \usepackage{graphicx} ``` حيث `\documentclass[12pt, letterpaper]{article}` يحدد الفئة العامة (النوع) للمستند. تُضمَّن المعاملات الإضافية، التي يجب فصلها بفواصل، داخل أقواس مربعة (`[...]`) وتُستخدم لتهيئة هذه النسخة من فئة المقال؛ أي الإعدادات التي نرغب في استخدامها لهذا المستند المعتمد على الفئة `article`. في هذا المثال، يؤدي المعاملان الدور التالي: * `12pt` يضبط حجم الخط * `letterpaper` يضبط حجم الورق بالطبع يمكن استخدام أحجام خطوط أخرى، `9pt`, `11pt`, `12pt`، لكن إذا لم يُحدد أي منها، يكون الحجم الافتراضي `10pt`. أما بالنسبة لحجم الورق، فالقيم الممكنة الأخرى هي `a4paper` و `legalpaper`. ولمزيد من المعلومات انظر المقالة حول [حجم الصفحة والهوامش](/latex/ar/altnsyq/07-page-size-and-margins.md). سطر الجزء التمهيدي ```latex \usepackage{graphicx} ``` هو مثال على تحميل حزمة خارجية (هنا، [`graphicx`](https://ctan.org/pkg/graphicx?lang=en)) لتوسيع قدرات LaTeX، مما يتيح له استيراد ملفات رسومية خارجية. تُناقَش حزم LaTeX في القسم [العثور على حزم LaTeX واستخدامها](#finding-and-using-latex-packages). ## إضافة معلومات العنوان والمؤلف والتاريخ إضافة عنوان ومؤلف وتاريخ إلى مستندنا يتطلب ثلاث أسطر إضافية في *المقدمة* (*تحتوي* جسم المستند الرئيسي). وهذه الأسطر هي: * `\title{My first LaTeX document}`: عنوان المستند * `\author{Hubert Farnsworth}`: هنا تكتب اسم المؤلف/المؤلفين، وباختياريًا، `\thanks` الأمر داخل الأقواس المعقوفة: * `\thanks{Funded by the Overleaf team.}`: يمكن إضافتها بعد اسم المؤلف، داخل أقواس `حقل المؤلف` الأمر. وستضيف رمزًا علويًا وحاشية سفلية بالنص الموجود داخل الأقواس. مفيدة إذا كنت بحاجة إلى شكر مؤسسة في مقالك. * `\date{August 2022}`: يمكنك إدخال التاريخ يدويًا أو استخدام الأمر `\today` لطباعة التاريخ الحالي في كل مرة يُعاد فيها تجميع المستند بعد إضافة هذه الأسطر، يجب أن يبدو الجزء التمهيدي لديك شيئًا من هذا القبيل: ```latex \documentclass[12pt, letterpaper]{article} \title{My first LaTeX document} \author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}} \date{August 2022} ``` لطباعة العنوان والمؤلف والتاريخ استخدم `\maketitle` الأمر داخل *جسم* المستند: ```latex \begin{document} \maketitle لقد أضفنا الآن عنوانًا ومؤلفًا وتاريخًا إلى أول مستند \LaTeX{} لنا! \end{document} ``` يمكن الآن دمج الجزء التمهيدي والجسم لإنتاج مستند كامل يمكن فتحه في Overleaf: ```latex \documentclass[12pt, letterpaper]{article} \title{My first LaTeX document} \author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}} \date{August 2022} \begin{document} \maketitle لقد أضفنا الآن عنوانًا ومؤلفًا وتاريخًا إلى أول مستند \LaTeX{} لنا! \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=My+first+LaTeX+document\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AWe+have+now+added+a+title%2C+author+and+date+to+our+first+%5CLaTeX%7B%7D+document%21%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة لمستند بسيط مُنتَج في LaTeX](/files/894c7286ae8f8677e711cde38f02b955d1922298) ## إضافة التعليقات LaTeX هو شكل من «شفرة البرمجة»، لكنه شكل متخصص في تنضيد المستندات؛ وبالتالي، كما هو الحال مع الشفرة المكتوبة بأي لغة برمجة أخرى، قد يكون من المفيد جدًا تضمين تعليقات داخل مستندك. تعليق LaTeX هو قسم من النص لن يُنضَّد ولن يؤثر في المستند بأي شكل—ويُستخدم غالبًا لإضافة ملاحظات «للمراجعة»؛ أو لتضمين ملاحظات توضيحية؛ أو لتقديم شروح داخل السطر للماكروات الصعبة؛ أو لتعطيل أسطر/أقسام من شفرة LaTeX عند تصحيح الأخطاء. لإضافة تعليق في LaTeX، ببساطة اكتب `%` رمزًا في بداية السطر، كما هو موضح في الشفرة التالية التي تستخدم المثال أعلاه: ```latex \documentclass[12pt, letterpaper]{article} \title{My first LaTeX document} \author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}} \date{August 2022} \begin{document} \maketitle لقد أضفنا الآن عنوانًا ومؤلفًا وتاريخًا إلى أول مستند \LaTeX{} لنا! % هذا السطر هنا تعليق. لن يُنضَّد في المستند. \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=My+first+LaTeX+document+with+a+comment\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AWe+have+now+added+a+title%2C+author+and+date+to+our+first+%5CLaTeX%7B%7D+document%21%0A%0A%25+This+line+here+is+a+comment.+It+will+not+be+typeset+in+the+document.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال مخرجات مطابقة لشفرة LaTeX السابقة التي لم تتضمن التعليق. ## الخط العريض والمائل والتحته خط بعد ذلك، سنلقي نظرة على بعض أوامر تنسيق النص: * **عريض**: يُنضَّد النص الغامق في LaTeX باستخدام `\textbf{...}` الأمر. * *المائل*: يُنتَج النص المائل باستخدام `\textit{...}` الأمر. * التسطير: لتسطير النص استخدم `\underline{...}` الأمر. يوضح المثال التالي هذه الأوامر: ```latex بعضٌ من \textbf{أعظم} الاكتشافات في \underline{العلوم} تمت \textbf{\textit{بالصدفة}}. ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=First+example+with+formatted+text\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0ASome+of+the+%5Ctextbf%7Bgreatest%7D%0Adiscoveries+in+%5Cunderline%7Bscience%7D+%0Awere+made+by+%5Ctextbf%7B%5Ctextit%7Baccident%7D%7D.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر نصًا منسقًا في مستند LaTeX](/files/9e4066cd693d041902623ac91ec8b51db991966f) أمر آخر مفيد جدًا هو `\emph{*argument*}`، والذي يعتمد تأثيره على `*argument*` على السياق. داخل النص العادي، يكون النص المؤكد مائلًا، ولكن هذا السلوك ينعكس إذا استُخدم داخل نص مائل—انظر المثال التالي: ```latex بعض أعظم \emph{الاكتشافات} في العلم تمت بالصدفة. \textit{بعضٌ من أعظم \emph{الاكتشافات} في العلم حدثت بالصدفة.} \textbf{بعضٌ من أعظم \emph{الاكتشافات} في العلم حدثت بالصدفة.} ``` [افتح هذا `**\emph**` مثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+the+emph+command\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%2C+twoside%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cparindent0pt%25+To+remove+the+paragraph+indentation%0A%5Cmaketitle%0ASome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+in+science+%0Awere+made+by+accident.%0A%0A%5Ctextit%7BSome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+%0Ain+science+were+made+by+accident.%7D%0A%0A%5Ctextbf%7BSome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+%0Ain+science+were+made+by+accident.%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة توضح استخدام الأمر \emph في LaTeX](/files/6dc68ff9c6a3a1efb1fceb7d8ae2e3cb3cb9a5b0) * **ملاحظة:** بعض الحزم، مثل [بيمر](/latex/ar/alarwdh-altqdymyh/01-beamer.md)، تغيّر سلوك `\emph` الأمر. ## إضافة الصور في هذا القسم سننظر في كيفية إضافة الصور إلى مستند LaTeX. يدعم Overleaf ثلاث طرق لإدراج الصور: 1. استخدم [**إدراج شكل** الزر](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using_Insert_Figure_to_add_a_figure_to_your_project)(![The Insert Figure button on the editor toolbar](/files/d2b38be5fa85b0b6161275782f9acdf0eff85889)، الموجود في شريط أدوات المحرر، لإدراج صورة في **المحرر المرئي** أو **محرر الكود**. 2. [نسخ صورة ولصقها](/latex/ar/qaadh-almarfh/075-how-to-paste-formatted-content-into-overleaf.md#pasting-images-into-your-overleaf-project) إدراجها في **المحرر المرئي** أو **محرر الكود**. 3. استخدم **محرر الكود** لكتابة شفرة LaTeX التي تُدرج رسماً. يقوم الخياران 1 و2 بتوليد شفرة LaTeX المطلوبة لإدراج الصور تلقائيًا، لكننا هنا نقدم الخيار 3—لاحظ أنك ستحتاج إلى [رفع تلك الصور](/latex/ar/qaadh-almarfh/088-including-images-on-overleaf.md) إلى مشروع Overleaf الخاص بك. يوضح المثال التالي كيفية تضمين صورة: ```latex \documentclass{article} \usepackage{graphicx} %حزمة LaTeX لاستيراد الرسومات \graphicspath{{images/}} %تهيئة حزمة graphicx \begin{document} الكون هائل ويبدو متجانسًا، على نطاق واسع، أينما نظرنا. % الأمر \includegraphics هو % موفَّر (مُنفَّذ) بواسطة % حزمة graphicx \includegraphics{universe} هناك صورة لمجرة أعلاه. \end{document} ``` [افتح مثال الصورة هذا في Overleaf.](https://www.overleaf.com/project/new/template/25686?id=107971142\&templateName=Example+using+images+in+LaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر صورة مُدرجة في مستند LaTeX](/files/70f7ff9a205c3a9942083756922154a2b6a2fda5) يتطلب استيراد الرسومات إلى مستند LaTeX [إضافةً *الحزمة*](#finding-and-using-latex-packages) توفر الأوامر والميزات اللازمة لتضمين ملفات رسومية خارجية. المثال أعلاه يحمّل [`graphicx` الحزمة](https://ctan.org/pkg/graphicx?lang=en) الذي، من بين العديد من الأوامر الأخرى، يوفر `\includegraphics{...}` لاستيراد الرسومات و `\graphicspath{...}` لإخبار LaTeX بمكان وجود الرسومات. لاستخدام `graphicx` حزمة، أدرج السطر التالي في الجزء التمهيدي من مستند Overleaf الخاص بك: ```latex \usepackage{graphicx} ``` في مثالنا، يأمر `\graphicspath{{images/}}` LaTeX بأن الصور محفوظة في مجلد يُسمى `images`، وهو موجود في الدليل الحالي: ![صورة تُظهر وصول LaTeX إلى صور مخزنة في مجلد](/files/ec91c625362d3afe60af0102ea55838412ffa6dc) ال `\includegraphics{universe}` يقوم الأمر بالفعل الفعلي المتمثل في إدراج الصورة في المستند. هنا، `universe` هو اسم ملف الصورة ولكن من دون امتداده. **ملاحظة**: * على الرغم من أن اسم الملف الكامل، بما في ذلك امتداده، مسموح به في `\includegraphics` الأمر، فإن إغفال امتداد الملف يُعد أفضل ممارسة لأنه سيحفز LaTeX على البحث عن جميع الصيغ المدعومة. * بوجه عام، ينبغي ألا يحتوي اسم ملف الرسم على مسافات بيضاء أو نقاط متعددة؛ ويُوصى أيضًا باستخدام أحرف صغيرة لامتداد الملف عند رفع ملفات الصور إلى Overleaf. يمكن العثور على مزيد من المعلومات حول حزم LaTeX في نهاية هذا الدرس في القسم [العثور على حزم LaTeX واستخدامها](#finding-and-using-latex-packages). ## التسميات التوضيحية والعلامات والمراجع يمكن إضافة تسميات توضيحية للصور ووضع علامات عليها والإحالة إليها بواسطة `figure` البيئة، كما هو موضح أدناه: ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{{images/}} \begin{document} \begin{figure}[h] \centering \includegraphics[width=0.75\textwidth]{mesh} \caption{رسم بياني جميل.} \label{fig:mesh1} \end{figure} كما ترى في الشكل \ref{fig:mesh1}، تنمو الدالة بالقرب من الأصل. يظهر هذا المثال في الصفحة \pageref{fig:mesh1}. \end{document} ``` [افتح مثال الصورة هذا في Overleaf.](https://www.overleaf.com/project/new/template/25519?id=107980830\&templateName=Example+using+image+captions+in+LaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر استخدام تسميات الأشكال التوضيحية في LaTeX](/files/acd04bd08004ff9915c04a215897b91f89ef9375) هناك عدة أوامر جديرة بالملاحظة في المثال: * **`\includegraphics[width=0.75\textwidth]{mesh}`**: هذا الشكل من `\includegraphics` يأمر LaTeX بضبط عرض الشكل إلى 75% من عرض النص—والذي تُخزَّن قيمته في `\textwidth` الأمر. * **`\caption{رسم بياني جميل.}`**: كما يوحي اسمه، يضبط هذا الأمر التسمية التوضيحية للشكل، ويمكن وضعها فوق الشكل أو تحته. إذا أنشأتَ قائمة بالأشكال فستُستخدم هذه التسمية التوضيحية فيها. * **`\label{fig:mesh1}`**: للإشارة إلى هذه الصورة داخل المستند تمنحها علامة باستخدام `\label` الأمر. تُستخدم العلامة لتوليد رقم للصورة، وبالاقتران مع الأمر التالي، ستسمح لك بالإحالة إليها. * **`\ref{fig:mesh1}`**: سيُستبدل هذا الرمز بالرقم المقابل للشكل المشار إليه. ينبغي وضع الصور المدمجة في مستند LaTeX داخل `figure` بيئة، أو ما شابه، حتى يتمكن LaTeX من تحديد موضع الصورة تلقائيًا في مكان مناسب داخل مستندك. توجد إرشادات إضافية في مقالات المساعدة التالية في Overleaf: * [تموضع الأشكال](/latex/ar/alashkal-waljdawl/02-positioning-images-and-tables.md) * [إدراج الصور](/latex/ar/mzyd-mn-almwdhwaat/27-inserting-images.md) ## إنشاء القوائم في LaTeX يمكنك إنشاء أنواع مختلفة من القوائم باستخدام *البيئات*، والتي تُستخدم لاحتواء شفرة LaTeX المطلوبة لتنفيذ ميزة تنضيد محددة. تبدأ البيئة بـ `\begin{*environment-name*}` وتنتهي بـ `\end{*environment-name*}` حيث `*environment-name*` قد يكون `figure`, `tabular` أو أحد أنواع القوائم: `itemize` للقوائم غير المرتبة أو `enumerate` للقوائم المرتبة. ### القوائم غير المرتبة تُنتَج القوائم غير المرتبة بواسطة `itemize` البيئة. يجب أن تسبق كلَّ عنصر في القائمة `\item` الأمر، كما هو موضح أدناه: ```latex \documentclass{article} \begin{document} \begin{itemize} \item تُشار إلى العناصر الفردية بنقطة سوداء، وتُسمى بالتعداد النقطي. \item قد يكون النص داخل العناصر بأي طول. \end{itemize} \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+a+LaTeX+unordered+list\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bitemize%7D%0A++%5Citem+The+individual+entries+are+indicated+with+a+black+dot%2C+a+so-called+bullet.%0A++%5Citem+The+text+in+the+entries+may+be+of+any+length.%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![مثال على القوائم النقطية في LaTeX](/files/5e458975a23127d13d264ef9f21a14faaca8defc) يمكنك أيضًا فتح هذا [مشروع Overleaf الأكبر](https://www.overleaf.com/project/new/template/25521?id=107987258\&templateName=Demonstrating+various+types+of+LaTeX+list\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=) الذي يوضح أنواعًا مختلفة من القوائم في LaTeX. ### القوائم المرتبة تستخدم القوائم المرتبة نفس البنية النحوية للقوائم غير المرتبة ولكن يتم إنشاؤها باستخدام `enumerate` البيئة: ```latex \documentclass{article} \begin{document} \begin{enumerate} \item هذا هو الإدخال الأول في قائمتنا. \item تزداد أرقام القائمة مع كل إدخال نضيفه. \end{enumerate} \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+the+enumerate+environment\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Benumerate%7D%0A++%5Citem+This+is+the+first+entry+in+our+list.%0A++%5Citem+The+list+numbers+increase+with+each+entry+we+add.%0A%5Cend%7Benumerate%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![مثال على قائمة مرقمة مُنتَجة في LaTeX](/files/e32523e2017be8e202dfdc978297c85c70c7aec6) وكما في `غير المرتبة` القوائم، يجب أن يسبق كل إدخال `\item` الأمر الذي يولد هنا تلقائيًا قيمة تسمية القائمة المرتبة الرقمية، بدءًا من 1. لمزيد من المعلومات يمكنك فتح هذا [مشروع Overleaf الأكبر](https://www.overleaf.com/project/new/template/25521?id=107987258\&templateName=Demonstrating+various+types+of+LaTeX+list\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=) الذي يوضح أنواعًا مختلفة من القوائم في LaTeX أو زيارة [مقالة المساعدة الخاصة بنا حول قوائم LaTeX](/latex/ar/asasyat-latex/04-lists.md)، والتي توفر أمثلة أكثر بكثير وتوضح كيفية إنشاء قوائم مخصصة. ## إضافة الرياضيات إلى LaTeX إحدى المزايا الرئيسية لـ LaTeX هي السهولة التي يمكن بها كتابة التعبيرات الرياضية. يوفر LaTeX نمطي كتابة لتنضيد الرياضيات: * *السطرية* نمط رياضي يُستخدم لكتابة صيغ تكون جزءًا من فقرة * *العرضية* نمط رياضي يُستخدم لكتابة تعبيرات ليست جزءًا من نص أو فقرة وتُنضَّد في أسطر منفصلة ### وضع الرياضيات ضمن السطر لنرَ مثالًا على النمط الرياضي المضمن: ```latex \documentclass[12pt, letterpaper]{article} \begin{document} في الفيزياء، يُعبَّر عن تكافؤ الكتلة والطاقة بالمعادلة $E=mc^2$، التي اكتشفها ألبرت أينشتاين عام 1905. \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Inline+LaTeX+maths+example\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIn+physics%2C+the+mass-energy+equivalence+is+stated+%0Aby+the+equation+%24E%3Dmc%5E2%24%2C+discovered+in+1905+by+Albert+Einstein.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر رياضيات منضدة في النمط الرياضي المضمن](/files/095d83905f5e875d2a377fd8785086c7b87482ec) لتنضيد رياضيات النمط المضمن يمكنك استخدام أحد زوجي الفواصل التاليين: `\( ... \)`, `$ ... $` أو `\begin{math} ... \end{math}`، كما هو موضح في المثال التالي: ```latex \documentclass[12pt, letterpaper]{article} \begin{document} \begin{math} E=mc^2 \end{math} يُنضَّد داخل فقرة باستخدام النمط الرياضي المضمن—وكما هو الحال مع $E=mc^2$، وكذلك \(E=mc^2\). \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Demonstrating+inline+math+mode\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmath%7D%0AE%3Dmc%5E2%0A%5Cend%7Bmath%7D+is+typeset+in+a+paragraph+using+inline+math+mode---as+is+%24E%3Dmc%5E2%24%2C+and+so+too+is+%5C%28E%3Dmc%5E2%5C%29.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة توضح محتوى مُنتج باستخدام النمط الرياضي المضمن في LaTeX](/files/7d557687005a23274bb55360730310c3238f95f4) ### وضع الرياضيات المعروض يمكن أن تكون المعادلات المنضدة في وضع العرض مرقمة أو غير مرقمة، كما في المثال التالي: ```latex \documentclass[12pt, letterpaper]{article} \begin{document} يُوصف تكافؤ الكتلة والطاقة بالمعادلة الشهيرة \[ E=mc^2 \] اكتشفها ألبرت أينشتاين عام 1905. في الوحدات الطبيعية ($c = 1$)، تصوغ الصيغة الهوية \begin{equation} E=m \end{equation} \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Display+math+mode+example\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AThe+mass-energy+equivalence+is+described+by+the+famous+equation%0A%5C%5B+E%3Dmc%5E2+%5C%5D+discovered+in+1905+by+Albert+Einstein.+%0A%0AIn+natural+units+%28%24c+%3D+1%24%29%2C+the+formula+expresses+the+identity%0A%5Cbegin%7Bequation%7D%0AE%3Dm%0A%5Cend%7Bequation%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر الرياضيات بنمط العرض في LaTeX](/files/bfeba1d546307a033b708e3b0e234e0df46c99de) لتنضيد رياضيات نمط العرض يمكنك استخدام أحد زوجي الفواصل التاليين: `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` أو `\begin{equation} ... \end{equation}`. تاريخيًا، كان تنضيد رياضيات نمط العرض يتطلب استخدام `$$` فواصل الأحرف، كما في `$$ *... display math here ...*$$`، لكن هذه الطريقة [لم تعد موصى بها](https://texfaq.org/FAQ-dolldoll): استخدم فواصل LaTeX `\[ ... \]` بدلًا من ذلك. ### أمثلة أكثر اكتمالًا توضح الأمثلة التالية مجموعة من أنواع المحتوى الرياضي المنضَّد باستخدام LaTeX. ```latex \documentclass{article} \begin{document} تُكتب الرموز السفلية في النمط الرياضي على شكل $a_b$، وتُكتب الرموز العلوية على شكل $a^b$. ويمكن دمجها وتداخلها لكتابة تعبيرات مثل \[ T^{i_1 i_2 \dots i_p}_{j_1 j_2 \dots j_q} = T(x^{i_1},\dots,x^{i_p},e_{j_1},\dots,e_{j_q}) \] نكتب التكاملات باستخدام $\int$ والكسور باستخدام $\frac{a}{b}$. وتوضع الحدود على التكاملات باستخدام الرموز العلوية والسفلية: \[ \int_0^1 \frac{dx}{e^x} = \frac{e-1}{e} \] تُكتب الحروف اليونانية الصغيرة على شكل $\omega$ $\delta$ وما إلى ذلك، بينما تُكتب الحروف اليونانية الكبيرة على شكل $\Omega$ $\Delta$. تُسبق العوامل الرياضية بشرطة مائلة عكسية، مثل $\sin(\beta)$ و$\cos(\alpha)$ و$\log(x)$ وما إلى ذلك. \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+advanced+LaTeX+math+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASubscripts+in+math+mode+are+written+as+%24a_b%24+and+superscripts+are+written+as+%24a%5Eb%24.+These+can+be+combined+and+nested+to+write+expressions+such+as%0A%0A%5C%5B+T%5E%7Bi_1+i_2+%5Cdots+i_p%7D_%7Bj_1+j_2+%5Cdots+j_q%7D+%3D+T%28x%5E%7Bi_1%7D%2C%5Cdots%2Cx%5E%7Bi_p%7D%2Ce_%7Bj_1%7D%2C%5Cdots%2Ce_%7Bj_q%7D%29+%5C%5D%0A+%0AWe+write+integrals+using+%24%5Cint%24+and+fractions+using+%24%5Cfrac%7Ba%7D%7Bb%7D%24.+Limits+are+placed+on+integrals+using+superscripts+and+subscripts%3A%0A%0A%5C%5B+%5Cint_0%5E1+%5Cfrac%7Bdx%7D%7Be%5Ex%7D+%3D++%5Cfrac%7Be-1%7D%7Be%7D+%5C%5D%0A%0ALower+case+Greek+letters+are+written+as+%24%5Comega%24+%24%5Cdelta%24+etc.+while+upper+case+Greek+letters+are+written+as+%24%5COmega%24+%24%5CDelta%24.%0A%0AMathematical+operators+are+prefixed+with+a+backslash+as+%24%5Csin%28%5Cbeta%29%24%2C+%24%5Ccos%28%5Calpha%29%24%2C+%24%5Clog%28x%29%24+etc.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر مجموعة من المعادلات الرياضية المنضدة في LaTeX](/files/836f34c730c59b317aae07ccfcfc715ef356535e) يستخدم المثال التالي `equation*` البيئة التي توفرها الـ `amsmath` الحزمة، لذا نحتاج إلى إضافة السطر التالي إلى الجزء التمهيدي من مستندنا: ```latex \usepackage{amsmath}% من أجل البيئة equation* ``` لمزيد من المعلومات حول استخدام `amsmath` انظر [مقالة المساعدة لدينا](/latex/ar/alryadhyat/06-aligning-equations-with-amsmath.md). ```latex \documentclass{article} \usepackage{amsmath}% من أجل البيئة equation* \begin{document} \section{First example} ثبت أن مبرهنة فيثاغورس الشهيرة \(x^2 + y^2 = z^2\) غير صحيحة للأسس الأخرى، مما يعني أن المعادلة التالية لا تملك حلولًا صحيحة لـ \(n>2\): \[ x^n + y^n = z^n \] \section{Second example} هذا تعبير رياضي بسيط \(\sqrt{x^2+1}\) داخل النص. وهذا هو نفسه أيضًا: \begin{math} \sqrt{x^2+1} \end{math} ولكن باستخدام أمر آخر. هذا تعبير رياضي بسيط من دون ترقيم \[\sqrt{x^2+1}\] منفصلًا عن النص. وهذا هو نفسه أيضًا: \begin{displaymath} \sqrt{x^2+1} \end{displaymath} \ldots وهذا: \begin{equation*} \sqrt{x^2+1} \end{equation*} \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+math+content+typeset+in+LaTeX\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamsmath%7D%25+For+the+equation%2A+environment%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BFirst+example%7D%0A%0AThe+well-known+Pythagorean+theorem+%5C%28x%5E2+%2B+y%5E2+%3D+z%5E2%5C%29+was+proved+to+be+invalid+for+other+exponents%2C+meaning+the+next+equation+has+no+integer+solutions+for+%5C%28n%3E2%5C%29%3A%0A%0A%5C%5B+x%5En+%2B+y%5En+%3D+z%5En+%5C%5D%0A%0A%5Csection%7BSecond+example%7D%0A%0AThis+is+a+simple+math+expression+%5C%28%5Csqrt%7Bx%5E2%2B1%7D%5C%29+inside+text.+%0AAnd+this+is+also+the+same%3A+%0A%5Cbegin%7Bmath%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bmath%7D%0Abut+by+using+another+command.%0A%0AThis+is+a+simple+math+expression+without+numbering%0A%5C%5B%5Csqrt%7Bx%5E2%2B1%7D%5C%5D+%0Aseparated+from+text.%0A%0AThis+is+also+the+same%3A%0A%5Cbegin%7Bdisplaymath%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bdisplaymath%7D%0A%0A%5Cldots+and+this%3A%0A%5Cbegin%7Bequation%2A%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bequation%2A%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر مجموعة من المعادلات الرياضية المنضدة في LaTeX](/files/d7328a5e3de60a7178431b015a54edcd849da4b7) إن الإمكانات المتعلقة بالرياضيات في LaTeX لا تنتهي، لذا تأكد من زيارة صفحات المساعدة لدينا للحصول على نصائح وأمثلة حول موضوعات محددة: * [التعابير الرياضية](/latex/ar/alryadhyat/01-mathematical-expressions.md) * [الأسس السفلية والعليا](/latex/ar/alryadhyat/02-subscripts-and-superscripts.md) * [الأقواس والقوسان](/latex/ar/alryadhyat/03-brackets-and-parentheses.md) * [الكسور والحدود الثنائية](/latex/ar/alryadhyat/05-fractions-and-binomials.md) * [محاذاة المعادلات](/latex/ar/alryadhyat/06-aligning-equations-with-amsmath.md) * [المؤثرات](/latex/ar/alryadhyat/07-operators.md) * [التباعد في وضع الرياضيات](/latex/ar/alryadhyat/08-spacing-in-math-mode.md) * [التكاملات، والمجاميع، والحدود](/latex/ar/alryadhyat/09-integrals-sums-and-limits.md) * [النمط المعروض في وضع الرياضيات](/latex/ar/alryadhyat/10-display-style-in-math-mode.md) * [قائمة الحروف اليونانية والرموز الرياضية](/latex/ar/alryadhyat/11-list-of-greek-letters-and-math-symbols.md) * [الخطوط الرياضية](/latex/ar/alryadhyat/12-mathematical-fonts.md) ## البنية الأساسية للمستند بعد ذلك، نستكشف الملخصات وكيفية تقسيم مستند LaTeX إلى فصول وأقسام وفقرات مختلفة. ### الملخصات تقدم المقالات العلمية عادةً *abstract* وهو لمحة موجزة/ملخصًا لموضوعاتها الأساسية أو حججها. يوضح المثال التالي تنضيد ملخص باستخدام `abstract` البيئة: ```latex \documentclass{article} \begin{document} \begin{abstract} هذه فقرة بسيطة في بداية المستند. مقدمة موجزة عن الموضوع الرئيسي. \end{abstract} \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=How+to+create+a+document+abstract\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Babstract%7D%0AThis+is+a+simple+paragraph+at+the+beginning+of+the+%0Adocument.+A+brief+introduction+about+the+main+subject.%0A%5Cend%7Babstract%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر ملخصًا منضدًا في LaTeX](/files/00ba7434cd45f1e6af200a66e1ce505f27df1aa2) ### الفقرات والأسطر الجديدة بعد وضع الملخص، يمكننا البدء بكتابة فقرتنا الأولى. يوضح المثال التالي: * كيف تُنشأ فقرة جديدة بالضغط على مفتاح "enter" مرتين، مما ينهي السطر الحالي ويُدرج سطرًا فارغًا لاحقًا؛ * كيف تبدأ سطرًا جديدًا من دون بدء فقرة جديدة بإدراج فاصل أسطر يدوي باستخدام `\\` الأمر، وهو شرطة مائلة عكسية مزدوجة؛ أو بديلًا استخدم `\newline` الأمر. توضح الفقرة الثالثة في هذا المثال استخدام الأوامر `\\` و `\newline`: ```latex \documentclass{article} \begin{document} \begin{abstract} هذه فقرة بسيطة في بداية المستند. مقدمة موجزة عن الموضوع الرئيسي. \end{abstract} بعد ملخصنا يمكننا البدء بالفقرة الأولى، ثم نضغط «enter» مرتين لبدء الثانية. سيبدأ هذا السطر فقرة ثانية. سأبدأ الفقرة الثالثة ثم أضيف \\ فاصل سطر يدويًا مما يجعل هذا النص يبدأ في سطر جديد ولكنه يظل جزءًا من الفقرة نفسها. وبديلًا عن ذلك، يمكنني استخدام الأمر \verb|\newline|\newline لبدء سطر جديد، وهو أيضًا جزء من الفقرة نفسها. \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+to+create+a+new+paragraph\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Babstract%7D%0AThis+is+a+simple+paragraph+at+the+beginning+of+the+%0Adocument.+A+brief+introduction+about+the+main+subject.%0A%5Cend%7Babstract%7D%0A%0AAfter+our+abstract+we+can+begin+the+first+paragraph%2C+then+press+%60%60enter%27%27+twice+to+start+the+second+one.%0A%0AThis+line+will+start+a+second+paragraph.%0A%0AI+will+start+the+third+paragraph+and+then+add+%5C%5C+a+manual+line+break+which+causes+this+text+to+start+on+a+new+line+but+remains+part+of+the+same+paragraph.+Alternatively%2C+I+can+use+the+%5Cverb%7C%5Cnewline%7C%5Cnewline+command+to+start+a+new+line%2C+which+is+also+part+of+the+same+paragraph.%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر إنشاء الفقرات في LaTeX](/files/d5f463d7a9e88ca602b813e7d8ab96df30f9fbd2) لاحظ كيف يقوم LaTeX تلقائيًا بعمل مسافة بادئة للفقرات—باستثناء ما يلي مباشرةً عناوين المستند مثل section وsubsection—[كما سنرى](#chapters-and-sections). يُنصح المستخدمون الجدد بأن عدة `\\` أو `\newline`s لا ينبغي استخدامها لـ«محاكاة» الفقرات مع مسافة أكبر بينها لأن ذلك قد يتداخل مع خوارزميات التنضيد في LaTeX. والطريقة الموصى بها هي الاستمرار في استخدام الأسطر الفارغة لإنشاء فقرات جديدة، دون أي `\\`، وتحميل [`parskip` الحزمة](https://ctan.org/pkg/parskip?lang=en) عن طريق إضافة `\usepackage{parskip}` إلى المقدمة. يمكن العثور على مزيد من المعلومات حول الفقرات في المقالات التالية: * [الفقرات والأسطر الجديدة](/latex/ar/asasyat-latex/02-paragraphs-and-new-lines.md) * [كيفية تغيير تباعد الفقرات في LaTeX](/latex/ar/altnsyq/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [خطأ LaTeX: لا يوجد سطر هنا لإنهائه](/latex/ar/akhtaa-latex/18-latex-error-there-s-no-line-here-to-end.md) يوفر نصائح وإرشادات إضافية حول استخدام `\\`. ### الفصول والأقسام عادةً ما تُقسَّم المستندات الأطول، بغض النظر عن برنامج التأليف، إلى أجزاء وفصول وأقسام وأقسام فرعية وما إلى ذلك. ويوفر LaTeX أيضًا أوامر لبنية المستند، لكن الأوامر المتاحة وتنفيذها (ما الذي تفعله) قد يعتمدان على فئة المستند المستخدمة. على سبيل المثال، يمكن تقسيم المستندات المنشأة باستخدام `book` يمكن تقسيم المستندات المنشأة باستخدام فئة الكتاب إلى أجزاء وفصول وأقسام وأقسام فرعية وما إلى ذلك، لكن فئة `الرسائل` لا توفر أي أوامر للقيام بذلك. يوضح المثال التالي الأوامر المستخدمة لتنظيم مستند يعتمد على فئة `book` : ```latex \documentclass{book} \begin{document} \chapter{الفصل الأول} \section{Introduction} هذا هو القسم الأول. لوريم إيبسوم دولور سيت أميت، كونسكتيتور أديبيسكنغ إليت. حتى لو تبسيس القواعد. نولام نيك مي إت نيك فاريترا سولاتيسيتودين. برزنت إمبيردييت مي نيك أنت. دونك أوملّسوربر، فيليس غير سوداليس... \section{القسم الثاني} لوريم إيبسوم دولور سيت أميت، كونسكتيتور أديبيسكنغ إليت. إتيام لوبورتيس فيسلييسيس سم. نولام نيك مي إت نيكه فياريترا سولاتيسيتودين. برزنت إمبيردييت مي نيك أنت... \subsection{القسم الفرعي الأول} برزنت إمبيردييت مي نيك أنت. دونك أوملّسوربر، فيليس غير سوداليس... \section*{قسم غير مرقم} لوريم إيبسوم دولور سيت أميت، كونسكتيتور أديبيسكنغ إليت. إتيام لوبورتيس فيسلييسيس سم... \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Book+class+example+document\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0A%5Csection%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0ALorem++ipsum++dolor++sit++amet%2C++consectetuer++adipiscing++%0Aelit.+Etiam++lobortisfacilisis+sem.++Nullam+nec+mi+et+%0Aneque+pharetra+sollicitudin.++Praesent+imperdietmi+nec+ante.+%0ADonec+ullamcorper%2C+felis+non+sodales...%0A%0A%5Csection%7BSecond+Section%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%0A%5Csubsection%7BFirst+Subsection%7D%0APraesent+imperdietmi+nec+ante.+Donec+ullamcorper%2C+felis+non+sodales...%0A%0A%5Csection%2A%7BUnnumbered+Section%7D%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem...%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر الأقسام في مستند كتاب LaTeX](/files/d78f2f6bf34540bc5b7941c8cae9ec57849671bd) أسماء أوامر التقسيم توضيحية في الغالب؛ على سبيل المثال `\chapter{الفصل الأول}` ينشئ فصلًا جديدًا بعنوان `الفصل الأول`, `\section{Introduction}` ينتج قسمًا بعنوان `مقدمة`، وهكذا. ويمكن تقسيم الأقسام بشكلٍ إضافي إلى `\subsection{...}` وحتى `\subsubsection{...}`. الترقيم للأقسام والأقسام الفرعية وما إلى ذلك يتم تلقائيًا، ولكن يمكن تعطيله باستخدام ما يُسمّى *النسخة ذات النجمة* من الأمر المناسب الذي ينتهي بنجمة (\*)، مثل `\section*{...}` و `\subsection*{...}`. *بشكلٍ جماعي*، توفر فئات مستندات LaTeX أوامر التقسيم التالية، مع دعم فئات محددة لمجموعة فرعية ذات صلة منها: * `\part{الجزء}` * `\chapter{الفصل}` * `\section{القسم}` * `\subsection{القسم الفرعي}` * `\subsubsection{القسم الفرعي الفرعي}` * `\paragraph{فقرة}` * `\subparagraph{فقرة فرعية}` على وجه الخصوص، تتوفر `\part` و `\chapter` أوامر `التقرير` و `book` فقط في فئات المستند. تفضّل بزيارة مقال Overleaf [حول الأقسام والفصول](/latex/ar/bnyh-almstnd/01-sections-and-chapters.md) لمزيد من المعلومات حول أوامر بنية المستند. ## إنشاء الجداول يوفر Overleaf ثلاثة خيارات لإنشاء الجداول: 1. باستخدام [**إدراج جدول** الزر](/latex/ar/qaadh-almarfh/067-how-to-generate-and-insert-latex-tables-in-overleaf.md#inserttable) في **المحرر المرئي** (أو **محرر الكود**) شريط الأدوات. 2. [نسخ جدول ولصقه](/latex/ar/qaadh-almarfh/075-how-to-paste-formatted-content-into-overleaf.md#pastingtables) من مستند آخر أثناء استخدام **المحرر المرئي**. 3. كتابة كود LaTeX للجدول في محرر الكود. إذا كنت جديدًا على LaTeX، فإن استخدام شريط الأدوات في **المحرر المرئي** (الخيار 1) طريقة رائعة للبدء—يمكنك التبديل بين **المحرر المرئي** و **محرر الكود** لرؤية الكود وراء الجدول. هنا نركز على الخيار 3—وهو الطريقة الأكثر مرونة لإنشاء الجداول—ونقدم أمثلة توضح كيفية إنشاء الجداول في LaTeX، بما في ذلك إضافة الخطوط (القواعد) والتعليقات التوضيحية. ومع اكتسابك الخبرة، ألقِ نظرة على إرشاداتنا التفصيلية حول [كيفية إنشاء الجداول باستخدام LaTeX](/latex/ar/alashkal-waljdawl/01-tables.md). ### إنشاء جدول أساسي في LaTeX نبدأ بمثال يوضح كيفية تنضيد جدول أساسي: ```latex \begin{center} \begin{tabular}{c c c} cell1 & cell2 & cell3 \\ cell4 & cell5 & cell6 \\ الخلية7 & الخلية8 & الخلية9 \end{tabular} \end{center} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=An+example+of+a+basic+table\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7Bc+c+c%7D%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C++%0A+cell7+%26+cell8+%26+cell9++++%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D%0A%3C%2Fsource%3E) ينتج هذا المثال المخرجات التالية: ![صورة تعرض جدولًا منضدًا في LaTeX](/files/dc30063c1f487c0f3bd349e83b7ea15bd1b29d1f) ال `tabular` هي الطريقة الافتراضية في LaTeX لإنشاء الجداول. يجب عليك تحديد معامل لهذه البيئة، في هذه الحالة `{c c c}` والذي يخبر LaTeX بأن هناك ثلاثة أعمدة وأن النص داخل كل واحد منها يجب أن يكون في الوسط. يمكنك أيضًا استخدام `r` لمحاذاة النص إلى اليمين و `l` لمحاذاته إلى اليسار. يُستخدم رمز المحاذاة `&` للفصل بين خلايا الجدول الفردية داخل صف الجدول. ولإنهاء صف جدول استخدم *سطرًا جديدًا* الأمر `\\`. يحتوي جدولنا داخل `center` بيئة لجعله في الوسط ضمن عرض النص في الصفحة. ### إضافة الحدود ال `tabular` تدعم البيئة الخطوط الأفقية والعمودية (القواعد) كجزء من الجدول: * لإضافة قواعد أفقية، فوق الصفوف وتحتها، استخدم `\hline` الأمر * لإضافة قواعد عمودية، بين الأعمدة، استخدم معامل الخط العمودي `|` في هذا المثال، الوسيط هو `{|c|c|c|}` والذي يعلن عن ثلاثة أعمدة (مُوسَّطة) يفصل بينها خط عمودي (قاعدة)؛ بالإضافة إلى ذلك، نستخدم `\hline` لوضع قاعدة أفقية فوق الصف الأول وتحت الصف الأخير: ```latex \begin{center} \begin{tabular}{|c|c|c|} \hline cell1 & cell2 & cell3 \\ cell4 & cell5 & cell6 \\ cell7 & cell8 & cell9 \\ \hline \end{tabular} \end{center} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+example+with+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B%7Cc%7Cc%7Cc%7C%7D+%0A+%5Chline%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C+%0A+cell7+%26+cell8+%26+cell9+%5C%5C+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تعرض جدولًا منضدًا في LaTeX يحتوي على قواعد أفقية وعمودية](/files/406676066bc6ef7d1e7ae7f9f1d76102fc407328) فيما يلي مثال آخر: ```latex \begin{center} \begin{tabular}{||c c c c||} \hline العمود1 & العمود2 & العمود2 & العمود3 \\ [0.5ex] \hline\hline 1 & 6 & 87837 & 787 \\ \hline 2 & 7 & 78 & 5415 \\ \hline 3 & 545 & 778 & 7507 \\ \hline 4 & 545 & 18744 & 7560 \\ \hline 5 & 88 & 788 & 6344 \\ [1ex] \hline \end{tabular} \end{center} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Another+table+example+containing+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A+%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+%5Chline%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+%5Chline%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+%5Chline%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+%5Chline%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تعرض جدولًا منضدًا في LaTeX يحتوي على قواعد أفقية وعمودية](/files/04b556e9b5876d83f26fc0c6abffc28cc72696f1) ### التسميات التوضيحية والعلامات والمراجع يمكنك إضافة تعليق توضيحي إلى الجداول والرجوع إليها بالطريقة نفسها تقريبًا مثل الصور. الاختلاف الوحيد هو أنه بدلًا من **`figure`** بيئة **`table`** البيئة. ```latex يوضح الجدول \ref{table:data} كيفية إضافة تعليق توضيحي لجدول والإشارة إلى جدول. \begin{table}[h!] \centering \begin{tabular}{||c c c c||} \hline العمود1 & العمود2 & العمود2 & العمود3 \\ [0.5ex] \hline\hline 1 & 6 & 87837 & 787 \\ 2 & 7 & 78 & 5415 \\ 3 & 545 & 778 & 7507 \\ 4 & 545 & 18744 & 7560 \\ 5 & 88 & 788 & 6344 \\ [1ex] \hline \end{tabular} \caption{جدول لاختبار العناوين والتسميات.} \label{table:data} \end{table} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+captions+and+references\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ATable+%5Cref%7Btable%3Adata%7D+shows+how+to+add+a+table+caption+and+reference+a+table.%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BTable+to+test+captions+and+labels.%7D%0A%5Clabel%7Btable%3Adata%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![جدول LaTeX مع تعليق توضيحي](/files/666184c41f9f510c7dbcceb3b93b3afc9371ce0e) ## إضافة فهرس المحتويات إنشاء فهرس المحتويات أمرٌ مباشر لأن الأمر `\tableofcontents` يقوم بمعظم العمل نيابةً عنك: ```latex \documentclass{article} \title{الأقسام والفصول} \author{Gubert Farnsworth} \date{August 2022} \begin{document} \maketitle \tableofcontents \section{Introduction} هذا هو القسم الأول. لوريم إيبسوم دولور سيت أميت، كونسكتيتور أديبيسكنغ إليت. إتيام لوبورتيس فيسلييسيس سم. نولام نيك مي إت نيك فاريترا سولاتيسيتودين. برزنت إمبيردييت مي نيك أنت. دونك أوملّسوربر، فيليس غير سوداليس... \section*{قسم غير مرقم} \addcontentsline{toc}{section}{قسم غير مرقم} لوريم إيبسوم دولور سيت أميت، كونسكتيتور أديبيسكنغ إليت. إتيام لوبورتيس فيسلييسيس سم. نولام نيك مي إت نيكه فياريترا سولاتيسيتودين. برزنت إمبيردييت مي نيك أنت... \section{القسم الثاني} لوريم إيبسوم دولور سيت أميت، كونسكتيتور أديبيسكنغ إليت. إتيام لوبورتيس فيسلييسيس سم. نولام نيك مي إت نيكه فياريترا سولاتيسيتودين. برزنت إمبيردييت مي نيك أنت... \end{document} ``` [افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Generating+a+table+of+contents\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BGubert+Farnsworth%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A++%0A%5Cmaketitle%0A++%0A%5Ctableofcontents%0A%0A%5Csection%7BIntroduction%7D%0A+++%0AThis+is+the+first+section.%0A++++++%0ALorem++ipsum++dolor++sit++amet%2C++consectetuer++adipiscing++%0Aelit.+++Etiam++lobortisfacilisis+sem.++Nullam+nec+mi+et+%0Aneque+pharetra+sollicitudin.++Praesent+imperdietmi+nec+ante.+%0ADonec+ullamcorper%2C+felis+non+sodales...%0A+++++++%0A%5Csection%2A%7BUnnumbered+Section%7D%0A%5Caddcontentsline%7Btoc%7D%7Bsection%7D%7BUnnumbered+Section%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%0A%5Csection%7BSecond+Section%7D%0A+++++++%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر فهرس محتويات أنتجه LaTeX](/files/eab44ae47b8f2e81f1db3efeb2c01473fd98b680) تُدرج الأقسام والأقسام الفرعية والفصول تلقائيًا في فهرس المحتويات. ولإضافة إدخالات يدويًا، مثل قسم غير مرقم، استخدم الأمر `\addcontentsline` كما هو موضح في المثال. ## تنزيل المستند النهائي يُظهر مقطع الفيديو القصير التالي كيفية تنزيل شفرة المصدر لمشروعك أو ملف PDF المنضد: {% embed url="" %} يمكن العثور على مزيد من المعلومات في مقال المساعدة على Overleaf [تصدير عملك من Overleaf](/latex/ar/qaadh-almarfh/036-exporting-your-work-from-overleaf.md). ## العثور على حزم LaTeX واستخدامها لا يقتصر LaTeX على تقديم قدرات تنضيد مهمة فحسب، بل يوفر أيضًا *إطارًا قابلًا للتوسعة* من خلال استخدام *الحزم*الإضافات. وبدلًا من محاولة توفير أوامر وميزات «تحاول فعل كل شيء»، صُمم LaTeX ليكون *قابلًا للتوسعة*، مما يسمح للمستخدمين بتحميل أجسام خارجية من الشفرة (حزم) توفر قدرات تنضيد أكثر تخصصًا أو توسع الميزات المدمجة في LaTeX—مثل تنضيد الجداول. كما لوحظ في القسم [إضافة الصور](#adding-images)، و `graphicx` توسّع الحزمة LaTeX من خلال توفير أوامر لاستيراد ملفات الرسوميات وقد تم تحميلها (في المقدمة) بكتابة ```latex \usepackage{graphicx} ``` ### تحميل الحزم كما ذُكر أعلاه، يتم تحميل الحزم في مقدمة المستند عبر الأمر `\usepackage` ولكن لأن (العديد من) حزم LaTeX توفر مجموعة من *الخيارات*، والتي يمكن استخدامها لتكوين سلوكها، فإن الأمر `\usepackage` غالبًا ما يبدو بهذا الشكل: ```latex \usepackage[options]{somepackage} ``` الأقواس المربعة «`[...]`» تُخبر LaTeX بمجموعة الخيارات التي يجب تطبيقها عند تحميله `somepackage`، وضمن مجموعة الخيارات المطلوبة من المستخدم، عادةً ما تُفصل الخيارات أو الإعدادات الفردية بفاصلة؛ فمثلًا، توفر الحزمة [`geometry` الحزمة](https://ctan.org/pkg/geometry) العديد من الخيارات لتكوين تخطيط الصفحة في LaTeX، لذا فإن الاستخدام المعتاد لـ `geometry` قد يبدو هكذا: ```latex \usepackage[total={6.5in,8.75in}, top=1.2in, left=0.9in, includefoot]{geometry} ``` ال `geometry` مثالًا على حزمة كتبها وساهم بها أعضاء مجتمع LaTeX العالمي، وجُعلت متاحة مجانًا لكل من يريد استخدامها. إذا كانت حزمة LaTeX لا توفر أي خيارات، أو إذا أراد المستخدم استخدام القيم الافتراضية لخيارات الحزمة، فسيتم تحميلها هكذا: ```latex \usepackage{somepackage} ``` عندما تكتب `\usepackage[...]{somepackage}` يبحث LaTeX عن ملف مطابق يُسمّى `*somepackage*.sty`، والذي يحتاج إلى تحميله ومعالجته—لإتاحة أوامر الحزمة وتنفيذ أي شيفرة أخرى توفرها تلك الحزمة. إذا تعذّر على LaTeX العثور على `*somepackage*.sty` فسيُنهي العمل مع رسالة خطأ، كما هو موضح في مثال Overleaf التالي: ```latex \documentclass[12pt, letterpaper]{article} \usepackage{somepackage}% حزمة غير موجودة \begin{document} سيَفشل هذا! \end{document} ``` [افتح هذا ***مثال يولّد خطأ*** على Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Error+due+to+missing+package\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cusepackage%7Bsomepackage%7D%25+a+NON-EXISTENT+package%0A%5Cbegin%7Bdocument%7D%0AThis+will+fail%21%0A%5Cend%7Bdocument%7D) ينتج هذا المثال المخرجات التالية: ![صورة تُظهر أخطاء ناتجة عن حزمة مفقودة](/files/48cf4158b69da88a41e56175712cb8749c7872dd) ### العثور على معلومات حول الحزم: CTAN تُوزَّع الحزم عبر [شبكة أرشيف TeX الشاملة](https://www.ctan.org/)، ويشار إليها عادةً باسم CTAN، والتي تستضيف وقت كتابة هذا النص 6287 حزمة من 2881 مساهمًا. وتصف CTAN [نفسها بأنها](https://www.ctan.org/ctan) as > ... مجموعة من مواقع الإنترنت حول العالم التي تتيح مواد متعلقة بـ TEX للتنزيل. يمكنك تصفح CTAN للبحث عن حزم مفيدة؛ على سبيل المثال: * [حسب الموضوع](https://www.ctan.org/topics/cloud) * [أبجديًا](https://www.ctan.org/pkg) (مفيد إذا كنت تعرف اسم الحزمة) يمكنك أيضًا استخدام [ميزة البحث](https://www.ctan.org/pkg) (في أعلى الصفحة). ### الحزم المتاحة على Overleaf: تقديم TeX Live مرة واحدة في السنة، تُجمَّع *مجموعة فرعية* من الحزم المستضافة على CTAN، بالإضافة إلى الخطوط والبرامج الأخرى المتعلقة بـ LaTeX، ويُوزَّع كنظام يُسمّى [TeX Live](https://tug.org/texlive/)، والذي يمكن استخدامه لتثبيت إعداد LaTeX (محلي) خاص بك. في الواقع، [تستخدم خوادم Overleaf أيضًا TeX Live](/latex/ar/mlfat-alfeh/02-overleaf-and-tex-live.md) وتُحدَّث عند إصدار نسخة جديدة من TeX Live. لا تكون تحديثات TeX Live على Overleaf فورية، بل تحدث بعد بضعة أشهر من الإصدار، مما يمنحنا وقتًا لإجراء اختبارات التوافق لنسخة TeX Live الجديدة مع [آلاف القوالب الموجودة في معرضنا](https://www.overleaf.com/gallery). على سبيل المثال، إليك [إعلان ترقية TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available). على الرغم من أن TeX Live يحتوي على (عدد كبير من) *مجموعة فرعية* حزم CTAN، فمن الممكن العثور على حزمة مثيرة للاهتمام مثل [`igo` لتنضيد مخططات Go](https://ctan.org/pkg/igo?lang=en)، وهي مستضافة على CTAN ولكنها غير مضمنة في TeX Live (غير موزعة معه)، وبالتالي غير متاحة على Overleaf. بعض الحزم المستضافة على CTAN ليست جزءًا من TeX Live لأسباب متعددة: ربما تكون الحزمة قديمة، أو لديها مشاكل في الترخيص، أو جديدة جدًا (تم رفعها مؤخرًا)، أو لديها تبعيات على المنصة، مثل العمل على Windows ولكن ليس Linux. تُرفع الحزم الجديدة والتحديثات إلى الحزم الموجودة بالفعل إلى CTAN طوال العام، ولكن تحديثات TeX Live تُوزَّع سنويًا؛ لذلك فإن الحزم الموجودة في الإصدار الحالي من TeX Live لن تكون محدثة بقدر الحزم المستضافة على CTAN. ولأن خوادم Overleaf تستخدم TeX Live، فمن الممكن أن الحزم المثبتة على خوادمنا—أي المتاحة لمستخدمينا—قد لا تكون أحدث الإصدارات المتاحة على CTAN، لكن عمومًا من غير المرجح أن يسبب ذلك مشكلة. --- # 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/asasyat-latex/01-learn-latex-in-30-minutes.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.