> ## 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.

# إنشاء ملفات PDF سهلة الوصول

مع مرور الوقت، جعلت التحديثات على إمكانات إنشاء ملفات PDF إتاحة الوصول (accessibility) في ملفات PDF أمرًا ممكنًا. وقد مكّنت خطوات مهمة، من بينها [LaTeX Tagging Project](https://latex3.github.io/tagging-project/documentation/)، ملفات PDF المبنية على LaTeX من أن تكون سهلة الوصول أيضًا، ولا تزال التحسينات مستمرة.

<Check>
  إن إصدار [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) على وجه الخصوص هو ما يجعل هذه العملية ممكنة في Overleaf. لاحظ أن **LuaLaTeX** هو المترجم الموصى به عند استخدام MathML.

  يمكنك التأكد من ضبط إعدادات مشروعك وفقًا لذلك من خلال تعلّم كيفية [تغيير المترجمات وإصدارات TeX Live](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

يستند نهجنا إلى حد كبير إلى [تعليمات ملفات PDF سهلة الوصول](https://latex3.github.io/tagging-project/documentation/usage-instructions) الخاصة بمشروع LaTeX، والتي يمكنك الرجوع إليها لمزيد من التفاصيل حول المواضيع التالية.

<Warning>
  لاحظ أن تطبيق هذه الممارسات لا يضمن أن يكون كل عنصر في مشروعك سهل الوصول — راجع قسم الأسئلة الشائعة في هذه الصفحة لمزيد من المعلومات.
</Warning>

### <Icon icon="tag" /> الوسم (Tagging)

في جوهره، وسم ملفات PDF هو عملية تُنشئ تلقائيًا "بنية" يسهل على قارئات الشاشة التعرّف عليها، وتجعل الملف أكثر قابلية للبحث الآن وفي المستقبل. وهي تستفيد من البنية الموجودة التي تحددها شيفرة LaTeX الخاصة بك، بحيث يستطيع قارئ الشاشة التمييز بين عناصر مثل العناوين ونص المتن والأشكال والمعادلات.

يدعم TeX Live 2025 بالكامل الوسوم التلقائية لملفات PDF باستخدام التصريح `\DocumentMetaData`. أضف هذا التصريح قبل `\documentclass`. هناك مفتاحان مهمان في هذا التصريح يؤثران في إمكانات الوسم: `tagging` و`tagging-setup` .

#### **`tagging`**

تأكد من تفعيل الوسم بتعيين المفتاح `tagging` إلى `on`.

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on}
```

#### **`tagging-setup`**

اضبط كيفية وسم مستندك بتغيير قيمة المفتاح `tagging-setup`.

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}
```

<Info>
  في هذا المثال، استخدمنا \`math/setup=mathml-SE\` لوسم عناصر بنية MathML، لكن يمكن تعيينه إلى أي قيمة يدعمها \[\`\tagpdfsetup\`]\([https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf)).
</Info>

### <Icon icon="text-size" /> الأوصاف

إضافةً إلى الوسم التلقائي، قد تحتاج أيضًا إلى إضافة أوصاف لمحتوى العناصر، خاصةً إذا كان مستندك يحتوي على صور و/أو جداول.

#### <Icon icon="image" /> الصور

من السهل إضافة أوصاف أساسية للصور في Overleaf، وهو ما يمكن أن يساعد أيضًا في فهم سياق صور معينة عند الرجوع إلى شيفرة LaTeX. كل ما عليك فعله هو إضافة خيار وصف الصورة المناسب في كل استخدام لـ `\includegraphics`. هناك ثلاثة أنواع رئيسية من الصور يجب التمييز بينها لأغراض إتاحة الوصول: الصور التي تتطلب نصًا بديلًا (alt)، والعناصر الزخرفية (artifacts)، والصور التي تُترجم إلى نص فعلي.

**النص البديل**

تضمن إضافة نص بديل إلى الصور أن يكون للصورة وصف يمكن استخدامه بديلًا نصيًا للعنصر المرئي. استخدم المفتاح `alt` وأدخل قيمة نصية.

```latex title="Alt text example" wrap theme={null}
\includegraphics[width=0.25\linewidth,alt={Macro photo of a green frog's head and hands}]{frog.jpg}
```

**العناصر الزخرفية (Artifacts)**

إذا لم تكن هناك حاجة لأن يلتقط قارئ الشاشة صورةً ما (أي إذا كانت زخرفية بحتة)، فضع عليها علامة عنصر زخرفي. استخدم المفتاح `artifact` دون إسناد قيمة له.

```latex title="Artifact example" wrap theme={null}
\includegraphics[artifact]{.jpg}
```

**النص الفعلي**

إذا كانت الصورة مجرد صورة لحرف Unicode، فضمّن الحرف النصي. استخدم المفتاح `actualtext` وأسند إليه حرفًا واحدًا (بدون أقواس).

```latex title="Actual text example" wrap theme={null}
\includegraphics[actualtext=B]{.jpg}
```

#### <Icon icon="table" /> الجداول

على الرغم من أن الجداول عادةً ما يكون لها نص مرتبط بها، فمن المهم مع ذلك أن يرتبط النص بالأجزاء الصحيحة من الجدول. أضف `\tagpdfsetup` قبل `tabular` أو في التمهيد (preamble) لبدء إعداد جداول مشروعك في Overleaf. هناك نوعان رئيسيان من الجداول يجب التمييز بينهما لأغراض إتاحة الوصول: جداول البيانات وجداول العرض.

**جداول البيانات**

إذا كان الجدول يحتوي على صف رأس واحد على الأقل، فحدّد الصفوف التي تمثّل صفوف الرأس. استخدم المفتاح `table/header-rows` وأدخل سلسلة من الأرقام تقابل مواضع صفوف الرأس.

```latex title="Data table example" theme={null}
\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
Item & Quantity \\\hline
Widgets & 42 \\
Gadgets & 13
\end{tabular}
```

**جداول العرض**

إذا لم يكن المقصود أن يفسّر قارئ الشاشة الجدول على أنه جدول، فضع عليه علامة جدول عرض. استخدم المفتاح `table/tagging=presentation`.

```latex title="Presentation table example" theme={null}
\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}
```

### <Icon icon="comments-question" /> الأسئلة الشائعة

<Accordion title="هل توجد أدوات يمكنها المساعدة في التحقق من أن مستندي سهل الوصول؟">
  نعم، توجد عدة أدوات خارجية، منها [veraPDF](https://verapdf.org/)، يمكنها التحقق من أجزاء PDF/A ومستويات المطابقة. إضافةً إلى ذلك، يمكنك استخدام أداة مثل [WebAIM](https://webaim.org/) لحساب نسبة التباين بين لونين.
</Accordion>

<Accordion title="هل الحزم المستخدمة في مشروعي على Overleaf متوافقة مع هذه الميزات؟">
  يمكنك الرجوع إلى [قائمة حالة الحزم](https://latex3.github.io/tagging-project/tagging-status/) الخاصة بـ LaTeX Tagging Project.
</Accordion>

<Accordion title="هل لا يزال بإمكاني استخدام `beamer`؟ هل تتوفر حزم أخرى للعروض التقديمية؟">
  هناك قيود على استخدام `beamer`؛ اطّلع على [الصنف `ltx-talk`](https://ctan.org/pkg/ltx-talk) التجريبي.
</Accordion>

<Accordion title="هل محرر Overleaf سهل الوصول؟">
  نعم. بصفته تطبيق ويب، يستفيد Overleaf من ميزات إتاحة الوصول ووظائفها في متصفحات الويب الحديثة، والتي يقيّمها خبراء إتاحة الوصول بانتظام. ويُظهر أحدث [نموذج طوعي لإتاحة الوصول للمنتج (VPAT)](https://www.overleaf.com/for/customers/vpat) أكملناه المطابقة مع إرشادات إتاحة الوصول لمحتوى الويب (WCAG) 2.2 المستوى AA.
</Accordion>

<Accordion title="هل يمكن لملفات PDF التي ينتجها Overleaf أن تستوفي متطلبات الباب الثاني من قانون الأمريكيين ذوي الإعاقة (ADA) والمعيار الأوروبي الموحّد لإتاحة الوصول (EN 301 549)؟">
  نعم. تشترط التشريعات في الولايات المتحدة وأوروبا أن تستوفي ملفات PDF معيار WCAG 2.1 AA. ولاستيفاء WCAG 2.1 AA، يجب أن يكون ملف PDF موسومًا. ويتوفر دعم وسم ملفات PDF في TeX Live 2025.
</Accordion>

<Accordion title="هل يمكن لملفات PDF التي ينتجها Overleaf أن تستوفي معيار PDF/UA-1؟">
  نعم. صُمّم Tagging Project التابع لمشروع LaTeX خصيصًا لإنتاج الوسوم البنيوية التي يتطلبها PDF/UA-1 (وPDF/UA-2 القادم). إذا اتّبع المستخدم توصيات الوسم الحالية لمشروع LaTeX، فإنه في الواقع يبني مستندًا "جاهزًا لـ PDF/UA"، وهي أقوى طريقة لاستيفاء الاشتراط القانوني WCAG 2.1 AA الذي تفرضه التشريعات الأمريكية والأوروبية.
</Accordion>

<Accordion title="كيف أغيّر المترجم إلى LuaLaTeX؟">
  من السهل التحول إلى استخدام LuaLaTeX، محرك ترجمة LaTeX الذي يوصي به فريق مشروع وسم LaTeX. ومع أن المترجم الافتراضي في Overleaf هو PDFLaTeX، يمكنك [التحول إلى LuaLaTeX من إعدادات مشروعك](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="أين يمكنني اختيار أحدث إصدار من TeX Live؟">
  يمكنك الحصول على الأحدث في [Overleaf Labs](https://www.overleaf.com/labs/participate)، الذي يتيح الوصول إلى صورة "rolling TeX Live" في Overleaf، بما في ذلك أحدث ما يتعلق بدعم وسم ملفات PDF. إصدار TeX Live التجريبي هذا مخصص أساسًا لاختبار التغييرات على TeX Live والحزم، ولمعاينة ميزات إتاحة الوصول الجديدة قبل دمجها في إصدار TeX Live السنوي.

  تتوفر معظم ميزات وسم ملفات PDF في صورة [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) القياسية.
</Accordion>

[^1]: الوسم التلقائي مفعّل.

[^2]: إعدادات الوسم مضبوطة.

[^3]: الصورة تحتوي على نص بديل.

[^4]: الصورة عنصر زخرفي.

[^5]: الصورة عبارة عن حرف.

[^6]: الجدول يحتوي على صف رأس واحد.

[^7]: الجدول جدول عرض.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.