> 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/texlive/ar/asasyat-latex/tal-m-latex-fy-30-dqyqh.md).

# تعلّم LaTeX في 30 دقيقة

> **جديد:** زُر [مركز تعلم Overleaf](https://learn.overleaf.com/) لاستكشاف دورات مجانية عبر الإنترنت وندوات مباشرة — كل ما تحتاجه لإتقان LaTeX والاستفادة القصوى من Overleaf.

هذا الدرس التعريفي لا يفترض أي خبرة سابقة بـ LaTeX، لكن، نأمل، بحلول الوقت الذي تنتهي فيه، لن تكون قد كتبت أول مستند LaTeX فحسب، بل ستكتسب أيضًا المعرفة والثقة الكافيتين لاتخاذ الخطوات التالية نحو إتقان LaTeX.

## ما هو LaTeX؟

LaTeX (يُنطق «*لاي*-tek» أو «*لاه*-tek») هو أداة لتنسيق المستندات بمظهر احترافي. ومع ذلك، فإن طريقة عمل LaTeX تختلف كثيرًا عن العديد من تطبيقات إنتاج المستندات الأخرى التي قد تكون استخدمتها، مثل Microsoft Word أو LibreOffice Writer: فهذه الأدوات «[WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG)» توفّر للمستخدمين صفحة تفاعلية يكتبون فيها نصوصهم ويحررونها ويطبقون عليها أشكالًا مختلفة من التنسيق. أما LaTeX فيعمل بطريقة مختلفة جدًا: فبدلًا من ذلك، يكون مستندك ملفًا نصيًا عاديًا تتخلله أوامر LaTeX *الأوامر* المستخدمة للتعبير عن النتائج المطلوبة (المنسقة). ولإنتاج مستند مرئي ومنسق، تتم معالجة ملف LaTeX الخاص بك بواسطة برنامج يُسمى *محرك TeX* ، والذي يستخدم الأوامر المضمّنة في ملفك النصي لتوجيه عملية التنسيق والتحكم فيها، محولًا أوامر LaTeX ونص المستند إلى ملف PDF منسق باحتراف. وهذا يعني أنك تحتاج فقط إلى التركيز على *المحتوى* من مستندك، وسيتكفل الكمبيوتر، عبر أوامر LaTeX ومحرك TeX، بـ *المظهر البصري* (التنسيق).

## لماذا تتعلم LaTeX؟

يمكن طرح حجج مختلفة مع أو ضد تعلم استخدام LaTeX بدلًا من تطبيقات تأليف المستندات الأخرى؛ لكن الأمر في النهاية خيار شخصي يعتمد على التفضيلات والميول ومتطلبات التوثيق.

تشمل الحجج المؤيدة لـ LaTeX ما يلي:

* الدعم لتنسيق الرياضيات شديدة التعقيد، والجداول، والمحتوى التقني في العلوم الفيزيائية؛
* إمكانات للحواشي السفلية، والإحالات المتقاطعة، وإدارة المراجع الببليوغرافية؛
* سهولة إنتاج عناصر مستندية معقدة أو مرهقة مثل الفهارس، والمسارد، وجدول المحتويات، وقوائم الأشكال؛
* قابليته العالية للتخصيص لإنتاج مستندات مخصصة بفضل قابليته البرمجية الكامنة وقابليته للتوسعة عبر آلاف من [حِزم إضافية مجانية](https://www.ctan.org/pkg).

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

من الفوائد المهمة في LaTeX الفصل بين محتوى المستند ونمطه: فبمجرد أن تكتب محتوى مستندك، يمكنك تغيير مظهره بسهولة. وبالمثل، يمكنك إنشاء ملف LaTeX يعرّف التخطيط/النمط لنوع معين من المستندات، ويمكن استخدام هذا الملف كـ *قالب* لتوحيد تأليف/إنتاج مستندات إضافية من ذلك النوع؛ على سبيل المثال، يتيح ذلك للناشرين العلميين إنشاء قوالب مقالات، بلغة LaTeX، يستخدمها المؤلفون لكتابة أوراقهم لتقديمها إلى المجلات. لدى Overleaf [معرض يضم آلاف القوالب](https://www.overleaf.com/gallery)، يغطي نطاقًا هائلًا من أنواع المستندات — من المقالات العلمية، والتقارير، والكتب إلى السير الذاتية والعروض التقديمية. وبما أن هذه القوالب تحدد تخطيط المستند ونمطه، فما على المؤلفين إلا فتحها في Overleaf — بإنشاء مشروع جديد — وبدء الكتابة لإضافة محتواهم.

## كتابة أول جزء من LaTeX

الخطوة الأولى هي إنشاء مشروع LaTeX جديد. يمكنك فعل ذلك على جهازك بإنشاء `.tex` ملف جديد؛ أو يمكنك [بدء مشروع جديد في Overleaf](broken://pages/667acc0dcfae95212c8ae0e26d8e5baa446119c5).

لنبدأ بأبسط مثال عملي، والذي يمكن فتحه مباشرة في Overleaf:

```latex
\documentclass{article}
\begin{document}
المستند الأول. هذا مثال بسيط، من دون 
تضمين أي معلمات إضافية أو حِزم.
\end{document}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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)

ينتج هذا المثال المخرجات التالية:

![مستند مثال](https://images.ctfassets.net/nrgyaltdicpt/5oBbZABsWEnHZpwhfvV2PD/95ba7d5496616b4f10dffe6fb90f578a/LL30Fig1-plain.svg)

يمكنك أن ترى أن LaTeX قد أزاح السطر الأول من الفقرة تلقائيًا، متكفّلًا بذلك التنسيق نيابةً عنك. لنلقِ نظرة أقرب على ما يفعله كل جزء من الشفرة.

السطر الأول من الشفرة، `\documentclass{article}`، يعلن نوع المستند المعروف باسم *الفئة*، والتي تتحكم في المظهر العام للمستند. تتطلب أنواع المستندات المختلفة فئات مختلفة؛ أي إن السيرة الذاتية ستتطلب فئة مختلفة عن الورقة العلمية التي قد تستخدم فئة LaTeX القياسية `article` فئة. وقد تتطلب أنواع أخرى من المستندات التي قد تعمل عليها فئات مختلفة مثل `book` أو `report`. وللحصول على فكرة عن الأنواع الكثيرة المتاحة من فئات LaTeX، [زر الصفحة ذات الصلة على CTAN (Comprehensive TeX Archive Network)](https://www.ctan.org/topic/class).

بعد ضبط فئة المستند، يُكتب المحتوى الخاص بنا، المعروف باسم *المتن* المستند، بين `\begin{document}` و `\end{document}` الوسمين. بعد فتح المثال أعلاه، يمكنك إجراء تغييرات على النص، وعند الانتهاء، عرض ملف PDF الناتج المنسق بواسطة *إعادة تجميع المستند*. وللقيام بذلك في Overleaf، ما عليك سوى الضغط على **إعادة التجميع**، كما هو موضح في مقطع الفيديو القصير هذا:

يمكن تهيئة أي مشروع في Overleaf ليُعاد تجميعه تلقائيًا في كل مرة يتم تحريره فيها: انقر السهم الصغير بجوار **إعادة التجميع** الزر واضبط **التجميع التلقائي** إلى **On**، كما هو موضح في لقطة الشاشة التالية:

![لقطة شاشة تُظهر كيفية ضبط التجميع التلقائي على تشغيل أو إيقاف](/files/dedd4b37767616c1c166ba4543bbb10913f09620)

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

## مقدمة المستند

تُظهر لقطة الشاشة أعلاه أن Overleaf يخزن مستند LaTeX كملف يُسمى `main.tex`: الـ `.tex` امتداد الملف يُستخدم، بحسب العرف، عند تسمية الملفات التي تحتوي على شيفرة LaTeX الخاصة بمستندك.

أظهر المثال السابق كيف تم إدخال محتوى المستند بعد `\begin{document}` الأمر؛ ومع ذلك، فإن كل شيء في `.tex` الملف الذي يظهر *قبل* ذلك الموضع يُسمى *المقدمة التمهيدية*، والذي يعمل كقسم «الإعداد» في المستند. داخل المقدمة التمهيدية تحدد فئة المستند (نوعه) إلى جانب تفاصيل مثل اللغات التي ستُستخدم عند كتابة المستند؛ وتحميل *الحِزم* التي ترغب في استخدامها (المزيد عن هذا [لاحقًا](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages))، وهو المكان الذي تطبق فيه أنواعًا أخرى من الإعدادات.

قد تبدو مقدمة مستند بسيطة جدًا كما يلي:

```latex
\documentclass[12pt, letterpaper]{article}
\usepackage{graphicx}
```

حيث `\documentclass[12pt, letterpaper]{article}` يحدد الفئة (النوع) العامة للمستند. وتُدرج المعاملات الإضافية، التي يجب فصلها بفواصل، بين أقواس مربعة (`[...]`) وتُستخدم لتهيئة هذه النسخة من فئة المقالة؛ أي الإعدادات التي نرغب في استخدامها لهذا المستند المحدد `article`-المبني على الفئة.

في هذا المثال، يقوم المعلمان اثنان بما يلي:

* `12pt` يحدد حجم الخط
* `letterpaper` يحدد حجم الورق

وبالطبع يمكن استخدام أحجام خط أخرى، `9pt`, `11pt`, `12pt`، ويمكن استخدامها، ولكن إذا لم يُحدد أي منها، فالحجم الافتراضي هو `10pt`. أما بالنسبة لحجم الورق، فالقيم الأخرى الممكنة هي `a4paper` و `legalpaper`. ولمزيد من المعلومات، انظر المقالة حول [حجم الصفحة والهوامش](broken://pages/4a68d6b6f1e07e82f1a6b0e4f4009b2b76daea69).

سطر المقدمة التمهيدية

```latex
\usepackage{graphicx}
```

هو مثال على تحميل حزمة خارجية (هنا، [graphicx](https://ctan.org/pkg/graphicx?lang=en)) لتوسيع قدرات LaTeX، بما يتيح له استيراد ملفات الرسومات الخارجية. وتُناقَش حِزم LaTeX في القسم [العثور على حِزم LaTeX واستخدامها](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

## تضمين معلومات العنوان والمؤلف والتاريخ

تتطلب إضافة عنوان ومؤلف وتاريخ إلى مستندنا ثلاث أسطر إضافية في *المقدمة التمهيدية* (*ليس* المتن الرئيسي للمستند).

* `\title{أول مستند LaTeX الخاص بي}`: عنوان المستند
* `\author{Hubert Farnsworth}`: هنا تكتب اسم المؤلف(ين) و، اختياريًا، `\thanks` الأمر داخل الأقواس المعقوفة:
  * `\thanks{تم تمويله من قِبل فريق Overleaf.}`: يمكن إضافته بعد اسم المؤلف، داخل أقواس الأمر `المؤلف` الأمر. سيضيف مرتفعًا علويًا وحاشية سفلية بالنص الموجود داخل الأقواس. وهو مفيد إذا كنت بحاجة إلى شكر مؤسسة في مقالك.
* `\date{أغسطس 2022}`: يمكنك إدخال التاريخ يدويًا أو استخدام الأمر `\today` لطباعة التاريخ الحالي في كل مرة يُعاد فيها تجميع المستند

بعد إضافة هذه الأسطر، ينبغي أن تبدو مقدمتك التمهيدية على هذا النحو:

```latex
\documentclass[12pt, letterpaper]{article}
\title{أول مستند LaTeX الخاص بي}
\author{Hubert Farnsworth\thanks{تم تمويله من قِبل فريق Overleaf.}}
\date{أغسطس 2022}
```

لطباعة العنوان والمؤلف والتاريخ استخدم `\maketitle` الأمر داخل *المتن* المستند:

```latex
\begin{document}
\maketitle
لقد أضفنا الآن عنوانًا ومؤلفًا وتاريخًا إلى أول مستند \LaTeX{} لنا!
\end{document}
```

يمكن الآن دمج المقدمة التمهيدية والمتن لإنتاج مستند كامل يمكن فتحه في Overleaf:

```latex
\documentclass[12pt, letterpaper]{article}
\title{أول مستند LaTeX الخاص بي}
\author{Hubert Farnsworth\thanks{تم تمويله من قِبل فريق Overleaf.}}
\date{أغسطس 2022}
\begin{document}
\maketitle
لقد أضفنا الآن عنوانًا ومؤلفًا وتاريخًا إلى أول مستند \LaTeX{} لنا!
\end{document}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/3WzMd0bx2zlj3zLTKS8SxT/dc2b7c16adbc96bdd750b6d2c8b4227e/LL30Fig2r-plain.svg)

## إضافة التعليقات

LaTeX هو نوع من «الشفرة البرمجية»، لكنه متخصص في تنسيق المستندات؛ ولذلك، كما هو الحال مع الشفرة المكتوبة بأي لغة برمجة أخرى، قد يكون من المفيد جدًا تضمين تعليقات داخل مستندك. تعليق LaTeX هو جزء من النص لن يُطبع أو يؤثر في المستند بأي شكل — ويُستخدم غالبًا لإضافة ملاحظات «لإنجازها لاحقًا»؛ أو لإدراج ملاحظات توضيحية؛ أو لتقديم شروحات داخلية للماكروات الصعبة؛ أو لتعليق أسطر/أقسام من شفرة LaTeX أثناء التنقيح.

لإضافة تعليق في LaTeX، ما عليك سوى كتابة `%` الرمز في بداية السطر، كما هو موضح في الشفرة التالية التي تستخدم المثال أعلاه:

```latex
\documentclass[12pt, letterpaper]{article}
\title{أول مستند LaTeX الخاص بي}
\author{Hubert Farnsworth\thanks{تم تمويله من قِبل فريق Overleaf.}}
\date{أغسطس 2022}
\begin{document}
\maketitle
لقد أضفنا الآن عنوانًا ومؤلفًا وتاريخًا إلى أول مستند \LaTeX{} لنا!

% هذا السطر هنا تعليق. لن يُطبع في المستند.
\end{document}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/6vo15r0tLCByTpcvn1w2E8/8f14edc7ece1f10ce4ba2c76e1e58a56/LL30Fig3r-plain.svg)

أمر آخر مفيد جدًا هو `\emph{_الوسيط_}`، والذي يعتمد تأثيره على `_الوسيط_` يعتمد على السياق. داخل النص العادي يكون النص المؤكد مائلاً، لكن هذا السلوك ينعكس إذا استُخدم داخل نص مائل — انظر المثال التالي:

```latex
بعض أعظم \emph{الاكتشافات} في العلم 
تم التوصل إليها بالصدفة.

\textit{بعض أعظم \emph{الاكتشافات} 
في العلم تم التوصل إليها بالصدفة.}

\textbf{بعض أعظم \emph{الاكتشافات} 
في العلم تم التوصل إليها بالصدفة.}
```

[افتح هذا **\emph** المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Using+the+emph+command\&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%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](https://images.ctfassets.net/nrgyaltdicpt/1K0A8RXXOomakJBAr2usmp/62d0e8b5275092dd0b1b4a59c745b632/LL30Fig4r-plain.svg)

* **ملاحظة:** بعض الحِزم، مثل [Beamer](broken://pages/171e3166b2996a6418eae802ca3b710fd0a44c1e)، تغيّر سلوك `\emph` الأمر.

## إضافة الصور

في هذا القسم سننظر في كيفية إضافة الصور إلى مستند LaTeX. يدعم Overleaf ثلاث طرق لإدراج الصور:

1. استخدم [**إدراج شكل** الزر](https://learn.overleaf.com/learn/Kb/How%5Fto%5Finsert%5Ffigures%5Fin%5FOverleaf#Using%5FInsert%5FFigure%5Fto%5Fadd%5Fa%5Ffigure%5Fto%5Fyour%5Fproject)(![The Insert Figure button on the editor toolbar](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/a/a8/InsertFigureButton.png)، الموجود على شريط أدوات المحرر، لإدراج صورة في **المحرر المرئي** أو **محرر الشفرة**.
2. [انسخ صورة والصقها](broken://pages/76b925f6707104b3764ca58a339d4ea5e7093be2) في **المحرر المرئي** أو **محرر الشفرة**.
3. استخدم **محرر الشفرة** لِكتابة شفرة LaTeX تُدرج رسماً.

يقوم الخياران 1 و2 تلقائيًا بتوليد شيفرة LaTeX المطلوبة لإدراج الصور، لكننا هنا نقدم الخيار 3 — لاحظ أنك ستحتاج إلى [تحميل تلك الصور](https://docs.overleaf.com/writing-and-editing/inserting-images) إلى مشروعك في 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](https://images.ctfassets.net/nrgyaltdicpt/4p5toat08FUgehv4yuNwXS/efc9e75e4342c9caeec94f26627fa337/LL30Fig5v2-plain.svg)

يتطلب استيراد الرسومات إلى مستند LaTeX [إضافة *حزمة*](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages) توفّر الأوامر والميزات المطلوبة لتضمين ملفات الرسومات الخارجية. ويحمّل المثال أعلاه [حزمة graphicx](https://ctan.org/pkg/graphicx?lang=en) التي توفّر، من بين أوامر كثيرة أخرى، `\includegraphics{...}` لاستيراد الرسومات و `\graphicspath{...}` لإخبار LaTeX بمكان وجود الرسومات.

لاستخدام `graphicx` الحزمة، أدرج السطر التالي في مقدمة مستندك في Overleaf:

```latex
\usepackage{graphicx}
```

في مثالنا، الأمر `\graphicspath{{images/}}` يُعلم LaTeX بأن الصور محفوظة في مجلد اسمه `images`، الموجود في الدليل الحالي:

![صورة تُظهر LaTeX وهو يصل إلى الصور المخزنة في مجلد](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/1/17/ImagesInAFolder.png)

الأمر `\includegraphics{universe}` يقوم بالفعل بإدراج الصورة في المستند. هنا، `universe` هو اسم ملف الصورة لكن من دون امتداده.

**ملاحظة**:

* على الرغم من أن اسم الملف الكامل، بما في ذلك الامتداد، مسموح به في `\includegraphics` الأمر، فإن حذف امتداد الملف يُعد أفضل ممارسة لأنه سيجعل LaTeX يبحث عن جميع الصيغ المدعومة.
* عمومًا، ينبغي ألا يحتوي اسم ملف الرسم على مسافات بيضاء أو نقاط متعددة؛ كما يُوصى باستخدام أحرف صغيرة في امتداد الملف عند تحميل ملفات الصور إلى Overleaf.

يمكن العثور على مزيد من المعلومات حول حِزم LaTeX في نهاية هذا الدرس في قسم [العثور على حِزم LaTeX واستخدامها](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

## التسميات التوضيحية والوسوم والمراجع

يمكن إضافة تسميات توضيحية للصور ووضع علامات لها والإشارة إليها باستخدام `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](https://images.ctfassets.net/nrgyaltdicpt/4DkAWWkQqZP6QHU2EErogQ/9aa2371f2cde0f3f8bf22aa1c0b91789/LL30Fig6r-plain.svg)

هناك عدة أوامر جديرة بالملاحظة في المثال:

* **`\includegraphics[width=0.75\textwidth]{mesh}`**: هذا الشكل من `\includegraphics` يأمر LaTeX بتعيين عرض الشكل إلى 75% من عرض النص — وتُخزن قيمته في `\textwidth` الأمر.
* **`\caption{مخطط جميل.}`**: كما يوحي اسمه، يعيّن هذا الأمر التسمية التوضيحية للشكل، والتي يمكن وضعها فوق الشكل أو تحته. وإذا أنشأت قائمة بالأشكال فستُستخدم هذه التسمية في تلك القائمة.
* **`\label{fig:mesh1}`**: للإشارة إلى هذه الصورة داخل مستندك، تمنحها وسمًا باستخدام `\label` الأمر. ويُستخدم الوسم لتوليد رقم للصورة، ومع الأمر التالي، سيسمح لك بالإشارة إليها.
* **`\ref{fig:mesh1}`**: سيُستبدل هذا الرمز بالرقم المطابق للشكل المشار إليه.

ينبغي وضع الصور المدمجة في مستند LaTeX داخل `figure` بيئة، أو ما شابه، حتى يتمكن LaTeX من وضع الصورة تلقائيًا في موقع مناسب داخل مستندك.

توجد إرشادات إضافية في مقالات المساعدة التالية في Overleaf:

* [وضع الأشكال](broken://pages/2c2aaecca08a2f5937975f536e5bfd52594b8c45)
* [إدراج الصور](https://docs.overleaf.com/writing-and-editing/inserting-images)

## إنشاء القوائم في LaTeX

يمكنك إنشاء أنواع مختلفة من القوائم باستخدام *البيئات*، والتي تُستخدم لاحتواء شفرة LaTeX المطلوبة لتنفيذ ميزة تنسيق محددة. وتبدأ البيئة بـ `\begin{_environment-name_}` وتنتهي بـ `\end{_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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/1lDj29Mg9ZuLNHXwZrTJew/cd7d950c65fd05b251c4aa55746f4eb7/LL30Fig7-plain.svg)

يمكنك أيضًا فتح هذا [المشروع الأكبر في 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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/2vkfa7RiAIJxv5wIZbg9UK/530c384f159d091a587de279d13fefec/LL30Fig8-plain.svg)

كما هو الحال مع `القوائم` غير المرتبة، يجب أن يسبق كل إدخال الأمر `\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](broken://pages/fc0726e2416050c7a1cd10ef9df08bfdb7cc4b44)، التي توفر العديد من الأمثلة الإضافية وتوضح كيفية إنشاء قوائم مخصصة.

## إضافة الرياضيات إلى 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%5Fname=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)

ينتج هذا المثال المخرجات التالية:

![صورة تُظهر الرياضيات مُهيأة في نمط الرياضيات ضمن السطر](https://images.ctfassets.net/nrgyaltdicpt/77oK8pfew1B1VvxiBtALag/15714f2da4e469bbb8cf70a0d3733e5d/LL30Fig9-plain.svg)

لتهيئة الرياضيات في نمط ضمن السطر يمكنك استخدام إحدى هاتين الزوجين من المحددات: `\( ... \)`, `$ ... $` أو `\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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/46VPfEGxYJ3di18TLzaLo9/ed67df07532c52b6543fd2bae7cb7c04/LL30Fig10r-plain.svg)

### نمط الرياضيات العرضي

يمكن ترقيم المعادلات المُهيأة في النمط العرضي أو عدم ترقيمها، كما في المثال التالي:

```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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/6n1FPYFzmzCHPpWoEoYQZM/79b33f1096be06326bff7d2e1976c67c/LL30Fig11-plain.svg)

لتهيئة الرياضيات في النمط العرضي يمكنك استخدام إحدى هاتين الزوجين من المحددات: `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` أو `\begin{equation} ... \end{equation}`. تاريخيًا، كانت تهيئة الرياضيات في النمط العرضي تتطلب استخدام `$$` فواصل من الرموز، كما في `$$ _... هنا الرياضيات العرضية ..._$$`، لكن هذه الطريقة [لم تعد موصى بها](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%5Fname=More+advanced+LaTeX+math+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASubscripts+in+math+mode+are+written+as+%24a%5Fb%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%5F1+i%5F2+%5Cdots+i%5Fp%7D%5F%7Bj%5F1+j%5F2+%5Cdots+j%5Fq%7D+%3D+T%28x%5E%7Bi%5F1%7D%2C%5Cdots%2Cx%5E%7Bi%5Fp%7D%2Ce%5F%7Bj%5F1%7D%2C%5Cdots%2Ce%5F%7Bj%5Fq%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%5F0%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](https://images.ctfassets.net/nrgyaltdicpt/5xfm4NybWckHL5ndpdnBRq/bc0b5e27044820ea5cdd11648a68f543/LL30Fig12r-plain.svg)

يستخدم المثال التالي `equation*` البيئة التي يوفرها `amsmath` الحزمة، لذا نحتاج إلى إضافة السطر التالي إلى مقدمة مستندنا:

```latex
\usepackage{amsmath}% For the equation* environment
```

للمزيد من المعلومات حول استخدام `amsmath` انظر [مقالة المساعدة الخاصة بنا](broken://pages/7b0b9cb0e0e5f692a6082dcc56e874fcbd222ac9).

```latex
\documentclass{article}
\usepackage{amsmath}% For the equation* environment
\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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/hT85gkewCDlxCHeNU5slE/9256c129b25bec7a93dcfe9e44b0654a/LL30Fig13r-plain.svg)

الاحتمالات مع الرياضيات في LaTeX لا نهائية، لذا تأكد من زيارة صفحات المساعدة لدينا للحصول على نصائح وأمثلة حول موضوعات محددة:

* [التعابير الرياضية](broken://pages/a462fcac7eefae37e8fd3ccbab21fbd42d471047)
* [الرموز السفلية والرموز العلوية](broken://pages/a954864a7327969d36b922e6097aaf3ff46665a2)
* [الأقواس](broken://pages/c6d95cc6c0572389fc641276e188b4f45461e725)
* [الكسور والحدود ذات الحدين](broken://pages/0677511e3b5c6c9fd66b5d3557e85b5e61ed9356)
* [محاذاة المعادلات](broken://pages/1e3f35b8600a04318b5e9c0be39d3b1c780404a9)
* [العوامل](broken://pages/7af56637d589d098238052b071c59eeed54890dd)
* [المسافات في نمط الرياضيات](broken://pages/ca8849b3254a92d047618c7bbd20b6ebd0a97cce)
* [التكاملات والمجاميع والحدود](broken://pages/03978008c35386759800c632745c38073eeec368)
* [النمط العرضي في نمط الرياضيات](broken://pages/6f2e67ead67343307d18a469429c6ed275cd3ad9)
* [قائمة الحروف اليونانية والرموز الرياضية](broken://pages/0bcdd3581089b06792dc42ee9f1ca7d117ea439e)
* [الخطوط الرياضية](broken://pages/19bafad35058920d84d3c74fb9d6c6c6fa36e8e0)

## البنية الأساسية للمستند

بعد ذلك، نستكشف الملخصات وكيفية تقسيم مستند LaTeX إلى فصول وأقسام وفقرات مختلفة.

### الملخصات

توفّر المقالات العلمية عادةً *ملخصًا* وهو نظرة عامة/خلاصة موجزة لموضوعاتها أو حججها الأساسية. يوضح المثال التالي تنسيق ملخص باستخدام `ملخصًا` البيئة:

```latex
\documentclass{article}
\begin{document}
\begin{abstract}
هذه فقرة بسيطة في بداية 
المستند. مقدمة موجزة عن الموضوع الرئيسي.
\end{abstract}
\end{document}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/4cPu8x8ZxuDVF6efcZ03yi/91aa6aa84719613b0e25c725b70aa0b8/LL30Fig14-plain.svg)

### الفقرات والأسطر الجديدة

بعد وضع الملخص في مكانه، يمكننا البدء في كتابة فقرتنا الأولى. يوضح المثال التالي:

* كيف تُنشأ فقرة جديدة بالضغط على المفتاح "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%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/5DdSH06hFli8k4lR0dxw4m/a55cddf9aa10b64302ae7b72ba0c6447/LL30Fig15r-plain.svg)

لاحظ كيف يقوم LaTeX تلقائيًا بإزاحة الفقرات—باستثناء ما يأتي مباشرة بعد عناوين المستند مثل section وsubsection—[كما سنرى](#Chapters%5Fand%5Fsections).

يُنصح المستخدمون الجدد بأن عدة `\\` أو `\newline`s لا ينبغي استخدامها «لمحاكاة» الفقرات عبر زيادة المسافة بينها، لأن ذلك قد يتداخل مع خوارزميات التنضيد في LaTeX. والطريقة الموصى بها هي الاستمرار في استخدام الأسطر الفارغة لإنشاء فقرات جديدة، من دون أي `\\`، وتحميل [حزمة parskip](https://ctan.org/pkg/parskip?lang=en) بإضافة `\usepackage{parskip}` إلى المقدمة.

يمكن العثور على مزيد من المعلومات حول الفقرات في المقالات التالية:

* [الفقرات والأسطر الجديدة](broken://pages/19a46fbadf50e2e26bdcb411b1cf40691467f340)
* [كيفية تغيير تباعد الفقرات في LaTeX](broken://pages/c55dd8fef071579377240e0ca7e1c67928677b6b)
* [خطأ في LaTeX: لا يوجد سطر هنا لإنهائه](broken://pages/34103b7ab55f1d1910f18258fd81a151d830a24f) يقدّم نصائح وإرشادات إضافية حول استخدام `\\`.

### الفصول والأقسام

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

يوضح المثال التالي الأوامر المستخدمة لتنظيم مستند يعتمد على فئة `book` فئة:

```latex
\documentclass{book}
\begin{document}

\chapter{First Chapter}

\section{Introduction}

هذا هو القسم الأول.

Lorem  ipsum  dolor  sit  amet,  consectetuer  adipiscing  
elit. Etiam  lobortisfacilisis sem.  Nullam nec mi et 
neque pharetra sollicitudin.  Praesent imperdietmi nec ante. 
Donec ullamcorper, felis non sodales...

\section{Second Section}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.  
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra 
sollicitudin.  Praesent imperdiet mi necante...

\subsection{First Subsection}
Praesent imperdietmi nec ante. Donec ullamcorper, felis non sodales...

\section*{Unnumbered Section}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.  
Etiam lobortis facilisissem...
\end{document}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/1A1T7YsurQdM058OwmLqd8/7f6e962c31356bafa702bab9062f6061/LL30Fig16-plain.svg)

أسماء أوامر التقسيم توضيحية إلى حد كبير؛ على سبيل المثال، `\chapter{First Chapter}` ينشئ فصلاً جديدًا بعنوان `First Chapter`, `\section{Introduction}` ينتج قسمًا بعنوان `Introduction`، وهكذا. يمكن تقسيم الأقسام إلى `\subsection{...}` وحتى `\subsubsection{...}`. يتم الترقيم التلقائي للأقسام والأقسام الفرعية وما إلى ذلك، لكن يمكن تعطيله باستخدام ما يُسمّى *النسخة ذات النجمة* من الأمر المناسب الذي ينتهي بنجمة (\*)، مثل `\section*{...}` و `\subsection*{...}`.

*بشكلٍ عام*، توفّر فئات مستندات LaTeX أوامر التقسيم التالية، مع دعم فئات معينة لمجموعة فرعية ذات صلة:

* `\part{part}`
* `\chapter{chapter}`
* `\section{section}`
* `\subsection{subsection}`
* `\subsubsection{subsubsection}`
* `\paragraph{paragraph}`
* `\subparagraph{subparagraph}`

وعلى وجه الخصوص، فإن `\part` و `\chapter` الأمرين متاحان فقط في `report` و `book` فئات المستندات.

زر مقال Overleaf [المقالة حول الأقسام والفصول](broken://pages/4a36e16376ace0f60da15da9c0c273c5824e6352) للمزيد من المعلومات حول أوامر بنية المستند.

## إنشاء الجداول

يوفر Overleaf ثلاثة خيارات لإنشاء الجداول:

1. باستخدام [**إدراج جدول** الزر](https://www.overleaf.com/learn/how-to/How%5Fto%5Finsert%5Ftables%5Fin%5FOverleaf%23inserttable#Using%5FInsert%5FTable%5Fto%5Fcreate%5Fa%5Ftable%5Fin%5Fyour%5Fproject) في **المحرر المرئي** (أو **محرر الشفرة**) شريط الأدوات.
2. [نسخ جدول ولصقه](https://www.overleaf.com/learn/how-to/How%5Fto%5Fpaste%5Fformatted%5Fcontent%5Finto%5FOverleaf%23pastingtables) من مستند آخر أثناء استخدام **المحرر المرئي**.
3. كتابة كود LaTeX للجدول في محرر الأكواد.

إذا كنت جديدًا على LaTeX، فإن استخدام شريط الأدوات في **المحرر المرئي** (الخيار 1) طريقة رائعة للبدء—يمكنك التبديل بين **المحرر المرئي** و **محرر الشفرة** لرؤية الكود خلف الجدول.

هنا، نركّز على الخيار 3—وهو أكثر الطرق مرونة لإنشاء الجداول—ونقدّم أمثلة توضح كيفية إنشاء الجداول في LaTeX، بما في ذلك إضافة الخطوط (القواعد) والتسميات التوضيحية. ومع اكتسابك الخبرة، ألقِ نظرة على إرشاداتنا التفصيلية حول [كيفية إنشاء الجداول باستخدام LaTeX](https://www.overleaf.com/learn/latex/Tables).

### إنشاء جدول أساسي في LaTeX

نبدأ بمثال يوضح كيفية تنضيد جدول أساسي:

```latex
\begin{center}
\begin{tabular}{c c c}
 cell1 & cell2 & cell3 \\ 
 cell4 & cell5 & cell6 \\  
 cell7 & cell8 & cell9    
\end{tabular}
\end{center}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/5K46QavbKv9vF4RI1GbUf2/f22d4f8a06d00251166f86d2c891321e/LL30Fig17-plain.svg)

الأمر `tabular` تُعد بيئة الطريقة الافتراضية في LaTeX لإنشاء الجداول. يجب عليك تحديد معامل لهذه البيئة، في هذه الحالة `{c c c}` وهو ما يوجّه LaTeX إلى وجود ثلاثة أعمدة وأن النص داخل كل منها يجب أن يكون في الوسط. ويمكنك أيضًا استخدام `r` لمحاذاة النص إلى اليمين و `l` لمحاذاته إلى اليسار. يُستخدم رمز المحاذاة `&` لتمييز خلايا الجدول الفردية داخل صف من الجدول. ولإنهاء صف الجدول استخدم أمر *سطر جديد* command `\\`. يحتوي جدولنا داخل بيئة `center` لجعلَه مُوسَّطًا ضمن عرض النص في الصفحة.

### إضافة حدود

الأمر `tabular` تدعم البيئة الخطوط الأفقية والعمودية (القواعد) كجزء من الجدول:

* لإضافة قواعد أفقية فوق الصفوف وتحتها، استخدم `\hline` command
* لإضافة قواعد عمودية بين الأعمدة، استخدم معامل الخط العمودي `|`

في هذا المثال، تكون الوسيطة هي `{|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%5Fname=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 يحتوي على قواعد أفقية وعمودية](https://images.ctfassets.net/nrgyaltdicpt/5uWYGUhK1XJJJaWz5R1EmX/3ee88bf6b2eaf8d0644b57fa8064800b/LL30Fig18-plain.svg)

إليك مثالًا آخر:

```latex
\begin{center}
 \begin{tabular}{||c c c c||} 
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [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%5Fname=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 يحتوي على قواعد أفقية وعمودية](https://images.ctfassets.net/nrgyaltdicpt/1Cy9FcRnDVDRUPQdCgaKq6/c21e5f7d9a53514756c6e1f2996e51e0/LL30Fig19-plain.svg)

### التسميات التوضيحية والوسوم والمراجع

يمكنك وضع عنوان وإشارة مرجعية للجداول بالطريقة نفسها تقريبًا مثل الصور. الفرق الوحيد هو أنه بدلًا من **`figure`** البيئة، تستخدم **`table`** البيئة.

يوضح الجدول \ref{table:data} كيفية إضافة عنوان للجدول والإشارة إليه.

```latex
\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||} 
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [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{Table to test captions and labels.}
\label{table:data}
\end{table}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 مع عنوان](https://images.ctfassets.net/nrgyaltdicpt/1f5w74UIaTCkpApaPdVeWf/580a87c2413ddc9d6bdef3bf462689fc/LL30Fig20-plain.svg)

## إضافة جدول محتويات

إنشاء جدول محتويات أمر سهل لأن الأمر `\tableofcontents` يقوم بمعظم العمل نيابةً عنك:

```latex
\documentclass{article}
\title{Sections and Chapters}
\author{Gubert Farnsworth}
\date{أغسطس 2022}
\begin{document}
  
\maketitle
  
\tableofcontents

\section{Introduction}
   
هذا هو القسم الأول.
      
Lorem  ipsum  dolor  sit  amet,  consectetuer  adipiscing  
elit.   Etiam  lobortisfacilisis sem.  Nullam nec mi et 
neque pharetra sollicitudin.  Praesent imperdietmi nec ante. 
Donec ullamcorper, felis non sodales...
       
\section*{Unnumbered Section}
\addcontentsline{toc}{section}{Unnumbered Section}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.  
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra 
sollicitudin.  Praesent imperdiet mi necante...

\section{Second Section}
       
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.  
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra 
sollicitudin.  Praesent imperdiet mi necante...
\end{document}
```

[افتح هذا المثال في Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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](https://images.ctfassets.net/nrgyaltdicpt/MxY592Q6EGsDKMA2mZw0t/fffa41a0a0d30770526f73aff72a7be1/LL30Fig21r-plain.svg)

تُدرج الأقسام والأقسام الفرعية والفصول تلقائيًا في جدول المحتويات. ولإضافة إدخالات يدويًا، مثل قسم غير مرقم، استخدم الأمر `\addcontentsline` كما هو موضح في المثال.

## تنزيل مستندك النهائي

يوضح مقطع الفيديو القصير التالي كيفية تنزيل الشفرة المصدرية لمشروعك أو ملف PDF المهيأ:

يمكن العثور على مزيد من المعلومات في مقالة المساعدة الخاصة بـ Overleaf [تصدير عملك من Overleaf](https://docs.overleaf.com/managing-projects-and-files/downloading-a-project).

## العثور على حِزم LaTeX واستخدامها

لا يقدّم LaTeX إمكانات تنضيد كبيرة فحسب، بل يوفّر أيضًا *إطارًا للتوسّعية* من خلال استخدام ملحقات *الحِزم*. وبدلًا من محاولة توفير أوامر وميزات «تحاول فعل كل شيء»، صُمِّم LaTeX ليكون *قابلًا للتوسّع*، مما يسمح للمستخدمين بتحميل أجسام خارجية من الشفرة (حزم) توفر قدرات تنضيد أكثر تخصصًا أو توسّع الميزات المدمجة في LaTeX—مثل تنضيد الجداول. وكما لوحِظ في القسم [إضافة الصور](#Adding%5Fimages)، فإن `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%5Fname=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)

ينتج هذا المثال المخرجات التالية:

![صورة تُظهر الخطأ الناتج عن حزمة مفقودة](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/6/60/LL30packagefail.png)

### العثور على معلومات حول الحزم: CTAN

تُوزَّع الحزم عبر [شبكة أرشيف TeX الشاملة](https://www.ctan.org/)، ويُشار إليها عادةً باسم CTAN، والتي تستضيف، حتى وقت كتابة هذا النص، 6287 حزمة من 2881 مساهمًا. ويصف CTAN نفسه [يصف نفسه](https://www.ctan.org/ctan) بأنه

> ... مجموعة من مواقع الإنترنت حول العالم التي تتيح موادًا متعلقة بـ 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](https://www.overleaf.com/learn/latex/Overleaf%5Fand%5FTeX%5FLive) وتُحدَّث عند إصدار نسخة جديدة من 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/texlive/ar/asasyat-latex/tal-m-latex-fy-30-dqyqh.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.
