# فحوصات Preflight

افحص المصدر وسجل البناء وملف PDF والمراجع وإشارات إمكانية الوصول ومخاطر التقديم قبل أن يغادر المستند يدك.

لا يثبت التجميع الناجح إلا أن ملف PDF قد أُنشئ. وهو لا يثبت أن كل استشهاد حُل، أو أن ترتيب القراءة منطقي، أو أن حزمة التقديم نظيفة، أو أن الملف يحمل بنية إمكانية الوصول التي يدّعيها.

يجمع Preflight هذه الأسئلة في مراجعة محلية واحدة. افتح **الدرع** في الشريط الجانبي للمشروع، واختر الفحوصات التي تناسب المستند، وشغّل فحصًا واحدًا أثناء إصلاح مشكلة أو المجموعة كاملة قبل التقديم.

![لوحة Preflight في Oleafly. حدد الفحوصات التي تحتاجها، وشغّل فحصًا واحدًا من صفه، أو شغّل جميع الفحوصات المفعّلة من الزر السفلي.](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![تشغيل فحوصات Preflight للبناء والتقديم وإمكانية الوصول على ورقة بحثية قبل إرسالها.](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## ست فحوصات مستقلة

### التجميع والتخطيط

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

### جاهزية التقديم

يطبّق ملف تعريف النشر المحدد على المشروع. ويفحص المتطلبات المستقرة المتعلقة بفئة المستند، والملخص والكلمات المفتاحية، وصيغ الأشكال، والخطوط المضمنة، وقيود PDF، والتسميات التوضيحية، والأسماء القابلة للنقل، وفوضى حزمة المصدر.

### جاهزية ATS

يستخرج سيرة ذاتية على النحو الذي تفعله أنظمة تتبع المتقدمين (ATS). ويعرض حقول التواصل والأقسام المتوقعة والتخطيطات التي قد تبعثر ترتيب القراءة.

### إمكانية الوصول

يفحص إشارات المصدر وملف PDF المتعلقة بالوسم، والنص البديل، وبيانات تعريف اللغة والعنوان، وإعدادات العارض، والعناوين، والجداول، والروابط، وترتيب القراءة، والنص القابل للتحديد، والإشارات المرجعية حيث تكون مفيدة، والنص الصغير جدًا.

### المراجع والأصول

يعثر على الملفات المفقودة، والاستشهادات والإحالات المرجعية غير المحلولة، والتسميات ومعرفات DOI المكررة، ومدخلات قائمة المراجع غير المكتملة، والمراجع غير المستشهد بها حين يكون المشروع الكامل متاحًا.

### الخصوصية والمراجعة العمياء

يبحث عن بيانات الاعتماد، والمفاتيح الخاصة، والملفات الحساسة، وملاحظات المسودة، والتعليقات الداخلية، وعبارات الشكر، وحقول المؤلف، وبيانات تعريف الهوية التي قد تفسد مراجعة عمياء.

## مشاريع Typst

لمصادر Typst فحوصاتها الخاصة. تقرأ هذه الفحوصات ملفات `.typ` مباشرة، فلا تنطلق قواعد LaTeX أبدًا على صياغة Typst.

- يعثر **References & assets** على مراجع `@` واستشهادات لا يقابلها تسمية أو مدخل في قائمة المراجع، وتسميات مكررة، ومسارات صور أو `#include` لا تطابق أي ملف في المشروع، وملف `#bibliography` غير موجود في المشروع، ومستند يستشهد بمصادر لكنه لا يستدعي `#bibliography` أبدًا. يمكن لمفاتيح الاستشهاد أن توجد في ملف `.bib` أو في ملف Hayagriva بامتداد `.yml`.
- يشير **Accessibility** إلى الصور التي بلا نص `alt`، على الصورة نفسها أو على الشكل الذي يحتويها، وإلى العناوين الفارغة، وإلى المستند الذي لم يضبط عنوانه عبر `#set document(title: ...)` أو عبر القالب.
- يتحقق **Submission readiness** من أن المشروع يستورد قالبًا يلائم ملف التعريف المختار، وأن القالب يتلقى ملخصًا وكلمات مفتاحية، وأنه لا تبقى نصوص `#lorem` ولا عناصر نائبة ولا ملاحظات TODO. كما ينظر في التسميات التوضيحية وأحجام الصور وأسماء الملفات.
- يعثر **Privacy & blind review** على أسماء المؤلفين ورسائل البريد الإلكتروني والانتماءات الممررة إلى القالب، وعبارات الشكر، ومسارات الملفات المحلية.

تذكر كل نتيجة الملف والسطر، ويعرض تفصيلها إصلاح Typst، مثل `#image("chart.png", alt: "Bar chart of yearly sales")`.

## اقرأ درجة اليقين، لا اللون وحده

تشرح كل نتيجة كيف توصل Oleafly إليها:

- **Verified** تعني أن التطبيق رصد دليلًا مباشرًا في المصدر أو السجل أو المشروع أو ملف PDF.
- **Advisory** تعني أن خوارزمية استدلالية موثقة عثرت على شيء ينبغي لشخص فحصه.
- **Manual** تسمي فحصًا لا تستطيع الملفات حسمه بأمان.

المدخل المفقود لا يتحول أبدًا إلى نتيجة ناجحة. وتبقى النتائج المستندة إلى المصدر وحده جزئية حتى يوجد ملف PDF حديث.

## اختر ملف تعريف النشر

استخدم ملف تعريف النشر العام أو الخاص بـarXiv أو IEEE أو ACM أو المجلات أو الأطروحات الذي يطابق وجهة النشر على أفضل وجه. تغطي ملفات التعريف المتطلبات المستقرة بما يكفي للفحص الآلي. وفي مشروع Typst، يتوقع ملف التعريف أيضًا قالب Typst مطابقًا، وتذكر النتيجة القوالب التي يقبلها.

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

## شاهد ما يستقبله قارئ آخر

اختر **Screen Reader** في لوحة Preflight لفتح **What the reader sees**، الذي يستخرج نص ملف PDF صفحة بصفحة. استخدمه لالتقاط ورقة ذات عمودين تُقرأ عبر الصفحة، أو رقم هاتف مفقود من خط الأيقونات، أو تسمية توضيحية في موضع خاطئ، أو صفحة بلا نص قابل للتحديد.

وبالنسبة إلى السير الذاتية، يعرض **What a parser extracted** الاسم والبريد الإلكتروني والهاتف والروابط والأقسام القياسية التي استطاعت محاكاة ATS استرجاعها.

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

## PDF/UA وإمكانية الوصول: الحد الصادق

يفحص Oleafly الجزء من PDF/UA-1 الذي يستطيع قراءته من الملف. وتستشهد النتائج بـPDF/UA-1، وبـPDF/UA-2 حيث يختلف، ونقاط فحص بروتوكول Matterhorn، وتقنيات PDF في WCAG 2.2.

يغطي التقرير إشارات قابلة للقراءة الآلية مثل:

- شجرة وسوم تحوي محتوى حقيقيًا؛
- نص بديل على الأشكال والصيغ؛
- خلايا ترويسة في الجداول؛
- تسلسل العناوين؛
- لغة المستند وعنوان XMP؛
- تفضيل العارض الذي يعرض العنوان؛
- أوصاف الروابط والمحتوى غير الموسوم المشبوه؛
- إن كان الملف يسند ادعاء PDF/UA-1 المصرح به.

تخبرك اللوحة بعدد قواعد PDF/UA-1 القابلة للفحص الآلي، وهي 106، التي جرى التحقق منها. وتخبرك أيضًا حين تعذرت قراءة قاعدة أو حين لا تنطبق. والقاعدة غير المفحوصة لا تُحتسب ناجحة.

:::caution[لا يمنح Preflight شهادة PDF/UA]
هذا فحص لمجموعة جزئية، لا بيان مطابقة. لا يستطيع Oleafly أن يقرر ما إذا كان النص البديل ذا معنى، أو أن ترتيب القراءة منطقي لشخص، أو أن تباين الألوان كافٍ، أو أن المستند يعمل جيدًا مع التقنيات المساعدة لدى القارئ. ومن أجل نتيجة مطابقة رسمية، تحقق من الملف النهائي بأداة veraPDF أو PAC 2024 وأكمل مراجعة بشرية.
:::

## تجهيز ملف PDF موسوم من LaTeX

يعتمد وسم LaTeX على فئة المستند والحزم والمحرك وإصدار TeX Live. ويفحص Preflight المستند الرئيسي الفعلي وملفات الديباجة التي يحمّلها قبل أن يعرض التجهيز.

1. شغّل **Accessibility** على ملف PDF الحالي واقرأ النتائج.
2. افتح **Accessible export**.
3. اطّلع على تقرير توافق الفئة والحزم. الفئة غير المتوافقة تمنع التجهيز؛ والحزمة المتوافقة جزئيًا أو المجهولة تظهر بوصفها تحذيرًا.
4. اختر **Prepare for accessible export** وراجع كل تغيير مقترح على المصدر.
5. استبدل كل عنصر نائب للنص البديل أُنشئ تلقائيًا بوصف ذي معنى، وأضف عنوان المستند حين يُطلب منك.
6. جمّع بـpdfLaTeX أو LuaLaTeX من TeX Live 2026، أو من TeX Live محدَّث منذ نوفمبر 2025. الرياضيات القابلة للوصول تحتاج LuaLaTeX.
7. شغّل Accessibility مرة أخرى، وافحص عرض القارئ، ثم تحقق من ملف PDF النهائي خارج Oleafly حين تكون المطابقة مهمة.

يمكن للتجهيز أن يضيف `\DocumentMetadata` أو يحدّثه باللغة وقصد PDF/UA-2 والوسم؛ وأن يصرّح بصف ترويسة أول للجدول؛ وأن يضيف عناصر نائبة مرئية لبدائل الأشكال المفقودة؛ وأن يضيف `unicode-math` حين يحتاجه المحرك المختار. ويعرض التغييرات قبل تطبيقها.

يوضع سطر `\DocumentMetadata` داخل فحص للإصدار. وLaTeX الأقدم من نوفمبر 2025، مثل LaTeX في المحرك المدمج، يتخطاه ويبني المستند دون وسوم بدلًا من أن يفشل، ولا يدّعي ملف PDF أي توافق مع PDF/UA. عندئذ يبلغ Preflight بـ **Tagging was skipped because this LaTeX is too old** ويسمّي LaTeX الذي جرى به البناء.

لا يستطيع محرك Tectonic المدمج إنشاء شجرة وسوم. ويستخدم **Compile tagged and verify** توزيعة TeX نظامية متاحة أو TinyTeX الذي يديره Oleafly، ويشغّل LuaLaTeX دائمًا، حتى في مشروع Tectonic. وإذا توقف التجميع الموسوم عند ملف مفقود، مثل `tagpdf-base.sty` على TinyTeX، فإنه يعرض تثبيته كما يفعل التجميع العادي، ثم يشغّل التجميع الموسوم من جديد. ويمكنك أيضًا تجميع المصدر المجهَّز بسلسلة أدواتك الحالية الخاصة.

:::note[قد يكون التوافق هو العائق]
يستخدم Preflight بيانات حالة الوسم التي نشرها مشروع LaTeX. الفئات غير المدعومة تُمنع، والفئات المدعومة جزئيًا تُعلَّم بتحذير، والحزم غير الموجودة في البيانات تُعامل معاملة المجهول لا أن تُفترض آمنة. والحزمة `enumitem` ممنوعة حاليًا لأنه لا يمكن تحميلها في سير العمل الموسوم.
:::

راجع [محركات LaTeX وحزمها](/docs/latex-engines/) من أجل TinyTeX وحالة الحزم وحدود الأمان حول TeX النظامي.

## معايير PDF من Typst

لا يملك مشروع Typst مصدرًا يحتاج تجهيزًا. فـTypst نفسه يكتب ملفات PDF أرشيفية ومتاحة، لذلك يعرض فحص **Accessibility** خيار **PDF standards** بدل **Accessible export**.

1. شغّل **Accessibility** وأصلح النص البديل المفقود وعنوان المستند المفقود. يحتاج PDF/UA-1 كليهما.
2. ضمن **PDF standards**، اختر **Standard**، مثل PDF/UA-1 أو PDF/A-2b.
3. اختر **Export PDF** واحفظ الملف.
4. تحقق من ملف PDF المصدَّر خارج Oleafly حين تكون المطابقة مهمة.

يوسم Typst 0.14 وما بعده كل ملف PDF، فلا يوجد تجميع موسوم منفصل. والإصدارات الأقدم توفر معايير أقل، ولا يوفر Typst 0.11 أي معيار؛ وتخبرك اللوحة أيها ينطبق. ولاستخدام إصدار أحدث، غيّر **Typst version (this project)** في قائمة التجميع. وراجع [مشاريع Typst](/docs/typst/#what-each-version-can-do).

## جولة أخيرة عملية

1. جمّع المصدر نفسه الذي تنوي تقديمه.
2. شغّل جميع فحوصات Preflight ذات الصلة.
3. أصلح النتائج المؤكدة واستقصِ النتائج الاستدلالية.
4. أكمل كل عنصر يدوي مقابل دليل جهة النشر الحالي.
5. اقرأ ملف PDF النهائي من الصفحة الأولى إلى الأخيرة، بما في ذلك المراجع والملاحق.
6. افتح الملف المصدَّر وحزمة المصدر من موضعهما المحفوظ.
7. استخدم أداة التحقق الخاصة بالوجهة نفسها قبل انقضاء الموعد النهائي.

يقلل Preflight المفاجآت القابلة للتجنب. ولا يزال القبول وإمكانية الوصول والصحة العلمية يتطلب المؤلف وجهة النشر والأشخاص الذين سيستخدمون المستند.
