> 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/altnsyq/13-using-colors-in-latex.md).

# استخدام الألوان في LaTeX

## مقدمة

تشرح هذه المقالة كيفية استخدام الألوان في مستند LaTeX الخاص بك عبر [`color`](https://ctan.org/pkg/color?lang=en) أو [`xcolor`](https://ctan.org/pkg/xcolor?lang=en) الحزم. لاحظ أن وثائق مستوى المستخدم الخاصة بـ `color` الحزمة موجودة في [حزمة الرسومات القياسية في LaTeX](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf).

توفّر كلتا الحزمتين مجموعة مشتركة من الأوامر لمعالجة الألوان، ولكن `xcolor` أكثر مرونة وتدعم عددًا أكبر من نماذج الألوان، لذا فهي النهج الموصى به.

سنبدأ بالمثال التالي:

```latex
\documentclass{article}
\usepackage{xcolor}
\begin{document}
يعرض هذا المثال بعض الحالات لاستخدام الحزمة \texttt{xcolor}
لتغيير لون العناصر في \LaTeX.

\begin{itemize}
\color{blue}
\item العنصر الأول
\item العنصر الثاني
\end{itemize}

\noindent
{\color{red} \rule{\linewidth}{0.5mm}}
\end{document}
```

[افتح هذا `xcolor` المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=A+basic+xcolor+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxcolor%7D%0A%5Cbegin%7Bdocument%7D%0AThis+example+shows+some+instances+of+using+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+elements+in+%5CLaTeX.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Ccolor%7Bblue%7D%0A%5Citem+First+item%0A%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7Bred%7D+%5Crule%7B%5Clinewidth%7D%7B0.5mm%7D%7D%0A%5Cend%7Bdocument%7D)

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

![مثال على استخدام حزمة xcolor في LaTeX](/files/636fa1d4718a4710a434473be7fb89bceeac2541)

في هذا المثال، يتم استيراد الحزمة `xcolor` بـ

```latex
\usepackage{xcolor}
```

ثم الأمر `\color{blue}` يحدد `blue` لون كتلة النص الحالية. في هذه الحالة لـ `itemize` البيئة.

الكود المستخدم لصفّ الخط الأفقي الذي تم إنشاؤه بواسطة `\rule{\linewidth}{0.5mm}` موجود ضمن مجموعة، محددة بـ { و }، وذلك للإبقاء على تأثير `\color{red}` محليًا داخل تلك المجموعة.

## الألوان المسماة التي توفرها حزمة xcolor

كما هو مذكور في [وثائق حزمة xcolor](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf)، فإن الألوان المسماة التالية متاحة دائمًا دون الحاجة إلى تحميل أي خيارات للحزمة:

![قائمة الألوان في حزمة xcolor](/files/346f1bcd0c2f6bf784aaea341740aad118891a24)

### الوصول إلى ألوان مسماة إضافية

يمكن الوصول إلى ألوان مسماة إضافية عبر خيارات الحزمة التالية `xcolor` :

* `dvipsnames`: يحمّل 68 لونًا مسمى (CMYK)
* `svgnames`: يحمّل 151 لونًا مسمى (RGB)
* `x11names`: يحمّل 317 لونًا مسمى (RGB)

على سبيل المثال، إذا كتبت

```latex
\usepackage[dvipsnames]{xcolor}
```

يمكنك الوصول إلى الألوان المسماة التالية:

![الألوان المحمّلة بواسطة خيار dvipsnames في حزمة xcolor](/files/521926beabcbeff42a67757cf65b2491f14d3db4)

ارجع إلى [وثائق حزمة xcolor](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) للاطلاع على قوائم الألوان المجدولة التي توفرها `svgnames` و `x11names` الخيارات.

### مثال على الاستخدام

يستخدم المثال التالي ألوانًا مسماة محمّلة عبر `dvipsnames` .

```latex
\documentclass{article}
\usepackage[dvipsnames]{xcolor}
\begin{document}
يبيّن هذا المثال كيفية استخدام حزمة \texttt{xcolor}
لتغيير لون عناصر الصفحة في \LaTeX{}.

\begin{itemize}
\color{ForestGreen}
\item العنصر الأول
\item العنصر الثاني
\end{itemize}

\noindent
{\color{RubineRed} \rule{\linewidth}{0.5mm}}

يمكن أيضًا تعيين لون خلفية النص \textcolor{red}{بسهولة}. على
سبيل المثال، يمكنك استخدام \colorbox{BurntOrange}{خلفية برتقالية} ثم متابعة الكتابة.
\end{document}
```

[افتح هذا `**xcolor**` المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+xcolor+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%5Cbegin%7Bdocument%7D%0AThis+example+shows+how+to+use+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Ccolor%7BForestGreen%7D%0A%5Citem+First+item%0A%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B0.5mm%7D%7D%0A%0AThe+background+color+of+text+can+also+be+%5Ctextcolor%7Bred%7D%7Beasily%7D+set.+For+%0Ainstance%2C+you+can+change+use+an+%5Ccolorbox%7BBurntOrange%7D%7Borange+background%7D+and+then+continue+typing.%0A%5Cend%7Bdocument%7D)

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

![عرض توضيحي لحزمة xcolor](/files/cb5d119388722cc96b3164e3a39b2513494be32a)

يُستخدم أيضًا في المثال أمران جديدان:

* `\textcolor{red}{بسهولة}`: يغيّر لون النص داخل السطر. يأخذ هذا الأمر وسيطين: اللون المراد استخدامه والنص الذي سيتم تغيير لونه. في المثال، الكلمة `بسهولة` تُعرض باللون `أحمر`.
* `\colorbox{BurntOrange}{خلفية برتقالية}`: يغيّر لون خلفية النص الممرر كوسيط ثانٍ. في المثال أعلاه، تظهر الكلمات `خلفية برتقالية` مصفوفة على خلفية بلون `BurntOrange`.

## تحميل الألوان المسماة واستخدامها في حزمة color

يمكنك أيضًا استخدام `color` الحزمة وتحميل الألوان المسماة عبر خيارها `usenames` و `dvipsnames` :

```latex
\usepackage[usenames,dvipsnames]{color}
```

يستخدم الكود التالي حزمة `color` لتطبيق الألوان المسماة نفسها المستخدمة في المثال السابق `xcolor` لحزمة

```latex
\documentclass{article}
\usepackage[usenames,dvipsnames]{color} % استخدام حزمة color، وليس xcolor
\begin{document}
يوضح هذا المثال كيفية استخدام حزمة \texttt{\bfseries color}
لتغيير لون عناصر الصفحة في \LaTeX{}.

\begin{itemize}
\color{ForestGreen}
\item العنصر الأول
\item العنصر الثاني
\end{itemize}

\noindent
{\color{RubineRed} \rule{\linewidth}{0.5mm}}

يمكن أيضًا تعيين لون خلفية النص \textcolor{red}{بسهولة}. على
سبيل المثال، يمكنك استخدام \colorbox{BurntOrange}{خلفية برتقالية} ثم متابعة الكتابة.
\end{document}
```

[افتح هذا `**color**` المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+color+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Busenames%2Cdvipsnames%5D%7Bcolor%7D+%25using+the+color+package%2C+not+xcolor%0A%5Cbegin%7Bdocument%7D%0AThis+example+shows+how+to+use+the+%5Ctexttt%7B%5Cbfseries+color%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Ccolor%7BForestGreen%7D%0A%5Citem+First+item%0A%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B0.5mm%7D%7D%0A%0AThe+background+color+of+text+can+also+be+%5Ctextcolor%7Bred%7D%7Beasily%7D+set.+For+%0Ainstance%2C+you+can+change+use+an+%5Ccolorbox%7BBurntOrange%7D%7Borange+background%7D+and+then+continue+typing.%0A%5Cend%7Bdocument%7D)

ينتج هذا المثال نفس المخرجات مثل السابق `xcolor` الإصدار:

![عرض توضيحي لحزمة color](/files/e1711b4616573ec141579b1735845560778e1c90)

## برامج التشغيل والألوان

لم يكن استخدام الألوان عند تنضيد النص أو الرياضيات جزءًا من التصميم الأصلي لـ TeX؛ بل أُسند استخدام/تطبيق الألوان إلى برامج تشغيل خارجية كانت تحوّل صيغة ملف الإخراج الأصلية لـ TeX (DVI) إلى PostScript أو PDF. ولكي يعمل اللون، كان يجب «حقن» تعليمات خاصة ببرنامج التشغيل في مخرجات TeX باستخدام أمر مدمج في TeX يُسمّى `\special` وتتمثل مهمته ببساطة في السماح بمرور الكود/البيانات عبر عملية التنضيد وتضمينها في ملف الإخراج. وعندما يعالج برنامج التشغيل المختار (البرنامج) المخرجات المنضدة، فإنه سيكتشف الكود/البيانات المضمنة ويتصرف بناءً عليها لتحقيق ما قصده المستخدم—مثل استخدام الألوان.

لقد تغيّرت الأمور، وأصبح PDF الآن إلى حد بعيد أكثر صيغ الإخراج شيوعًا التي تستخدمها محركات TeX، وقد حلّ منذ زمن طويل محل استخدام برامج تشغيل DVI القديمة وإنشاء PostScript. كما أصبح لدى المستخدمين خيار أوسع من محركات TeX لاستخدامها في تنضيد مستندات LaTeX الخاصة بهم، وأبرزها pdfTeX وXeTeX أو LuaTeX/LuaHBTeX، لذا لا يزال من المهم مراعاة الاختلافات بين تلك المحركات—والتأكد من استخدام الآليات الصحيحة لإدراج بيانات اللون (تعليمات PDF) في ملفات PDF الخاصة بها. ولدعم صيغة إخراج DVI القديمة واستيعابها، وكذلك البيئة الأوسع من محركات TeX وسير العمل المستخدمة، يمكنك، إذا لزم الأمر، تهيئة `color` أو `xcolor` الحزم لاستخدام برنامج تشغيل معيّن بحيث يقوم LaTeX بتوليد بيانات اللون بالطريقة المناسبة.

### برامج التشغيل الخاصة بـ color وxcolor

ال `color` توفر الحزمة دعمًا جاهزًا لخيارات برنامج التشغيل التالية:

* `dvipdfmx`, `dvips`, `dvisvgm`, `luatex`, `pdftex` و `xetex`

توجد خيارات أخرى كما هو موضح في [`color` توثيق الحزمة](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/required/graphics/grfguide.pdf).

ال `xcolor` توفر الحزمة خيارات برنامج التشغيل التالية:

* `dvips`, `xdvi`, `dvipdf`, `dvipdfm`, `dvipdfmx`, `luatex`, `pdftex`, `dvipsone`, `dviwindo`, `emtex`, `dviwin`, `oztex`, `textures`, `pctexps`, `pctexwin`, `pctexhp`, `pctex32`, `truetex`, `tcidvi`, `vtex` و `xetex`.

### الاكتشاف التلقائي لبرنامج تشغيل الألوان

عند تنضيد مستندك، يقرأ LaTeX ملف إعدادات يُسمّى `color.cfg` يحتوي على كود يمكنه تحديد ما إذا كنت تستخدم pdfTeX أو XeTeX أو LuaTeX ويحمّل تلقائيًا برنامج التشغيل المناسب (`.def` ملف) نيابةً عنك، لذلك لا تحتاج إلى *تحتاج* تحديد خيار برنامج التشغيل للحزمة لتلك المحركات.

### مثال أكثر تقدمًا يستخدم برنامج التشغيل dvisvgm لإنشاء ملف SVG

يستخدم المثال التالي `color` الحزمة مع خيارات تحمل الألوان المسماة و `dvisvgm` برنامج التشغيل لإخراج تعريفات/بيانات الألوان باستخدام كود SVG:

```latex
\usepackage[dvisvgm, usenames, dvipsnames]{color}
```

وبالتحديد، يتم تحويل ملف الإخراج المنضد بواسطة Overleaf إلى SVG باستخدام برنامج يُسمّى [`dvisvgm`](https://dvisvgm.de/)، وهو جزء من TeX Live ومتاح على خوادمنا. ولتشغيل `dvisvgm`، بعد تنضيد الصفحة، نستخدم [`latexmkrc` قابل للتحرير](/latex/ar/mqalat-mtamqh/28-how-to-use-latexmkrc-with-overleaf.md) الذي يتم إنشاؤه عند فتح الكود التالي في Overleaf:

```latex
\documentclass{article}
\usepackage[dvisvgm, usenames, dvipsnames]{color}
\title{إنشاء رسومات SVG}
\author{Overleaf}
\begin{document}
\maketitle
مرحبًا، {\color{Apricot}باللون Apricot} والآن باللون {\color{DarkOrchid} DarkOrchid}، ولكن ربما سيبدو أجمل إذا استخدمنا {\color{JungleGreen}JungleGreen}—أم لا؟
\end{document}
```

[افتح هذا المثال لإنشاء ملف SVG](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvisvgm%2C+usenames%2C+dvipsnames%5D%7Bcolor%7D%0A%5Ctitle%7BCreating+SVG+graphics%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AHello%2C+%7B%5Ccolor%7BApricot%7Din+Apricot%7D+and+now+in+%7B%5Ccolor%7BDarkOrchid%7D+DarkOrchid%7D+but+perhaps+it+might+look+nicer+if+we+use+%7B%5Ccolor%7BJungleGreen%7DJungleGreen%7D---or+may+not%3F%0A%5Cend%7Bdocument%7D\&snip_name\[]=latexmkrc\&snip\[]=END+%7B%0Asystem%28%22dvisvgm+-n+-o+mygraphic.svg+.%2Foutput.dvi%22%29%0A%7D\&main_document=main.tex)

بمجرد أن ينتهي Overleaf من التجميع، يمكنك الوصول إلى الرسم SVG المسمّى `mygraphic.svg`، عبر اختيار `السجلات والمخرجات` واختيار `سجلات وملفات أخرى` القائمة المنسدلة:

![الوصول إلى ملف تم إنشاؤه على Overleaf](/files/9ffb665d24c66170fecfec7cfe1dfc9d8706e0e2)

## إنشاء ألوانك الخاصة

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

```latex
\documentclass{article}
\usepackage[dvipsnames]{xcolor}

\definecolor{mypink1}{rgb}{0.858, 0.188, 0.478}
\definecolor{mypink2}{RGB}{219, 48, 122}
\definecolor{mypink3}{cmyk}{0, 0.7808, 0.4429, 0.1412}
\definecolor{mygray}{gray}{0.6}

\begin{document}
ألوان يعرّفها المستخدم باستخدام نماذج ألوان مختلفة:

\begin{enumerate}
\item \textcolor{mypink1}{وردي بـ rgb}
\item \textcolor{mypink2}{وردي بـ RGB}
\item \textcolor{mypink3}{وردي بـ cmyk}
\item \textcolor{mygray}{رمادي بـ gray}
\end{enumerate}
\end{document}
```

[افتح هذا المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+user-defined+colours\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%0A%5Cdefinecolor%7Bmypink1%7D%7Brgb%7D%7B0.858%2C+0.188%2C+0.478%7D%0A%5Cdefinecolor%7Bmypink2%7D%7BRGB%7D%7B219%2C+48%2C+122%7D%0A%5Cdefinecolor%7Bmypink3%7D%7Bcmyk%7D%7B0%2C+0.7808%2C+0.4429%2C+0.1412%7D%0A%5Cdefinecolor%7Bmygray%7D%7Bgray%7D%7B0.6%7D%0A%0A%5Cbegin%7Bdocument%7D%0AUser-defined+colors+with+different+color+models%3A%0A%0A%5Cbegin%7Benumerate%7D%0A%5Citem+%5Ctextcolor%7Bmypink1%7D%7BPink+with+rgb%7D%0A%5Citem+%5Ctextcolor%7Bmypink2%7D%7BPink+with+RGB%7D%0A%5Citem+%5Ctextcolor%7Bmypink3%7D%7BPink+with+cmyk%7D%0A%5Citem+%5Ctextcolor%7Bmygray%7D%7BGray+with+gray%7D%0A%5Cend%7Benumerate%7D%0A%5Cend%7Bdocument%7D)

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

![مثال في LaTeX لإنشاء ألوان يعرّفها المستخدم](/files/f84f747a5c9299896a08cd3a4e649826a2fc3635)

الأمر `\definecolor` يأخذ ثلاثة معاملات: اسم اللون الجديد، والنموذج، وتعريف اللون. وبصورة تقريبية، يمثّل كل رقم مقدار كل لون تضيفه إلى المزيج الذي يشكّل اللون النهائي.

* `**rgb**`: الأحمر، الأخضر، الأزرق. تحدد ثلاث قيم مفصولة بفواصل بين 0 و1 مكونات اللون.
* `**RGB**`: مثل `rgb`، لكن الأرقام أعداد صحيحة بين 0 و255.
* `**cmyk**`: السماوي والأرجواني والأصفر والأسود. قائمة من أربعة أرقام مفصولة بفواصل بين 0 و1 تحدد اللون وفقًا لـ [نموذج CMYK الطارح](https://en.wikipedia.org/wiki/CMYK_color_model) المستخدم لدى الطابعات التجارية.
* `**gray**`: تدرج الرمادي. رقم واحد بين 0 و1.

في المثال، `mypink1`, `mypink2` و `mypink3` تعرّف اللون نفسه ولكن بنماذج مختلفة. ويمكنك فعليًا أن ترى أن اللون المعرّف بواسطة `cmyk` يختلف قليلًا.

يمكن لاحقًا استخدام الألوان المعرّفة بأي من النموذجين داخل مستندك ليس فقط لضبط لون النص، بل لأي عنصر آخر يقبل اللون كمعامل، مثل [الجداول](/latex/ar/alashkal-waljdawl/01-tables.md#colouring-a-table-28cells2c-rows2c-columns-and-lines29) (يجب أن تضيف خيار `table` إلى `xcolor`), [العناصر الرسومية التي أُنشئت باستخدام TikZ](/latex/ar/alashkal-waljdawl/05-tikz-package.md), [الرسوم البيانية](/latex/ar/khas-balmjal/08-pgfplots-package.md), [المسطّرات العمودية في المستندات متعددة الأعمدة](/latex/ar/altnsyq/09-multiple-columns.md#inserting-vertical-rulers) و [قوائم الشيفرة](/latex/ar/altnsyq/11-code-listing.md#code-styles-and-colours).

### نماذج الألوان الخاصة بـ xcolor فقط

ال `xcolor` توفر الحزمة أوامر إضافية تدعم المزيد من نماذج الألوان وخلط الألوان بطريقة سهلة، كما يوضح المثال التالي:

```latex
\documentclass{article}
\usepackage[dvipsnames]{xcolor}
\colorlet{LightRubineRed}{RubineRed!70}
\colorlet{Mycolor1}{green!10!orange}
\definecolor{Mycolor2}{HTML}{00F9DE}
\begin{document}
يعرض هذا المستند عدة أمثلة تبيّن كيفية استخدام حزمة \texttt{xcolor}
لتغيير لون عناصر الصفحة في \LaTeX{}.

\begin{itemize}
\item \textcolor{Mycolor1}{العنصر الأول}
\item \textcolor{Mycolor2}{العنصر الثاني}
\end{itemize}

\noindent
{\color{LightRubineRed} \rule{\linewidth}{1mm}}

\noindent
{\color{RubineRed} \rule{\linewidth}{1mm}}
\end{document}
```

[افتح هذا المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Custom+colours+with+xcolor\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%5Ccolorlet%7BLightRubineRed%7D%7BRubineRed%2170%7D%0A%5Ccolorlet%7BMycolor1%7D%7Bgreen%2110%21orange%7D%0A%5Cdefinecolor%7BMycolor2%7D%7BHTML%7D%7B00F9DE%7D%0A%5Cbegin%7Bdocument%7D%0AThis+document+presents+several+examples+showing+how+to+use+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Ctextcolor%7BMycolor1%7D%7BFirst+item%7D%0A%5Citem+%5Ctextcolor%7BMycolor2%7D%7BSecond+item%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BLightRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%5Cend%7Bdocument%7D)

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

![ألوان مخصّصة تنتجها حزمة xcolor](/files/3f9c672c00dc142a2742b924f5a5a61f8f146e27)

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

* `\colorlet{LightRubineRed}{RubineRed!70}`: لون جديد باسم `LightRubineRed` يتم إنشاؤه، ويبلغ هذا اللون 70% من شدة اللون الأصلي `RubineRed` يمكن اعتباره مزيجًا من 70% RubineRed و30% أبيض. يتيح لك تعريف الألوان بهذه الطريقة اشتقاق درجات مختلفة من لون أساسي—وهو أمر شائع في العلامات التجارية للشركات. في المثال، يمكنك رؤية اللون الأصلي `RubineRed` والجديد `LightRubineRed` مستخدمين في خطين أفقيين متتاليين.
* `\colorlet{Mycolor1}{green!10!orange}`: لون باسم `Mycolor1` يتم إنشاؤه باستخدام 10% أخضر و90% برتقالي.
* `\definecolor{Mycolor2}{HTML}{00F9DE}`: اللون `Mycolor2` يتم إنشاؤه باستخدام `HTML` النموذج. يجب إنشاء الألوان في هذا النموذج باستخدام 6 أرقام ست عشرية، ويجب أن تكون الحروف A وB وC وD وE وF بحروف كبيرة.

نماذج الألوان التي يدعمها فقط `xcolor` هي:

* `cmy`السماوي، الأرجواني، الأصفر
* `hsb`درجة اللون، التشبع، السطوع
* `HTML`RRGGBB
* `Gray`تدرج رمادي، رقم بين 1 و15.
* `wave`الطول الموجي، رقم بين 363 و814. يمثّل الرقم طول موجة الضوء، بالنانو متر (nm)

## تعيين لون خلفية الصفحة

يمكن تغيير لون خلفية الصفحة بأكملها بسهولة باستخدام `\pagecolor`. يوضّح الكود التالي ذلك، باستخدام نص من مثال سابق::

```latex
\documentclass{article}
\usepackage[dvipsnames]{xcolor}
\colorlet{LightRubineRed}{RubineRed!70}
\colorlet{Mycolor1}{green!10!orange}
\definecolor{Mycolor2}{HTML}{00F9DE}
\begin{document}
\pagecolor{black}
\color{white}% تعيين اللون الافتراضي إلى الأبيض
يعرض هذا المستند عدة أمثلة تبيّن كيفية استخدام حزمة \texttt{xcolor}
لتغيير لون عناصر الصفحة في \LaTeX{}.

\begin{itemize}
\item \textcolor{Mycolor1}{العنصر الأول}
\item \textcolor{Mycolor2}{العنصر الثاني}
\end{itemize}

\noindent
{\color{LightRubineRed} \rule{\linewidth}{1mm}}

\noindent
{\color{RubineRed} \rule{\linewidth}{1mm}}
\end{document}
```

[افتح هذا المثال في Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Custom+colors+with+xcolor\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%5Ccolorlet%7BLightRubineRed%7D%7BRubineRed%2170%7D%0A%5Ccolorlet%7BMycolor1%7D%7Bgreen%2110%21orange%7D%0A%5Cdefinecolor%7BMycolor2%7D%7BHTML%7D%7B00F9DE%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cpagecolor%7Bblack%7D%0A%5Ccolor%7Bwhite%7D%25+set+the+default+colour+to+white%0AThis+document+presents+several+examples+showing+how+to+use+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Ctextcolor%7BMycolor1%7D%7BFirst+item%7D%0A%5Citem+%5Ctextcolor%7BMycolor2%7D%7BSecond+item%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BLightRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%5Cend%7Bdocument%7D)

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

![تعيين لون خلفية الصفحة في LaTeX](/files/a3d740730c93373b3231e5c4108835869a1c9a86)

الأمر `\pagecolor{black}` عيّن لون الصفحة إلى `black`. هذا أمر تبديل، ما يعني أنه سيُطبَّق على المستند بالكامل ما لم يُستخدم أمر تبديل آخر لإعادته. `\nopagecolor` سيعيد الخلفية إلى الوضع الطبيعي.

## حزم ألوان إضافية لـ LuaLaTeX

بالإضافة إلى الحزم القياسية `color` و `xcolor` ، يدعم LuaLaTeX الحزمتين [`luacolor`](https://ctan.org/pkg/luacolor?lang=en) و [`lua-ul`](https://ctan.org/pkg/lua-ul?lang=en) — وقد كُتبتا خصيصًا للاستخدام مع LuaLaTeX، ولا تتوافق أي منهما مع pdfLaTeX أو XeLaTeX.

### حزمة luacolor

ال `luacolor` تعيد الحزمة تعريف بعض الأجزاء الداخلية من حزمة `color` باستخدام تقنيات فريدة لمحركات TeX القائمة على LuaTeX.

على الرغم من أن `luacolor` تدمج تلقائيًا `color` الحزمة، إذا أردت القيام بأي مما يلي:

* استخدام خيارات محددة من `color` الحزمة، مثل `\usepackage[usenames,dvipsnames]{color}`، أو
* استخدم `xcolor` الحزمة

تحتاج إلى تحميل `color` أو `xcolor` الحزمة قبل `luacolor`. على سبيل المثال، يمكنك تحميل `color` الحزمة باستخدام:

```latex
\usepackage[usenames,dvipsnames]{color} % خيارات مثال لحزمة الألوان، راجع الوثائق
\usepackage{luacolor} % يتم تحميلها بعد حزمة color
```

أو تحميل `xcolor` الحزمة باستخدام:

```latex
\usepackage[dvipsnames]{xcolor} % خيار مثال لحزمة xcolor، راجع الوثائق
\usepackage{luacolor} % يتم تحميلها بعد حزمة xcolor
```

راجع وثائق [`color`](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) و [`xcolor`](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) للاطلاع على تفاصيل خيارات الحزمة.

من خلال الاستفادة من قدرات LuaLaTeX، `luacolor` تمكّن من تطبيقات أكثر تقدمًا للألوان؛ على سبيل المثال، تلوين الرموز الفردية داخل لغات الكتابة المعقدة أو تطبيق اللون على العلامات التشكيلية. `luacolor` كما تتجنب أيضًا مشكلات التباعد الحرفي عند تطبيق اللون على الأحرف المفردة—راجع أسئلة tex.stackexchange [هنا](https://tex.stackexchange.com/questions/622544/kerning-when-coloring-single-letters) و [هنا](https://tex.stackexchange.com/questions/567220/kerning-with-xcolor) لأمثلة على ذلك.

### حزمة lua-ul

ذُكرت هذه الحزمة لأنها تحتوي على ميزات لتسليط الضوء بالألوان. وهي تستفيد من القدرات المتقدمة لـ LuaTeX لتوفير التسطير والشطب والتظليل باستخدام طرق لا يتأثر فيها التباعد الحرفي، ويمكن للنص المسطّر أن يستخدم أوامر عشوائية، ويعمل الفصل بين المقاطع، وتُحفظ التراكيب الحرفية.

### مثال: luacolor

هنا، سنوضح استخدام `luacolor` لتلوين نص منضّد بالهندية والعربية مع العلامات التشكيلية المستخدمة على [هذا المثال](https://tex.stackexchange.com/questions/698933/color-breaks-diacritics-stacking)(استنادًا إلى [حزمة babel](/latex/ar/allghat/02-multilingual-typesetting-on-overleaf-using-babel-and-fontspec.md) لتهيئة LuaLaTeX لتنضيد الهندية والعربية باستخدام الخطوط المتوفرة على Overleaf.

```latex
\documentclass{article}

% يُفضَّل عرض صفحة صغير للتجربة
\usepackage[paperwidth=15cm]{geometry}

% استخدم babel مع اللغات العربية والهندية والإنجليزية
% تُحمَّل الإنجليزية أخيرًا، مما يجعلها اللغة الافتراضية
\usepackage[hindi,english]{babel}
\babelprovide[import=ar]{arabic}
% عيّن خط Roman للعربية
\babelfont[arabic]{rm}{Scheherazade}

% عيّن خطي Roman وsans serif للإنجليزية
\babelfont{rm}{Noto Serif}
\babelfont{sf}{Noto Sans}

% عيّن خطي Roman وsans serif للهندية
\babelfont[hindi]{rm}[Language=Default]{Noto Serif Devanagari}
\babelfont[hindi]{sf}[Language=Default]{Noto Sans Devanagari}

% لأننا نريد استخدام خيار "dvipsnames" لـ
% الوصول إلى ألوان مسماة إضافية، يجب أن نحمّل xcolor
% قبل luacolor (راجع وثائق حزمة luacolor)
\usepackage[dvipsnames]{xcolor}
\usepackage{luacolor}

% أنشئ أمرًا مساعدًا لتنضيد الهندية
\newcommand\hinditext[1]{\foreignlanguage{hindi}{#1}}

% أنشئ أمرًا مساعدًا لتنضيد العربية
\newcommand\arabictext[1]{\foreignlanguage{arabic}{#1}}

\usepackage{hyperref}
\hypersetup{
colorlinks=true,
urlcolor=cyan
}
\begin{document}
% تستفيد خطوط Noto من تباعد أسطر أكبر
\setlength{\baselineskip}{14bp}

\section{تلوين النص الهندي}
تترجم Google الكلمة الهندية \textsf{\hinditext{किंकर्तव्यविमूढ़}} إلى
``متحيّر''. باستخدام حزمة \texttt{luacolor} يمكن تلوين الرموز داخل النص الهندي؛ على سبيل المثال \hinditext{किंक\textcolor{purple}{र्तव्यव}\textcolor{green}{िमूढ़}}. ويمكنك أيضًا إضافة اللون إلى الكلمة بأكملها: \hinditext{\textcolor{blue}{किंकर्तव्यविमूढ़}}.

\section{تلوين النص العربي}
% أنشئ بيئة مخصّصة لـ
% تنضيد نص عربي ملوّن
\newenvironment{colorarabic}
{% انضد العربية باستخدام خط أكبر
\fontsize{30}{30}
% عيّن اتجاهات الفقرة والنص من اليمين إلى اليسار
\pardir TRT\textdir TRT}
{}

إليك بعض النص العربي الملوّن:  \begin{colorarabic}
\textcolor{red}{\arabictext{هَذَا}} \arabictext{نَصٌّ عَرَب}\textcolor{green}{\arabictext{ِ}}\arabictext{ي}\textcolor{blue}{\arabictext{ٌّ}}
\end{colorarabic}
\section{تلوين علامات التشكيل}
هذا المثال مبني على \href{https://tex.stackexchange.com/questions/698933/color-breaks-diacritics-stacking}{الكود من tex.stackexchange}.

\vspace{12pt}
\bgroup
\newcommand{\emptydiacritic}{\char"034F}
\fontsize{60}{60}\selectfont
á̀̐{\color{blue}a\emptydiacritic\color{green}́\color{red}̀\color{magenta}̐
\egroup
\end{document}
```

[افتح مثال luacolor هذا في Overleaf.](/latex/ar/altnsyq/13-using-colors-in-latex.md)

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

![ناتج نموذجي باستخدام حزمة luacolor](/files/64fa45662d81b3a0b13f7fcf0c915c08e57370f6)

### مثال: lua-ul

يوضح هذا المثال ما يلي `lua-ul` أوامر الحزمة:

* `\highLight[*color*]{*text to highlight*}` الذي يطبق (الاختياري) `*color*` إلى `*text to highlight*`. لاحظ الحرف الكبير **`L`** في تهجئة `\high**L**ight` للأمر!
* `\LuaULSetHighLightColor{*default color*}`: هذا يحدد `*default color*` المستخدمة في الـ `\highLight` للأمر عندما يكون الوسيط الاختياري `[*color*]` غير محدد.

ملاحظة: يجب أيضًا تحميل الحزمة عند استخدام `luacolor` الحزمة أيضًا يجب أن تُحمَّل عند استخدام `\highLight` الأمر الموفَّر من `lua-ul` الحزمة.

```latex
\documentclass{article}
% يُفضَّل عرض صفحة صغير للتجربة
\usepackage[paperwidth=12cm]{geometry}

\usepackage[dvipsnames]{xcolor} % للوصول إلى بعض الألوان المسماة المستخدمة مع \highLight
\usepackage{luacolor} % مطلوب لاستخدام أمر \highLight الخاص بـ lua-ul
\usepackage{lua-ul}

\usepackage{blindtext}
\begin{document}
% استخدم لون Apricot لتظليل النص
\highLight[Apricot]{\blindtext}

% استخدم \LuaULSetHighLightColor لتعيين الألوان الافتراضية لـ
% الأمر \highLight
\begin{itemize}
    \item \LuaULSetHighLightColor{CornflowerBlue} \highLight{\blindtext[1]}.
    \item \LuaULSetHighLightColor{Goldenrod}\highLight{{\(y=f(x)\)}}
\end{itemize}
\end{document}
```

[افتح هذا `lua-ul` مثال في Overleaf.](https://www.overleaf.com/docs?engine=lualatex\&snip_name=lua-ul+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Prefer+a+small+page+width+for+the+demo%0A%5Cusepackage%5Bpaperwidth%3D12cm%5D%7Bgeometry%7D%0A++%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D+%25+To+access+some+named+colors+used+with+%5ChighLight%0A%5Cusepackage%7Bluacolor%7D+%25+Required+to+use+the+lua-ul+%5ChighLight+command+%0A%5Cusepackage%7Blua-ul%7D+%0A++%0A%5Cusepackage%7Bblindtext%7D%0A%5Cbegin%7Bdocument%7D%0A%25+Use+the+Apricot+color+to+highlight+the+text++%0A%5ChighLight%5BApricot%5D%7B%5Cblindtext%7D+%0A%0A%25+Use+%5CLuaULSetHighLightColor+to+set+default+colors+for+%0A%25+the+%5ChighLight+command%0A%5Cbegin%7Bitemize%7D%0A++++%5Citem+%5CLuaULSetHighLightColor%7BCornflowerBlue%7D+%5ChighLight%7B%5Cblindtext%5B1%5D%7D.%0A++++%5Citem+%5CLuaULSetHighLightColor%7BGoldenrod%7D%5ChighLight%7B%7B%5C%28y%3Df%28x%29%5C%29%7D%7D%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D)

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

![تظليل النص باستخدام حزمة lua-ul](/files/b2b9498839344bc9bb0cdafbec81a600a5d0967d)

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

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

* [ال **color** توثيق الحزمة](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) (أو [الوصول عبر `texdoc.org`](https://texdoc.org/serve/color/5))
* [ال **xcolor** توثيق الحزمة](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) (أو [الوصول عبر `texdoc.org`](https://texdoc.org/serve/xcolor/0))
* [الأطوال في LaTeX](/latex/ar/altnsyq/01-lengths-in-latex.md)
* [أحجام الخطوط، والعائلات، والأنماط](/latex/ar/alkhtwt/01-font-sizes-families-and-styles.md)
* [وجوه الخطوط](/latex/ar/alkhtwt/02-font-typefaces.md)
* [دعم الخطوط الحديثة مع XeLaTeX](/latex/ar/alkhtwt/03-xelatex.md)
* [الجداول](/latex/ar/alashkal-waljdawl/01-tables.md)
* [إدراج الصور](/latex/ar/mzyd-mn-almwdhwaat/27-inserting-images.md)
* [Beamer](/latex/ar/alarwdh-altqdymyh/01-beamer.md)
* [Powerdot](/latex/ar/alarwdh-altqdymyh/02-powerdot.md)
* [الملصقات](/latex/ar/alarwdh-altqdymyh/03-posters.md)


---

# 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/altnsyq/13-using-colors-in-latex.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.