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

مع مرور الوقت، جعلت التحديثات على إمكانات إنشاء ملفات PDF إتاحة الوصول (accessibility) في ملفات PDF أمرًا ممكنًا. وقد مكّنت خطوات مهمة، من بينها LaTeX Tagging Project، ملفات PDF المبنية على LaTeX من أن تكون سهلة الوصول أيضًا، ولا تزال التحسينات مستمرة.

إن إصدار TeX Live 2025 على وجه الخصوص هو ما يجعل هذه العملية ممكنة في Overleaf. لاحظ أن LuaLaTeX هو المترجم الموصى به عند استخدام MathML.

يمكنك التأكد من ضبط إعدادات مشروعك وفقًا لذلك من خلال تعلّم كيفية تغيير المترجمات وإصدارات TeX Live.

يستند نهجنا إلى حد كبير إلى تعليمات ملفات PDF سهلة الوصول الخاصة بمشروع LaTeX، والتي يمكنك الرجوع إليها لمزيد من التفاصيل حول المواضيع التالية.

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

​

الوسم (Tagging)

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

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

​

tagging

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

\DocumentMetadata{tagging=on}

​

tagging-setup

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

\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}

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

​

الأوصاف

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

​

الصور

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

النص البديل

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

Alt text example

\includegraphics[width=0.25\linewidth,alt={Macro photo of a green frog's head and hands}]{frog.jpg}

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

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

Artifact example

\includegraphics[artifact]{.jpg}

النص الفعلي

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

Actual text example

\includegraphics[actualtext=B]{.jpg}

​

الجداول

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

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

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

Data table example

\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
Item & Quantity \\\hline
Widgets & 42 \\
Gadgets & 13
\end{tabular}

جداول العرض

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

Presentation table example

\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}

​

الأسئلة الشائعة

هل توجد أدوات يمكنها المساعدة في التحقق من أن مستندي سهل الوصول؟

نعم، توجد عدة أدوات خارجية، منها veraPDF، يمكنها التحقق من أجزاء PDF/A ومستويات المطابقة. إضافةً إلى ذلك، يمكنك استخدام أداة مثل WebAIM لحساب نسبة التباين بين لونين.

هل الحزم المستخدمة في مشروعي على Overleaf متوافقة مع هذه الميزات؟

يمكنك الرجوع إلى قائمة حالة الحزم الخاصة بـ LaTeX Tagging Project.

هل لا يزال بإمكاني استخدام beamer؟ هل تتوفر حزم أخرى للعروض التقديمية؟

هناك قيود على استخدام beamer؛ اطّلع على الصنف ltx-talk التجريبي.

هل محرر Overleaf سهل الوصول؟

نعم. بصفته تطبيق ويب، يستفيد Overleaf من ميزات إتاحة الوصول ووظائفها في متصفحات الويب الحديثة، والتي يقيّمها خبراء إتاحة الوصول بانتظام. ويُظهر أحدث نموذج طوعي لإتاحة الوصول للمنتج (VPAT) أكملناه المطابقة مع إرشادات إتاحة الوصول لمحتوى الويب (WCAG) 2.2 المستوى AA.

هل يمكن لملفات PDF التي ينتجها Overleaf أن تستوفي متطلبات الباب الثاني من قانون الأمريكيين ذوي الإعاقة (ADA) والمعيار الأوروبي الموحّد لإتاحة الوصول (EN 301 549)؟

نعم. تشترط التشريعات في الولايات المتحدة وأوروبا أن تستوفي ملفات PDF معيار WCAG 2.1 AA. ولاستيفاء WCAG 2.1 AA، يجب أن يكون ملف PDF موسومًا. ويتوفر دعم وسم ملفات PDF في TeX Live 2025.

هل يمكن لملفات PDF التي ينتجها Overleaf أن تستوفي معيار PDF/UA-1؟

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

كيف أغيّر المترجم إلى LuaLaTeX؟

من السهل التحول إلى استخدام LuaLaTeX، محرك ترجمة LaTeX الذي يوصي به فريق مشروع وسم LaTeX. ومع أن المترجم الافتراضي في Overleaf هو PDFLaTeX، يمكنك التحول إلى LuaLaTeX من إعدادات مشروعك.

أين يمكنني اختيار أحدث إصدار من TeX Live؟

يمكنك الحصول على الأحدث في Overleaf Labs، الذي يتيح الوصول إلى صورة “rolling TeX Live” في Overleaf، بما في ذلك أحدث ما يتعلق بدعم وسم ملفات PDF. إصدار TeX Live التجريبي هذا مخصص أساسًا لاختبار التغييرات على TeX Live والحزم، ولمعاينة ميزات إتاحة الوصول الجديدة قبل دمجها في إصدار TeX Live السنوي.

تتوفر معظم ميزات وسم ملفات PDF في صورة TeX Live 2025 القياسية.