> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ar/mzyd-mn-almwdhwaat/27-inserting-images.md).

# إدراج الصور

## أربع طرق لإدراج الصور (إنشاء أشكال LaTeX) في Overleaf

الخيارات هي كما يلي:

1. استخدم [**إدراج شكل** الزر](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using_Insert_Figure_to_add_a_figure_to_your_project)(![The Insert Figure button on the editor toolbar](/files/d2b38be5fa85b0b6161275782f9acdf0eff85889)، الموجودة على شريط أدوات المحرر، لإدراج شكل داخل **المحرر المرئي** أو **محرر الكود**.
2. [نسخ ولصق صورة](/latex/ar/qaadh-almarfh/075-how-to-paste-formatted-content-into-overleaf.md#pasting-images-into-your-overleaf-project) إدراجها في **المحرر المرئي** أو **محرر الكود**.
3. يمكنك استخدام السحب والإفلات لإنشاء شكل. حدِّد ملفًا من نظام الملفات المحلي لديك، أو أحد الملفات التي تم رفعها إلى مشروع Overleaf، وأفلته في **المحرر المرئي** أو **محرر الكود**. يعرض Overleaf نافذة تحتوي على خيارات لتخصيص إعدادات الشكل.
4. استخدم **محرر الكود** لكتابة كود LaTeX يدرج رسماً ويضعه داخل بيئة figure.

تقوم الخيارات 1 و2 و3 بإنشاء كود LaTeX المطلوب لإنشاء الشكل تلقائيًا، لكننا هنا نستعرض الخيار 4، الذي يوفّر أكبر قدر من المرونة.

## مقدمة

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

```latex
\documentclass{article}
\usepackage{graphicx}
\graphicspath{ {./images/} }

\begin{document}
الكون هائل ويبدو متجانسًا،
على نطاق واسع، في كل مكان ننظر إليه.

\includegraphics{universe}

يوجد في الأعلى صورة لمجرة
\end{document}
```

![مثال على إدراج صورة](/files/1f249e24320a32fdd4f60e75c2602e2f57dbc96c)

لا يستطيع LaTeX إدارة الصور بنفسه، لذلك نحتاج إلى استخدام `graphicx` الحزمة. لاستخدامها، ندرج السطر التالي في المقدمة: `\usepackage{graphicx}`.

الأمر `\graphicspath{ {./images/} }` يخبر LaTeX بأن الصور محفوظة في مجلد باسم `images` ضمن دليل المستند الرئيسي.

ال `\includegraphics{universe}` هو الأمر الذي أدرج الصورة فعليًا في المستند. هنا `universe` هو اسم الملف الذي يحتوي على الصورة من دون الامتداد، ثم `universe.PNG` يصبح `universe`. يجب ألا يحتوي اسم ملف الصورة على مسافات بيضاء ولا على نقاط متعددة.

ملاحظة: يُسمح بتضمين امتداد الملف، لكن من الأفضل حذفه. إذا لم يُذكر الامتداد فسيحث ذلك LaTeX على البحث عن جميع الصيغ المدعومة. لمزيد من التفاصيل، انظر القسم الخاص بـ [إنشاء صور عالية الدقة ومنخفضة الدقة](#generating-high-res-and-low-res-images).

&#x20;[افتح مثال الصور في Overleaf](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## مسار المجلد إلى الصور

عند العمل على مستند يتضمن عدة صور، يمكن الاحتفاظ بهذه الصور في مجلد واحد أو أكثر منفصل، بحيث يكون مشروعك أكثر تنظيمًا.

الأمر `\graphicspath{ {images/} }` يخبر LaTeX أن يبحث في `images` المجلد. المسار هو ***نسبي*** بالنسبة إلى دليل العمل الحالي — لذا سيتحقق المترجم من الملف في المجلد نفسه الذي يوجد فيه الكود الذي أُدرجت فيه الصورة. يكون مسار المجلد نسبيًا افتراضيًا، إذا لم يُحدَّد دليل ابتدائي، على سبيل المثال

```latex
%المسار النسبي إلى ملف .tex الذي يحتوي على الأمر \includegraphics
\graphicspath{ {images/} }
```

هذه عادة طريقة مباشرة للوصول إلى مجلد الرسومات داخل شجرة الملفات، لكنها قد تؤدي إلى تعقيدات عندما `.tex` يتم تضمين الملفات الموجودة داخل المجلدات في `.tex` الملف الرئيسي. عندئذٍ قد ينتهي بالمترجم الأمر إلى البحث عن مجلد الصور في المكان الخطأ. لذلك، **من الأفضل عادةً تحديد مسار الرسومات بحيث يكون نسبيًا إلى `.tex` قابل للتحرير**، مع الإشارة إلى الملف الرئيسي `.tex` بدليل الملف على أنه `./` ، على سبيل المثال:

```latex
%المسار النسبي إلى ملف .tex الرئيسي
\graphicspath{ {./images/} }
```

كما في المقدمة.

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

```latex
%المسار بصيغة Windows:
\graphicspath{ {c:/user/images/} }

%المسار بصيغة شبيهة بـ Unix (Linux، Mac OS)
\graphicspath{ {/home/user/images/} }
```

لاحظ أن هذا الأمر يتطلب شرطة مائلة نهائية `/` وأن المسار يقع بين قوسين معقوفين مزدوجين.

يمكنك أيضًا تحديد مسارات متعددة إذا كانت الصور محفوظة في أكثر من مجلد واحد. على سبيل المثال، إذا كان هناك مجلدان باسم `images1` و `images2`، فاستخدم الأمر

```latex
\graphicspath{ {./images1/}{./images2/} }
```

&#x20;[افتح مثال الصور في Overleaf](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## تغيير حجم الصورة وتدويرها

إذا أردنا تحديد كيفية تضمين LaTeX للصورة في المستند بشكل أدق (الطول، الارتفاع، إلخ)، فيمكننا تمرير هذه الإعدادات بالصيغة التالية:

```latex
\begin{document}

Overleaf أداة احترافية رائعة لتحرير المستندات عبر الإنترنت،
ومشاركة مشاريع \LaTeX{} الخاصة بك ونسخها احتياطيًا. كما يوفّر
وثائق مساعدة كبيرة نسبيًا.

\includegraphics[scale=1.5]{overleaf-logo}
```

![مثال على تغيير حجم الصورة](/files/4f09c2ccb6188bf7d282e0c726b6b12ec3ea7dad)

الأمر `\includegraphics[scale=1.5]{overleaf-logo}` سيُدرج الصورة `overleaf-logo` في المستند، والمعامل الإضافي `scale=1.5` سيفعل ذلك بالضبط، أي سيُحجِّم الصورة إلى 1.5 من حجمها الحقيقي.

يمكنك أيضًا تحجيم الصورة إلى عرض وارتفاع محددين.

```latex
\begin{document}

Overleaf أداة احترافية رائعة لتحرير المستندات عبر الإنترنت،
ومشاركة مشاريع \LaTeX{} الخاصة بك ونسخها احتياطيًا. كما يوفّر
وثائق مساعدة كبيرة نسبيًا.

\includegraphics[width=5cm, height=4cm]{overleaf-logo}
```

![مثال على تعيين ارتفاع الصورة وعرضها](/files/c7251ccf4f75f86b3692b12c36b78d71962324cf)

كما خمنتَ على الأرجح، المعاملات داخل الأقواس `[width=3cm, height=4cm]` تحدد عرض الصورة وارتفاعها. يمكنك استخدام [وحدات مختلفة](#reference-guide) لهذه المعاملات. إذا كان فقط *العرض* المعامل مُمرَّرًا، فسيُحجَّم الارتفاع للحفاظ على نسبة الأبعاد.

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

```latex
\begin{document}

الكون هائل ويبدو متجانسًا،
على نطاق واسع، في كل مكان ننظر إليه.

\includegraphics[width=\textwidth]{universe}
```

![مثال على جعل الصورة بعرض النص](/files/2d69fd508524edc504cab3b1097913621da3e303)

بدلاً من `\textwidth` يمكنك استخدام أي طول افتراضي آخر في LaTeX: `\columnsep`, `\linewidth`, `\textheight`, `\paperheight`، إلخ. انظر [دليل المراجع](#reference-guide) للاطلاع على وصف إضافي لهذه الوحدات.

هناك خيار شائع آخر عند تضمين صورة داخل مستندك، وهو تدويرها. ويمكن تحقيق ذلك بسهولة في LaTeX:

```latex
\begin{document}

Overleaf أداة احترافية رائعة للتحرير عبر الإنترنت،
ومشاركة مشاريع \LaTeX{} الخاصة بك ونسخها احتياطيًا. كما يوفّر
وقاعدة كبيرة نسبيًا من وثائق المساعدة.

\includegraphics[scale=1.2, angle=45]{overleaf-logo}
```

![مثال على تدوير صورة](/files/9f6434c3bebc7750725d677e70d1f131066166e0)

المعامل `angle=45` يدوّر الصورة 45 درجة عكس اتجاه عقارب الساعة. ولتدوير الصورة باتجاه عقارب الساعة استخدم عددًا سالبًا.

## التموضع

في القسم السابق تم شرح كيفية تضمين الصور في مستندك، لكن الجمع بين النصوص والصور قد لا يبدو كما توقعنا. ولتغيير ذلك نحتاج إلى تقديم *البيئة*.

```latex
في المثال التالي سيُوضَع الشكل
مباشرة أسفل هذه الجملة.

\begin{figure}[h]
\includegraphics[width=8cm]{Plot}
\end{figure}
```

![مثال على تموضع الأشكال](/files/3aed6310ddc0fde94ea913a6c37e8a51dffb643a)

ال `figure` تُستخدم بيئة لعرض الصور كعناصر عائمة داخل المستند. وهذا يعني أنك تُدرج الصورة داخل `figure` البيئة، ولا داعي للقلق بشأن موضعها؛ فسيضعها LaTeX بطريقة تتناسب مع تدفق المستند.

على أي حال، نحتاج أحيانًا إلى مزيد من التحكم في طريقة عرض الأشكال. ويمكن تمرير معامل إضافي لتحديد موضع الشكل. في المثال، `\begin{figure}[h]`، يحدد المعامل داخل الأقواس موضع الشكل إلى ***هنا***. وفيما يلي جدول يسرد قيم التموضع الممكنة.

| المعامل | الموضع                                                                                                                               |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| h       | ضع العنصر العائم *هنا*، أي، *تقريبًا* في الموضع نفسه الذي يظهر فيه في النص الأصلي (لكن ليس *بالضبط* في المكان)                       |
| t       | ضعه في *الأعلى* من الصفحة.                                                                                                           |
| b       | ضعه في *الأسفل* من الصفحة.                                                                                                           |
| ص       | ضعه على صفحة خاصة *page* للعناصر العائمة فقط.                                                                                        |
| !       | تجاوز المعاملات الداخلية التي يستخدمها LaTeX لتحديد مواضع العناصر العائمة «الجيدة».                                                  |
| H       | يضع العنصر العائم في الموقع نفسه تمامًا في كود LaTeX. يتطلب `float` الحزمة، رغم أنه قد يسبب مشكلات أحيانًا. وهذا يعادل إلى حد ما h!. |

في المثال التالي يمكنك رؤية صورة في `t`أعلى المستند، رغم أنه تم التصريح عنها أسفل النص.

```latex
في هذه الصورة يمكنك رؤية مخططًا شريطيًا يوضح
نتائج استطلاع شمل بعض البيانات المهمة
التي تمت دراستها مع مرور الوقت.

\begin{figure}[t]
\includegraphics[width=8cm]{Plot}
\centering
\end{figure}
```

![مثال على مخطط شريطي](/files/ff6446a16c26c0ee6ec37e90220c531a200b1cfc)

الأمر الإضافي `\centering` سيُوسِّط الصورة. والمحاذاة الافتراضية هي *الأيسر*.

### تغليف النص حول الأشكال

من الممكن أيضًا **تغليف** النص حول شكل. عندما يحتوي المستند على صور صغيرة، فإن ذلك يجعله يبدو أفضل.

```latex
\begin{wrapfigure}{r}{0.25\textwidth} %سيكون هذا الشكل على اليمين
    \centering
    \includegraphics[width=0.25\textwidth]{mesh}
\end{wrapfigure}

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

\begin{wrapfigure}{l}{0.25\textwidth}
    \centering
    \includegraphics[width=0.25\textwidth]{contour}
\end{wrapfigure}

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

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

![مثال على رسم](/files/34294d4c2749e128974ba635f487a53dd148f961)

لكي تعمل الأوامر في المثال، عليك استيراد [`wrapfig` الحزمة](https://ctan.org/pkg/wrapfig?lang=en). لاستخدام `wrapfig`، أدرج السطر التالي في مقدمة المستند:

```latex
\usepackage{wrapfig}
```

هذا يجعل `wrapfigure` البيئة متاحة ويمكننا وضع `\includegraphics` أمر بداخلها لإنشاء شكل يلتف النص حوله. فيما يلي كيفية تحديد *wrapfigure* البيئة:

```latex
\begin{wrapfigure}[lineheight]{position}{width}
  ...
\end{wrapfigure}
```

ال `الموضع` للمعامل ثماني قيم ممكنة:

|   |   |                                                          |
| - | - | -------------------------------------------------------- |
| r | R | الجانب الأيمن من النص                                    |
| l | L | الجانب الأيسر من النص                                    |
| i | I | الحافة الداخلية — بالقرب من التجليد (في *twoside* مستند) |
| o | O | الحافة الخارجية — بعيدًا عن التجليد                      |

تسمح النسخة ذات الحرف الكبير للشكل بأن يكون عائمًا. أما النسخة ذات الحرف الصغير فتعني *هنا بالضبط*.

يمكنك الآن تعريف `wrapfigure` البيئة بواسطة الأوامر `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. لاحظ أن البيئة تحتوي على معاملين إضافيين محاطين بأقواس معقوفة. فيما يلي شرح الكود بمزيد من التفصيل:

**{l}**

يحدد هذا محاذاة الشكل. استخدم l لليسار وr لليمين. علاوة على ذلك، إذا كنت تستخدم كتابًا أو أي صيغة مشابهة، فاستعمل بدلًا من ذلك o للحافة الخارجية وi للحافة الداخلية للصفحة.

**{0.25\textwidth}**

هذا هو عرض صندوق الشكل. إنه ليس عرض الصورة نفسها؛ إذ يجب ضبط ذلك في الأمر \includegraphics. لاحظ أن الطول نسبي إلى عرض النص، ولكن يمكن أيضًا استخدام الوحدات العادية (cm، in، mm، إلخ). انظر دليل المراجع للحصول على قائمة الوحدات.

**\centering**

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

للاطلاع على مقالة أكثر شمولًا حول تموضع الصور، انظر [تموضع الصور والجداول](/latex/ar/alashkal-waljdawl/02-positioning-images-and-tables.md)

&#x20;[افتح مثال الصور في Overleaf](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## إضافة التعليقات التوضيحية، والتوسيم، والإحالة المرجعية

تُعد إضافة وصف موجز للصور ووضع تسميات لها بغرض الإحالة اللاحقة أداتين مهمتين عند العمل على نص طويل.

### التعليقات التوضيحية

لنبدأ بمثال على تعليق توضيحي:

```latex
\begin{figure}[h]
\caption{Example of a parametric plot ($\sin (x), \cos(x), x$)}
\centering
\includegraphics[width=0.5\textwidth]{spiral}
\end{figure}
```

![مثال على رسم بارامتري](/files/7c9fc48aed229ff54ec229b12d6b774ed0c6ff13)

الأمر سهل جدًا، فقط أضف `\caption{Some caption}` واكتب داخل الأقواس النص المطلوب عرضه. يعتمد موضع التعليق على مكان وضع الأمر؛ فإذا كان فوق `\includegraphics` فسيوضع التعليق فوقه، وإذا كان أسفله فسيُضبط التعليق أيضًا أسفل الشكل.

يمكن أيضًا وضع التعليقات مباشرة بعد الأشكال. وتستخدم `sidecap` الحزمة كودًا مشابهًا للكود في المثال السابق لتحقيق ذلك.

```latex
\documentclass{article}
\usepackage[rightcaption]{sidecap}

\usepackage{graphicx} %حزمة لإدارة الصور
\graphicspath{ {images/} }

\begin{SCfigure}[0.5][h]
\caption{استخدام صورة الكون مرة أخرى.
سيكون هذا التعليق على اليمين}
\includegraphics[width=0.6\textwidth]{universe}
\end{SCfigure}
```

![مثال على رسم بارامتري مع تعليق](/files/ee908f8e01419b713e4fa723566dae3dcfa01385)

هناك أمران جديدان

**\usepackage\[rightcaption]{sidecap}**

كما قد تتوقع، سيستورد هذا السطر حزمة باسم sidecap، ولكن هناك معامل إضافي: rightcaption. يحدد هذا المعامل موضع التعليق على يمين الصورة، ويمكنك أيضًا استخدام leftcaption. وفي المستندات الشبيهة بالكتب تتوفر أيضًا outercaption وinnercaption. وهذه الأسماء واضحة الدلالة.

**\begin{SCfigure}\[0.5]\[h] \end{SCfigure}**

يُعرّف بيئة مشابهة لـ figure. المعامل الأول هو عرض التعليق نسبةً إلى حجم الصورة، كما هو مُعلن في \includegraphics. أما المعامل الثاني h فيعمل تمامًا كما في بيئة figure. انظر قسم التموضع لمزيد من المعلومات.

يمكنك إجراء إدارة أكثر تقدمًا لتنسيق التعليق. راجع [قراءات إضافية](#further-reading) قسم المراجع.

### الملصقات والإحالات المرجعية

يمكن الإشارة إلى الأشكال، مثلها مثل العديد من العناصر الأخرى في مستند LaTeX (المعادلات، الجداول، الرسوم، إلخ)، داخل النص. وهذا سهل جدًا، فقط أضف `\label` إلى `figure` أو `SCfigure` البيئة، ثم استخدم تلك التسمية لاحقًا للإشارة إلى الصورة.

```latex
\begin{figure}[h]
    \centering
    \includegraphics[width=0.25\textwidth]{mesh}
    \caption{a nice plot}
    \label{fig:mesh1}
\end{figure}

كما ترى في الشكل \ref{fig:mesh1}، فإن
الدالة تزداد قرب الصفر. وكذلك، في الصفحة \pageref{fig:mesh1}
يوجد المثال نفسه.
```

![مثال على شكل مع تسمية](/files/9eae461ec7a2adcb29597ccc39b63f9b1673b8ec)

هناك ثلاثة أوامر تُنشئ إحالات مرجعية في هذا المثال.

**\label{fig:mesh1}**

سيؤدي هذا إلى تعيين تسمية لهذا الشكل. وبما أن التسميات يمكن استخدامها في عدة أنواع من العناصر داخل المستند، فمن الممارسات الجيدة استخدام بادئة، مثل fig: في المثال.

**\ref{fig:mesh1}**

سيُدرج هذا الأمر الرقم المخصّص للشكل. ويتم إنشاؤه تلقائيًا وسيُحدَّث إذا أُدرج شكل آخر قبل الشكل المشار إليه.

**\pageref{fig:mesh1}**

يطبع هذا رقم الصفحة التي تظهر فيها الصورة المشار إليها.

ال `\caption` إلزامي للإشارة إلى شكل.

ميزة رائعة أخرى في مستند LaTeX هي القدرة على إنشاء *قائمة بالأشكال*. وهذا أمر بسيط.

```latex
\listoffigures
```

![مثال على قائمة الأشكال](/files/21f1298f7b58cb3e52a18d3da30f5d55aaeda338)

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

ملاحظة مهمة: عند استخدام الإحالات المرجعية، يجب تجميع مشروع LaTeX مرتين، وإلا فلن تعمل الإحالات، وإحالات الصفحات، وقائمة الأشكال — ويتولى Overleaf ذلك نيابةً عنك.

## إنشاء صور عالية الدقة ومنخفضة الدقة

حتى الآن، عند تحديد اسم ملف الصورة في `\includegraphics` الأمر، كنا نحذف الامتدادات. ومع ذلك، فهذا ليس ضروريًا، رغم أنه غالبًا ما يكون مفيدًا. إذا حُذف امتداد الملف، فسيبحث LaTeX عن أي صيغة صورة مدعومة في ذلك الدليل، وسيبحث عن امتدادات مختلفة بالترتيب الافتراضي (ويمكن تعديله).

هذا مفيد عند الانتقال بين بيئة التطوير وبيئة الإنتاج. في بيئة التطوير (عندما تكون المقالة/التقرير/الكتاب ما يزال قيد الإنجاز)، من المرغوب استخدام نسخ منخفضة الدقة من الصور (عادة بصيغة .png) لتسريع تجميع المعاينة. أما في بيئة الإنتاج (عندما تُنتَج النسخة النهائية من المقالة/التقرير/الكتاب)، فمن المرغوب تضمين النسخة عالية الدقة من الصور.

ويتحقق ذلك عن طريق

* عدم تحديد امتداد الملف في *\includegraphics* الأمر، و
* تحديد الامتداد المطلوب في المقدمة.

وبالتالي، إذا كانت لدينا نسختان من صورة، venndiagram.pdf (عالية الدقة) وvenndiagram.png (منخفضة الدقة)، فيمكننا تضمين السطر التالي في المقدمة لاستخدام نسخة .png أثناء تطوير التقرير -

```latex
  \DeclareGraphicsExtensions{.png,.pdf}
```

سيضمن الأمر أعلاه أنه إذا وُجد ملفان لهما الاسم الأساسي نفسه لكن بامتدادات مختلفة (على سبيل المثال venndiagram.pdf وvenndiagram.png)، فسيُستخدم إصدار .png أولًا، وعند غيابه سيُستخدم إصدار .pdf، وهذه أيضًا فكرة جيدة إذا كانت بعض النسخ منخفضة الدقة غير متاحة.

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

```latex
  \DeclareGraphicsExtensions{.pdf,.png}
```

وبالتحسين على التقنية الموضحة في الفقرات السابقة، يمكننا أيضًا أن نُصدر إلى LaTeX أمرًا بإنشاء نسخ .png منخفضة الدقة من الصور تلقائيًا أثناء تجميع المستند إذا كان هناك ملف PDF لم يُحوَّل إلى PNG بعد. ولتحقيق ذلك، يمكننا تضمين ما يلي في المقدمة بعد `\usepackage{graphicx}`

```latex
  \usepackage{epstopdf}
  \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile}
  \DeclareGraphicsExtensions{.png,.pdf}
```

إذا كان venndiagram2.pdf موجودًا ولكن venndiagram2.png غير موجود، فسيتم إنشاء الملف venndiagram2-pdf-converted-to.png وتحميله بدلًا منه. الأمر *convert #1* مسؤول عن التحويل، ويمكن تمرير معاملات إضافية بين *convert* و *#1*. على سبيل المثال - *convert -density 100 #1*.

لكن هناك بعض الأمور المهمة التي ينبغي وضعها في الاعتبار:

* لكي يعمل التحويل التلقائي، نحتاج إلى استدعاء *pdflatex* مع `--shell-escape` .
* أما بالنسبة إلى *الإنتاج* النسخة النهائية، فيجب علينا التعليق على `\epstopdfDeclareGraphicsRule`، بحيث يتم تحميل ملفات PDF عالية الدقة فقط. وسنحتاج أيضًا إلى تغيير ترتيب الأولوية.

&#x20;[افتح مثال الصور في Overleaf](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## دليل المراجع

**وحدات LaTeX والأطوال**

| الاختصار     | التعريف                                          |
| ------------ | ------------------------------------------------ |
| pt           | النقطة هي وحدة الطول الافتراضية. حوالي 0.3515 مم |
| mm           | ملليمتر                                          |
| cm           | سنتيمتر                                          |
| في           | بوصة                                             |
| ex           | ارتفاع **x** في الخط الحالي                      |
| em           | عرض **m** في الخط الحالي                         |
| \columnsep   | المسافة بين الأعمدة                              |
| \columnwidth | عرض العمود                                       |
| \linewidth   | عرض السطر في البيئة الحالية                      |
| \paperwidth  | عرض الصفحة                                       |
| \paperheight | ارتفاع الصفحة                                    |
| \textwidth   | عرض النص                                         |
| \textheight  | ارتفاع النص                                      |
| \unitlength  | وحدات الطول في *الصورة* البيئة.                  |

**حول أنواع الصور في LaTeX**

**latex**

عند التجميع باستخدام latex، لا يمكننا استخدام إلا صور EPS، وهي صيغة متجهية.

**pdflatex**

إذا كنا نجمع باستخدام "pdflatex" لإنتاج ملف PDF، فيمكننا استخدام عدد من صيغ الصور -

```
   JPG: الخيار الأفضل إذا أردنا إدراج صور فوتوغرافية
   PNG: الخيار الأفضل إذا أردنا إدراج الرسوم التخطيطية (إذا تعذّر إنشاء نسخة متجهية) ولقطات الشاشة
   PDF: رغم أننا معتادون على رؤية مستندات PDF، فإن ملف PDF يمكنه أيضًا تخزين الصور
   EPS: يمكن تضمين صور EPS باستخدام الحزمة epstopdf (نحن فقط بحاجة إلى تثبيت الحزمة، ونحن
        لا نحتاج إلى استخدام \usepackage{} لتضمينها في مستندنا.)
```

**صيغة متجهية أم صيغة نقطية؟**

يمكن أن تكون الصور إما بصيغة متجهية أو بصيغة نقطية. عمومًا لا نحتاج إلى القلق بشأن ذلك، لكن إذا عرفنا بالفعل الصيغة التي تكون عليها الصورة، فيمكننا استخدام هذه المعلومة لاختيار صيغة مناسبة لتضمينها في مستند LaTeX. إذا كانت الصورة بصيغة متجهية، فينبغي أن نختار PDF أو EPS. وإذا كانت بصيغة نقطية، فينبغي أن نختار JPG أو PNG، لأن تخزين الصور النقطية في PDF أو EPS يستهلك مساحة كبيرة من القرص.

&#x20;[افتح مثال الصور في Overleaf](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

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

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

* [تموضع الصور والجداول](/latex/ar/alashkal-waljdawl/02-positioning-images-and-tables.md)
* [قوائم الجداول والأشكال](/latex/ar/alashkal-waljdawl/03-lists-of-tables-and-figures.md)
* [المستندات أحادية الوجه ومزدوجة الوجه](/latex/ar/altnsyq/08-single-sided-and-double-sided-documents.md)
* [الأطوال في LaTeX](/latex/ar/altnsyq/01-lengths-in-latex.md)
* [**floatrow** حزمة لإدارة متقدمة للتعليقات التوضيحية للعناصر العائمة (الجداول والأشكال)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf)
* [**sidecap** توثيق الحزمة، لعناوين الأشكال الجانبية](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf)
* [**epstopdf** توثيق الحزمة (تحويل EPS إلى PDF)](https://ctan.org/pkg/epstopdf?lang=en)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ar/mzyd-mn-almwdhwaat/27-inserting-images.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.
