> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# تعلّم LaTeX في 30 دقيقة
> جديد: تفضّل بزيارة [مركز Overleaf التعليمي](https://learn.overleaf.com/) الجديد لاستكشاف الدورات المجانية عبر الإنترنت والندوات المباشرة — كل ما تحتاجه لإتقان LaTeX والاستفادة القصوى من Overleaf.
لا يفترض هذا الدرس التمهيدي أي خبرة سابقة في LaTeX، ولكن نأمل أنه بحلول الوقت الذي تنتهي فيه، لن تكون قد كتبت أول مستند LaTeX لك فحسب، بل ستكون قد اكتسبت أيضًا معرفة وثقة كافيتين لاتخاذ الخطوات التالية نحو إتقان LaTeX.
## ما هو LaTeX؟
LaTeX (ويُنطق "*لاي*-تِك" أو "*لا*-تِك") هو أداة لتنضيد مستندات ذات مظهر احترافي. ومع ذلك، فإن طريقة عمل 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.
لنبدأ بأبسط مثال عملي، والذي يمكن فتحه مباشرةً في Overleaf:
```latex theme={null}
\documentclass{article}
\begin{document}
First document. This is a simple example, with no
extra parameters or packages included.
\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)
ينتج هذا المثال المخرجات التالية:
يمكنك أن ترى أن LaTeX قد أزاح السطر الأول من الفقرة تلقائيًا، متوليًا ذلك التنسيق نيابةً عنك. لنلقِ نظرة أقرب على ما يفعله كل جزء من شيفرتنا.
السطر الأول من الشيفرة، `\documentclass{article}`، يصرّح بنوع المستند المعروف باسم *الصنف* (class)، والذي يتحكم في المظهر العام للمستند. تتطلب أنواع المستندات المختلفة أصنافًا مختلفة؛ أي أن السيرة الذاتية ستتطلب صنفًا مختلفًا عن الورقة العلمية التي قد تستخدم صنف LaTeX القياسي `article`. وقد تتطلب أنواع أخرى من المستندات التي تعمل عليها أصنافًا مختلفة مثل `book` أو `report`. ولأخذ فكرة عن أنواع أصناف LaTeX العديدة المتاحة، [تفضّل بزيارة الصفحة المعنية على CTAN (Comprehensive TeX Archive Network)](https://www.ctan.org/topic/class).
بعد تعيين صنف المستند، يُكتب محتوانا، المعروف باسم *متن* المستند، بين الوسمين `\begin{document}` و `\end{document}`. بعد فتح المثال أعلاه، يمكنك إجراء تغييرات على النص، وعند الانتهاء، عرض ملف PDF المنضّد الناتج عبر *إعادة ترجمة المستند*. وللقيام بذلك في Overleaf، ما عليك سوى الضغط على **Recompile**، كما هو موضح في هذا المقطع المرئي القصير:
يمكن إعداد أي مشروع Overleaf لإعادة الترجمة تلقائيًا في كل مرة يتم تحريره فيها: انقر على السهم الصغير بجوار الزر **Recompile** واضبط **Auto Compile** على **On**، كما هو موضح في لقطة الشاشة التالية:
بعد أن رأينا كيفية إضافة محتوى إلى مستندنا، فإن الخطوة التالية هي إعطاؤه عنوانًا. وللقيام بذلك، يجب أن نتحدث باختصار عن **الديباجة** (preamble).
## ديباجة المستند
توضح لقطة الشاشة أعلاه أن Overleaf يخزّن مستند LaTeX كملف يسمى `main.tex`: إذ يُستخدم امتداد الملف `.tex`، وفقًا للعرف، عند تسمية الملفات التي تحتوي على شيفرة LaTeX الخاصة بمستندك.
أوضح المثال السابق كيف أُدخل محتوى المستند بعد الأمر `\begin{document}`؛ إلا أن كل ما يظهر في ملف `.tex` الخاص بك *قبل* تلك النقطة يسمى *الديباجة*، والتي تعمل كقسم "الإعداد" للمستند. داخل الديباجة تحدد صنف المستند (نوعه) إلى جانب تفاصيل مثل اللغات التي ستُستخدم عند كتابة المستند؛ وتحمّل *الحزم* التي ترغب في استخدامها (المزيد حول ذلك [لاحقًا](/ar/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages))، وهي المكان الذي تطبّق فيه أنواعًا أخرى من الإعدادات.
قد تبدو ديباجة مستند بسيطة هكذا:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\usepackage{graphicx}
```
حيث يحدد `\documentclass[12pt, letterpaper]{article}` الصنف (النوع) العام للمستند. وتُدرج المعاملات الإضافية، التي يجب فصلها بفواصل، بين أقواس مربعة (`[...]`) وتُستخدم لإعداد هذه النسخة من صنف article؛ أي الإعدادات التي نرغب في استخدامها لهذا المستند المحدد المبني على صنف `article`.
في هذا المثال، يقوم المعاملان بما يلي:
* `12pt` يعيّن حجم الخط
* `letterpaper` يعيّن حجم الورق
بالطبع يمكن استخدام أحجام خطوط أخرى، `9pt` و `11pt` و `12pt`، ولكن إذا لم يُحدَّد أيٌّ منها، فالحجم الافتراضي هو `10pt`. أما بالنسبة لحجم الورق، فالقيم الممكنة الأخرى هي `a4paper` و `legalpaper`. لمزيد من المعلومات، راجع المقالة الخاصة بحجم الصفحة والهوامش.
سطر الديباجة
```latex theme={null}
\usepackage{graphicx}
```
هو مثال على تحميل حزمة خارجية (هنا، [graphicx](https://ctan.org/pkg/graphicx?lang=en)) لتوسيع إمكانات LaTeX، مما يمكّنه من استيراد ملفات رسومية خارجية. وتُناقَش حزم LaTeX في القسم [العثور على حزم LaTeX واستخدامها](/ar/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).
## إضافة معلومات العنوان والمؤلف والتاريخ
تتطلب إضافة عنوان ومؤلف وتاريخ إلى مستندنا ثلاثة أسطر أخرى في *الديباجة* (*وليس* في المتن الرئيسي للمستند). وهذه الأسطر هي:
* `\title{My first LaTeX document}`: عنوان المستند
* `\author{Hubert Farnsworth}`: هنا تكتب اسم المؤلف (أو المؤلفين)، ويمكنك اختياريًا استخدام الأمر `\thanks` داخل الأقواس المعقوفة:
* `\thanks{Funded by the Overleaf team.}`: يمكن إضافته بعد اسم المؤلف، داخل أقواس الأمر `author`. وسيضيف رمزًا علويًا وحاشية سفلية تحتوي على النص الموجود داخل الأقواس. وهو مفيد إذا احتجت إلى شكر مؤسسة ما في مقالتك.
* `\date{August 2022}`: يمكنك إدخال التاريخ يدويًا أو استخدام الأمر `\today` لتنضيد التاريخ الحالي في كل مرة تتم فيها ترجمة المستند
بعد إضافة هذه الأسطر، يجب أن تبدو ديباجتك على نحو مشابه لما يلي:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
```
لتنضيد العنوان والمؤلف والتاريخ، استخدم الأمر `\maketitle` داخل *متن* المستند:
```latex theme={null}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
\end{document}
```
يمكن الآن دمج الديباجة والمتن لإنتاج مستند كامل يمكن فتحه في Overleaf:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
\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 هو شكل من أشكال "الشيفرة البرمجية"، لكنه متخصص في تنضيد المستندات؛ وبالتالي، كما هو الحال مع الشيفرة المكتوبة بأي لغة برمجة أخرى، قد يكون من المفيد جدًا تضمين تعليقات داخل مستندك. تعليق LaTeX هو جزء من النص لن يُنضَّد ولن يؤثر على المستند بأي شكل من الأشكال — وغالبًا ما يُستخدم لإضافة ملاحظات "للقيام بها"؛ أو تضمين ملاحظات توضيحية؛ أو تقديم شروحات ضمنية لوحدات الماكرو المعقدة، أو لتعطيل أسطر/أقسام من شيفرة LaTeX عبر تحويلها إلى تعليقات أثناء تصحيح الأخطاء.
لكتابة تعليق في LaTeX، ما عليك سوى كتابة الرمز `%` في بداية السطر، كما هو موضح في الشيفرة التالية التي تستخدم المثال أعلاه:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
% This line here is a comment. It will not be typeset in the document.
\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 theme={null}
Some of the \textbf{greatest}
discoveries in \underline{science}
were made by \textbf{\textit{accident}}.
```
[افتح هذا المثال في 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)
ينتج هذا المثال المخرجات التالية:
من الأوامر المفيدة جدًا أيضًا `\emph{_argument_}`، الذي يعتمد تأثيره على `_argument_` الخاص به على السياق. فداخل النص العادي، يُكتب النص المؤكَّد بخط مائل، لكن هذا السلوك ينعكس إذا استُخدم داخل نص مائل — انظر المثال التالي:
```latex theme={null}
Some of the greatest \emph{discoveries} in science
were made by accident.
\textit{Some of the greatest \emph{discoveries}
in science were made by accident.}
\textbf{Some of the greatest \emph{discoveries}
in science were made by accident.}
```
[افتح مثال \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)
ينتج هذا المثال المخرجات التالية:
* ملاحظة: بعض الحزم، مثل Beamer، تغيّر سلوك الأمر `\emph`.
## إضافة الصور
في هذا القسم سنلقي نظرة على كيفية إضافة الصور إلى مستند LaTeX. يدعم Overleaf ثلاث طرق لإدراج الصور:
1. استخدم [الزر **Insert Figure**](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using%5FInsert%5FFigure%5Fto%5Fadd%5Fa%5Ffigure%5Fto%5Fyour%5Fproject)()، الموجود في شريط أدوات المحرر، لإدراج صورة في **Visual Editor** أو **Code Editor**.
2. انسخ صورة والصقها في **Visual Editor** أو **Code Editor**.
3. استخدم **Code Editor** لكتابة شيفرة LaTeX تُدرج رسمًا.
يُنشئ الخياران 1 و 2 تلقائيًا شيفرة LaTeX اللازمة لإدراج الصور، لكننا هنا نقدّم الخيار 3 — لاحظ أنك ستحتاج إلى [رفع تلك الصور](https://docs.overleaf.com/writing-and-editing/inserting-images) إلى مشروع Overleaf الخاص بك. يوضح المثال التالي كيفية تضمين صورة:
```latex theme={null}
\documentclass{article}
\usepackage{graphicx} %LaTeX package to import graphics
\graphicspath{{images/}} %configuring the graphicx package
\begin{document}
The universe is immense and it seems to be homogeneous,
on a large scale, everywhere we look.
% The \includegraphics command is
% provided (implemented) by the
% graphicx package
\includegraphics{universe}
There's a picture of a galaxy above.
\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 إلى [*حزمة* إضافية](/ar/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages) توفّر الأوامر والميزات اللازمة لتضمين ملفات الرسوم الخارجية. يحمّل المثال أعلاه [الحزمة graphicx](https://ctan.org/pkg/graphicx?lang=en) التي توفّر، من بين أوامر أخرى كثيرة، الأمر `\includegraphics{...}` لاستيراد الرسوم والأمر `\graphicspath{...}` لإعلام LaTeX بمكان وجود الرسوم.
لاستخدام الحزمة `graphicx`، أضف السطر التالي إلى ديباجة مستند Overleaf الخاص بك:
```latex theme={null}
\usepackage{graphicx}
```
في مثالنا، يُعلم الأمر `\graphicspath{{images/}}` نظام LaTeX بأن الصور محفوظة في مجلد يسمى `images`، موجود في المجلد الحالي:
يقوم الأمر `\includegraphics{universe}` بالعمل الفعلي لإدراج الصورة في المستند. وهنا، `universe` هو اسم ملف الصورة ولكن دون امتداده.
**ملاحظة**:
* على الرغم من أن اسم الملف الكامل، بما في ذلك امتداده، مسموح به في الأمر `\includegraphics`، فإن أفضل ممارسة هي حذف امتداد الملف لأن ذلك سيدفع LaTeX إلى البحث عن جميع الصيغ المدعومة.
* بشكل عام، يجب ألا يحتوي اسم ملف الرسم على مسافات بيضاء أو نقاط متعددة؛ كما يُنصح باستخدام أحرف صغيرة لامتداد الملف عند رفع ملفات الصور إلى Overleaf.
يمكن العثور على مزيد من المعلومات حول حزم LaTeX في نهاية هذا الدرس في القسم [العثور على حزم LaTeX واستخدامها](/ar/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).
## التسميات التوضيحية والعناوين المرجعية والإحالات
يمكن إضافة تسميات توضيحية للصور ووسمها والإحالة إليها عن طريق البيئة `figure`، كما هو موضح أدناه:
```latex theme={null}
\documentclass{article}
\usepackage{graphicx}
\graphicspath{{images/}}
\begin{document}
\begin{figure}[h]
\centering
\includegraphics[width=0.75\textwidth]{mesh}
\caption{A nice plot.}
\label{fig:mesh1}
\end{figure}
As you can see in figure \ref{fig:mesh1}, the function grows near the origin. This example is on page \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=)
ينتج هذا المثال المخرجات التالية:
هناك عدة أوامر جديرة بالملاحظة في المثال:
* **`\includegraphics[width=0.75\textwidth]{mesh}`**: يوجّه هذا الشكل من `\includegraphics` نظام LaTeX إلى تعيين عرض الشكل إلى 75% من عرض النص — الذي تُخزَّن قيمته في الأمر `\textwidth`.
* **`\caption{A nice plot.}`**: كما يوحي اسمه، يعيّن هذا الأمر التسمية التوضيحية للشكل، والتي يمكن وضعها فوق الشكل أو تحته. وإذا أنشأت قائمة بالأشكال، فستُستخدم هذه التسمية التوضيحية في تلك القائمة.
* **`\label{fig:mesh1}`**: للإحالة إلى هذه الصورة داخل مستندك، تمنحها وسمًا (label) باستخدام الأمر `\label`. يُستخدم الوسم لتوليد رقم للصورة، ومع الأمر التالي، سيتيح لك الإحالة إليها.
* **`\ref{fig:mesh1}`**: ستُستبدل هذه الشيفرة بالرقم المقابل للشكل المُحال إليه.
يجب وضع الصور المضمّنة في مستند LaTeX داخل بيئة `figure`، أو ما يشابهها، حتى يتمكن LaTeX من وضع الصورة تلقائيًا في موقع مناسب في مستندك.
يتوفر مزيد من الإرشادات في مقالات المساعدة التالية من Overleaf:
* تحديد مواضع الأشكال
* [إدراج الصور](https://docs.overleaf.com/writing-and-editing/inserting-images)
## إنشاء القوائم في LaTeX
يمكنك إنشاء أنواع مختلفة من القوائم باستخدام *البيئات* (environments)، والتي تُستخدم لتغليف شيفرة LaTeX اللازمة لتنفيذ ميزة تنضيد معينة. تبدأ البيئة بـ `\begin{_environment-name_}` وتنتهي بـ `\end{_environment-name_}` حيث قد يكون `_environment-name_` هو `figure` أو `tabular` أو أحد أنواع القوائم: `itemize` للقوائم غير المرتبة أو `enumerate` للقوائم المرتبة.
### القوائم غير المرتبة
تُنتَج القوائم غير المرتبة بواسطة البيئة `itemize`. ويجب أن يسبق كل عنصر في القائمة الأمر `\item`، كما هو موضح أدناه:
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{itemize}
\item The individual entries are indicated with a black dot, a so-called bullet.
\item The text in the entries may be of any length.
\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)
ينتج هذا المثال المخرجات التالية:
يمكنك أيضًا فتح [مشروع 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 theme={null}
\documentclass{article}
\begin{document}
\begin{enumerate}
\item This is the first entry in our list.
\item The list numbers increase with each entry we add.
\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)
ينتج هذا المثال المخرجات التالية:
كما هو الحال مع القوائم `unordered`، يجب أن يسبق كل عنصر الأمر `\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
من المزايا الرئيسية لـ LaTeX السهولة التي يمكن بها كتابة التعابير الرياضية. يوفّر LaTeX وضعين للكتابة لتنضيد الرياضيات:
* الوضع الرياضي *المضمّن* (inline) المستخدم لكتابة الصيغ التي تكون جزءًا من فقرة
* الوضع الرياضي *المعروض* (display) المستخدم لكتابة التعابير التي ليست جزءًا من نص أو فقرة وتُنضَّد في أسطر منفصلة
### الوضع الرياضي المضمّن
لنرَ مثالًا على الوضع الرياضي المضمّن:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
In physics, the mass-energy equivalence is stated
by the equation $E=mc^2$, discovered in 1905 by Albert Einstein.
\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)
ينتج هذا المثال المخرجات التالية:
لتنضيد الرياضيات في الوضع المضمّن، يمكنك استخدام أحد أزواج المحدِّدات التالية: `\( ... \)` أو `$ ... $` أو `\begin{math} ... \end{math}`، كما هو موضح في المثال التالي:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
\begin{math}
E=mc^2
\end{math} is typeset in a paragraph using inline math mode---as is $E=mc^2$, and so too is \(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 theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
The mass-energy equivalence is described by the famous equation
\[ E=mc^2 \] discovered in 1905 by Albert Einstein.
In natural units ($c = 1$), the formula expresses the identity
\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)
ينتج هذا المثال المخرجات التالية:
لتنضيد الرياضيات في الوضع المعروض، يمكنك استخدام أحد أزواج المحدِّدات التالية: `\[ ... \]` أو `\begin{displaymath} ... \end{displaymath}` أو `\begin{equation} ... \end{equation}`. تاريخيًا، كان تنضيد الرياضيات في الوضع المعروض يتطلب استخدام المحدِّدين `$$`، كما في `$$ _... display math here ..._$$`، لكن هذه الطريقة [لم تعد موصى بها](https://texfaq.org/FAQ-dolldoll): استخدم محدِّدات LaTeX `\[ ... \]` بدلًا منها.
### أمثلة أكثر اكتمالًا
توضح الأمثلة التالية مجموعة من المحتوى الرياضي المنضّد باستخدام LaTeX.
```latex theme={null}
\documentclass{article}
\begin{document}
Subscripts in math mode are written as $a_b$ and superscripts are written as $a^b$. These can be combined and nested to write expressions such as
\[ 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}) \]
We write integrals using $\int$ and fractions using $\frac{a}{b}$. Limits are placed on integrals using superscripts and subscripts:
\[ \int_0^1 \frac{dx}{e^x} = \frac{e-1}{e} \]
Lower case Greek letters are written as $\omega$ $\delta$ etc. while upper case Greek letters are written as $\Omega$ $\Delta$.
Mathematical operators are prefixed with a backslash as $\sin(\beta)$, $\cos(\alpha)$, $\log(x)$ etc.
\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)
ينتج هذا المثال المخرجات التالية:
يستخدم المثال التالي البيئة `equation*` التي توفّرها الحزمة `amsmath`، لذا نحتاج إلى إضافة السطر التالي إلى ديباجة مستندنا:
```latex theme={null}
\usepackage{amsmath}% For the equation* environment
```
لمزيد من المعلومات حول استخدام `amsmath`، راجع مقالة المساعدة الخاصة بنا.
```latex theme={null}
\documentclass{article}
\usepackage{amsmath}% For the equation* environment
\begin{document}
\section{First example}
The well-known Pythagorean theorem \(x^2 + y^2 = z^2\) was proved to be invalid for other exponents, meaning the next equation has no integer solutions for \(n>2\):
\[ x^n + y^n = z^n \]
\section{Second example}
This is a simple math expression \(\sqrt{x^2+1}\) inside text.
And this is also the same:
\begin{math}
\sqrt{x^2+1}
\end{math}
but by using another command.
This is a simple math expression without numbering
\[\sqrt{x^2+1}\]
separated from text.
This is also the same:
\begin{displaymath}
\sqrt{x^2+1}
\end{displaymath}
\ldots and this:
\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 لا حصر لها، لذا احرص على زيارة صفحات المساعدة الخاصة بنا للحصول على نصائح وأمثلة حول مواضيع محددة:
* التعابير الرياضية
* الرموز السفلية والعلوية
* الأقواس المربعة والهلالية
* الكسور ومعاملات ذات الحدين
* محاذاة المعادلات
* المؤثرات (Operators)
* التباعد في الوضع الرياضي
* التكاملات والمجاميع والنهايات
* نمط العرض في الوضع الرياضي
* قائمة الحروف اليونانية والرموز الرياضية
* الخطوط الرياضية
## البنية الأساسية للمستند
بعد ذلك، نستكشف الملخصات وكيفية تقسيم مستند LaTeX إلى فصول وأقسام وفقرات مختلفة.
### الملخصات
عادةً ما تقدّم المقالات العلمية *ملخصًا* (abstract)، وهو نظرة عامة/خلاصة موجزة لمواضيعها أو حججها الأساسية. يوضح المثال التالي تنضيد ملخص باستخدام البيئة `abstract` في LaTeX:
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{abstract}
This is a simple paragraph at the beginning of the
document. A brief introduction about the main subject.
\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)
ينتج هذا المثال المخرجات التالية:
### الفقرات والأسطر الجديدة
بعد وضع الملخص، يمكننا البدء في كتابة فقرتنا الأولى. يوضح المثال التالي:
* كيف تُنشأ فقرة جديدة بالضغط على مفتاح "enter" مرتين، مما يُنهي السطر الحالي ويُدرج سطرًا فارغًا بعده؛
* كيف تبدأ سطرًا جديدًا دون بدء فقرة جديدة عبر إدراج فاصل أسطر يدوي باستخدام الأمر `\\`، وهو شرطة مائلة عكسية مزدوجة؛ أو بدلًا من ذلك، استخدم الأمر `\newline`.
توضح الفقرة الثالثة في هذا المثال استخدام الأمرين `\\` و `\newline`:
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{abstract}
This is a simple paragraph at the beginning of the
document. A brief introduction about the main subject.
\end{abstract}
After our abstract we can begin the first paragraph, then press ``enter'' twice to start the second one.
This line will start a second paragraph.
I will start the third paragraph and then add \\ a manual line break which causes this text to start on a new line but remains part of the same paragraph. Alternatively, I can use the \verb|\newline|\newline command to start a new line, which is also part of the same paragraph.
\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 الفقرات تلقائيًا — باستثناء ما يأتي مباشرةً بعد عناوين المستند مثل القسم والقسم الفرعي — [كما سنرى](/ar/texlive/latex-basics/learn-latex-in-30-minutes#Chapters%5Fand%5Fsections).
يُنصح المستخدمون الجدد بعدم استخدام عدة أوامر `\\` أو `\newline` "لمحاكاة" فقرات ذات تباعد أكبر بينها، لأن ذلك قد يتعارض مع خوارزميات التنضيد في LaTeX. والطريقة الموصى بها هي الاستمرار في استخدام الأسطر الفارغة لإنشاء فقرات جديدة، دون أي `\\`، وتحميل [الحزمة parskip](https://ctan.org/pkg/parskip?lang=en) بإضافة `\usepackage{parskip}` إلى الديباجة.
يمكن العثور على مزيد من المعلومات حول الفقرات في المقالات التالية:
* الفقرات والأسطر الجديدة
* كيفية تغيير تباعد الفقرات في LaTeX
* توفّر المقالة LaTeX Error: There's no line here to end نصائح وإرشادات إضافية حول استخدام `\\`.
### الفصول والأقسام
عادةً ما تُقسَّم المستندات الأطول، بغض النظر عن برنامج التأليف، إلى أجزاء وفصول وأقسام وأقسام فرعية وما إلى ذلك. يوفّر LaTeX أيضًا أوامر لهيكلة المستندات، لكن الأوامر المتاحة وتطبيقاتها (ما تفعله) قد تعتمد على صنف المستند المستخدم. على سبيل المثال، يمكن تقسيم المستندات المنشأة باستخدام الصنف `book` إلى أجزاء وفصول وأقسام وأقسام فرعية وما إلى ذلك، لكن الصنف `letter` لا يوفّر (لا يدعم) أي أوامر للقيام بذلك.
يوضح المثال التالي الأوامر المستخدمة لهيكلة مستند مبني على الصنف `book`:
```latex theme={null}
\documentclass{book}
\begin{document}
\chapter{First Chapter}
\section{Introduction}
This is the first section.
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)
ينتج هذا المثال المخرجات التالية:
أسماء أوامر التقسيم واضحة في الغالب بذاتها؛ فعلى سبيل المثال، ينشئ `\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 حول الأقسام والفصول لمزيد من المعلومات حول أوامر هيكلة المستندات.
## إنشاء الجداول
يوفّر Overleaf ثلاثة خيارات لإنشاء الجداول:
1. استخدام [الزر **Insert Table**](https://www.overleaf.com/learn/how-to/How_to_insert_tables_in_Overleaf%23inserttable#Using%5FInsert%5FTable%5Fto%5Fcreate%5Fa%5Ftable%5Fin%5Fyour%5Fproject) في شريط أدوات **Visual Editor** (أو **Code Editor**).
2. [نسخ جدول ولصقه](https://www.overleaf.com/learn/how-to/How_to_paste_formatted_content_into_Overleaf%23pastingtables) من مستند آخر أثناء استخدام **Visual Editor**.
3. كتابة شيفرة LaTeX للجدول في Code Editor.
إذا كنت جديدًا على LaTeX، فإن استخدام شريط الأدوات في **Visual Editor** (الخيار 1) طريقة رائعة للبدء — ويمكنك التبديل بين **Visual Editor** و **Code Editor** لرؤية الشيفرة الكامنة وراء الجدول.
نركّز هنا على الخيار 3 — وهو الطريقة الأكثر مرونة لإنشاء الجداول — ونقدّم أمثلة توضح كيفية إنشاء الجداول في LaTeX، بما في ذلك إضافة الخطوط (rules) والتسميات التوضيحية. ومع اكتسابك للخبرة، ألقِ نظرة على إرشاداتنا المفصلة حول [كيفية إنشاء الجداول باستخدام LaTeX](https://www.overleaf.com/learn/latex/Tables).
### إنشاء جدول أساسي في LaTeX
نبدأ بمثال يوضح كيفية تنضيد جدول أساسي:
```latex theme={null}
\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)
ينتج هذا المثال المخرجات التالية:
البيئة `tabular` هي طريقة LaTeX الافتراضية لإنشاء الجداول. يجب أن تحدد معاملًا لهذه البيئة، وهو في هذه الحالة `{c c c}` الذي يُعلم LaTeX بأنه سيكون هناك ثلاثة أعمدة وأن النص داخل كل منها يجب أن يكون في المنتصف. ويمكنك أيضًا استخدام `r` لمحاذاة النص إلى اليمين و `l` لمحاذاته إلى اليسار. يُستخدم رمز المحاذاة `&` لتحديد خلايا الجدول المنفردة داخل صف الجدول. ولإنهاء صف في الجدول استخدم أمر *السطر الجديد* `\\`. وجدولنا موضوع داخل بيئة `center` لجعله في منتصف عرض نص الصفحة.
### إضافة الحدود
تدعم البيئة `tabular` الخطوط الأفقية والعمودية (rules) كجزء من الجدول:
* لإضافة خطوط أفقية فوق الصفوف وتحتها، استخدم الأمر `\hline`
* لإضافة خطوط عمودية بين الأعمدة، استخدم معامل الخط العمودي `|`
في هذا المثال، الوسيط هو `{|c|c|c|}` الذي يصرّح بثلاثة أعمدة (في المنتصف) يفصل بين كل منها خط عمودي؛ بالإضافة إلى ذلك، نستخدم `\hline` لوضع خط أفقي فوق الصف الأول وتحت الصف الأخير:
```latex theme={null}
\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 theme={null}
\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)
ينتج هذا المثال المخرجات التالية:
### التسميات التوضيحية والعناوين المرجعية والإحالات
يمكنك إضافة تسميات توضيحية للجداول والإحالة إليها بالطريقة نفسها تقريبًا المتبعة مع الصور. والفرق الوحيد هو أنك بدلًا من البيئة **`figure`** تستخدم البيئة **`table`**.
يوضح الجدول \ref\{table:data} كيفية إضافة تسمية توضيحية لجدول والإحالة إليه.
```latex theme={null}
\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)
ينتج هذا المثال المخرجات التالية:
## إضافة جدول المحتويات
إنشاء جدول المحتويات أمر بسيط لأن الأمر `\tableofcontents` يقوم بمعظم العمل نيابةً عنك:
```latex theme={null}
\documentclass{article}
\title{Sections and Chapters}
\author{Gubert Farnsworth}
\date{August 2022}
\begin{document}
\maketitle
\tableofcontents
\section{Introduction}
This is the first section.
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)
ينتج هذا المثال المخرجات التالية:
تُضمَّن الأقسام والأقسام الفرعية والفصول تلقائيًا في جدول المحتويات. ولإضافة مدخلات يدويًا، مثل قسم غير مرقّم، استخدم الأمر `\addcontentsline` كما هو موضح في المثال.
## تنزيل مستندك المكتمل
يوضح المقطع المرئي القصير التالي كيفية تنزيل الشيفرة المصدرية لمشروعك أو ملف PDF المنضّد:
يمكن العثور على مزيد من المعلومات في مقالة مساعدة Overleaf [تصدير عملك من Overleaf](https://docs.overleaf.com/managing-projects-and-files/downloading-a-project).
## العثور على حزم LaTeX واستخدامها
لا يقدّم LaTeX إمكانات تنضيد كبيرة فحسب، بل يوفّر أيضًا *إطارًا للتوسعة* من خلال استخدام *الحزم* الإضافية. فبدلًا من محاولة توفير أوامر وميزات "تحاول فعل كل شيء"، صُمّم LaTeX ليكون *قابلًا للتوسعة*، مما يتيح للمستخدمين تحميل مجموعات خارجية من الشيفرة (الحزم) التي توفّر إمكانات تنضيد أكثر تخصصًا أو توسّع ميزات LaTeX المدمجة — مثل تنضيد الجداول. وكما لوحظ في القسم [إضافة الصور](/ar/texlive/latex-basics/learn-latex-in-30-minutes#Adding%5Fimages)، فإن الحزمة `graphicx` توسّع LaTeX بتوفير أوامر لاستيراد ملفات الرسوم، وقد حُمّلت (في الديباجة) بكتابة
```latex theme={null}
\usepackage{graphicx}
```
### تحميل الحزم
كما ذُكر أعلاه، تُحمَّل الحزم في ديباجة المستند عبر الأمر `\usepackage`، ولكن لأن (كثيرًا من) حزم LaTeX توفّر مجموعة من *الخيارات* التي يمكن استخدامها لإعداد سلوكها، فإن الأمر `\usepackage` غالبًا ما يبدو هكذا:
```latex theme={null}
\usepackage[options]{somepackage}
```
تُعلم الأقواس المربعة "`[...]`" نظام LaTeX بمجموعة الخيارات التي يجب تطبيقها عند تحميل `somepackage`. وداخل مجموعة الخيارات التي يطلبها المستخدم، تُفصل الخيارات أو الإعدادات المنفردة عادةً بفاصلة؛ فعلى سبيل المثال، توفّر [الحزمة geometry](https://ctan.org/pkg/geometry) خيارات عديدة لإعداد تخطيط الصفحة في LaTeX، لذا قد يبدو الاستخدام النموذجي لـ `geometry` هكذا:
```latex theme={null}
\usepackage[total={6.5in,8.75in},
top=1.2in, left=0.9in, includefoot]{geometry}
```
الحزمة `geometry` هي مثال على حزمة كتبها وساهم بها أعضاء من مجتمع LaTeX العالمي، وأُتيحت مجانًا لأي شخص يرغب في استخدامها.
إذا كانت حزمة LaTeX لا توفّر أي خيارات، أو أراد المستخدم استخدام القيم الافتراضية لخيارات الحزمة، فستُحمَّل هكذا:
```latex theme={null}
\usepackage{somepackage}
```
عندما تكتب `\usepackage[...]{somepackage}` يبحث LaTeX عن ملف مقابل يسمى `_somepackage_.sty`، يحتاج إلى تحميله ومعالجته — لإتاحة أوامر الحزمة وتنفيذ أي شيفرة أخرى توفّرها تلك الحزمة. وإذا لم يتمكن LaTeX من العثور على `_somepackage_.sty` فسيتوقف مع خطأ، كما هو موضح في مثال Overleaf التالي:
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\usepackage{somepackage}% a NON-EXISTENT package
\begin{document}
This will fail!
\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)
ينتج هذا المثال المخرجات التالية:
### العثور على معلومات حول الحزم: CTAN
تُوزَّع الحزم عبر [Comprehensive TeX Archive Network](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_and_TeX_Live) وتُحدَّث عند صدور إصدار جديد من 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، لكن من غير المرجح بشكل عام أن يسبب ذلك مشكلة.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.