من داخل NextPDF

Spec Spec: ISO 32000-2 ISO 32000-2 Spec Spec: WCAG 2.2 WCAG 2.2 Evidence ¶ Editorial Evidence: Editorial

لمحة سريعة

⁨Insider_⁩ هو الجزء من التوثيق الذي يشرح لماذا يتصرف ⁨NextPDF⁩ بهذا الشكل. يخبرك المرجع بما تُعيده الدالة. أما ⁨Insider_⁩ فيخبرك لماذا تُعيد تلك القيمة، وأي معيار أو اختبار يُثبّت هذا المنطق.

كُتب هذا القسم لمهندس خبير ومتمكن أصلاً من التعامل مع قواعد ⁨PDF⁩ و⁨PHP.⁩ هذا القارئ يفضّل صفحة واحدة صادقة على عشر صفحات مطمئِنة.

لماذا يهم هذا

⁨PDF⁩ صيغة قديمة وصارمة ذات أعراف ثابتة؛ فهي لا تتسامح مع التخمينات. والمكتبة التي تُخفي ذلك عنك تبدو مريحة إلى أن يفشل التحقق من مستند موقَّع في بيئة الإنتاج ولا يستطيع أحد تفسير السبب.

يتخذ ⁨Insider_⁩ الموقف المعاكس. فكل صفحة تُبيّن حدود ما تدّعيه، وتُسمّي الدليل الذي يقوم عليه الادّعاء، وتُشير إلى الحدود قبل أن تكتشفها بنفسك. ليس الهدف أن يُبهرك، بل أن يساعدك على اتخاذ قرار يمكنك الدفاع عنه في المراجعة.

النسخة المختصرة

• صفحات ⁨Insider_⁩ تحريرية وتفسيرية، وليست مرجعاً لواجهة ⁨API.⁩
• تحمل كل صفحة صف شارات يُسمّي المعايير ذات الصلة ونوع الدليل الذي تستند إليه الصفحة.
• تتبع كل صفحة البنية نفسها المؤلَّفة من عشرة أقسام، حتى تتمكن من تصفّح القسم الذي تحتاجه دون إعادة تعلّم التخطيط في كل مرة.
• لا شيء هنا يُعيد ذكر أي قياس داخل النص؛ فالأرقام تبقى في الصفحة التي تملك القياس، حتى لا يتقادم رقم في النص بصمت.

كيف يتعامل ⁨NextPDF⁩ مع ذلك

تتناول كل صفحة من صفحات ⁨Insider_⁩ موضوعاً واحداً، وتقف بذاتها، وتضع العبارة الأكثر فائدة في موضع مبكر. هذه البنية مقصودة؛ فهي تتبع إرشادات تصميم المعلومات: يعثر القراء على ما يحتاجونه أسرع عندما تُجمَّع المواد المترابطة ويكون التسلسل الهرمي واضحاً. كما تُبقي الصفحة قابلة للاستخدام مع قارئ الشاشة، لأن الترتيب على الشاشة هو الترتيب نفسه في الترميز.

تنتقل الصفحة من السياق إلى الادّعاء إلى الحد، بهذا الترتيب:

1. At a glance What this page is, in two sentences.
2. Why this matters The cost of getting it wrong.
3. The short version The answer, before the detail.
4. How NextPDF approaches it The reasoning and the mechanism.
5. What the evidence says The standard, code, or test — tagged.
6. Practical example A small, runnable shape.
7. Common misconception The trap, named.
8. Limits and boundaries Where the claim stops.

كيف تُبنى صفحة Insider_، من الأعلى إلى الأسفل: يمكن للقارئ أن يتوقف عند أي خطوة ويظل لديه إجابة كاملة قابلة للدفاع عنها.

Human-factors note: Human-factors note

صف الشارات، وترتيب الأقسام الثابت، واللون الدافئ الذي يميّز الشرطة السفلية اللاحقة في ⁨Insider_⁩ كلها خيارات تصميمية مبنية على إرشادات العوامل البشرية، وليست زخرفة لذاتها. يميّز اللون القسم دون أن يتحول إلى ضوضاء. لا يتحرك أبداً، وهو إشارة اللون الوحيدة في شريط التنقل، والكلمة التي يُعلنها قارئ الشاشة لا تزال “⁨Insider⁩”. المعنى هنا لا يُنقَل باللون وحده أبداً. كما تحمل كل شارة عنواناً نصياً وكلمةً تدل على دورها.

ماذا يقول الدليل

لا يطلب منك ⁨Insider_⁩ أن تثق به. تُعلن كل صفحة مستوى دليلها، ويُظهره صف الشارات:

• Evidence { } Code-backed Evidence: Code-backed — يُتحقَّق من الادّعاء مقابل المصدر الخاص بالمحرك نفسه أو مثال قابل للتشغيل.
• Evidence § Standard-backed Evidence: Standard-backed — يرتكز الادّعاء على بند في معيار منشور، مُعاد صياغته ومُستشهَد به، ولا يُنقل حرفياً قط من مستند مُرخَّص.
• Evidence ✓ Test-backed Evidence: Test-backed — يُثبَّت الادّعاء باختبار في مجموعة الاختبارات.
• Evidence ◇ Design principle Evidence: Design principle — تُبيّن الصفحة قراراً تصميمياً مقصوداً، مُبرَّراً بالحجة لا بالقياس.

وعندما تمزج صفحة بين هذه المستويات، تُصرّح بذلك باستخدام Evidence ⊕ Mixed evidence Evidence: Mixed evidence بدلاً من المبالغة بادّعاء أساس واحد. تُسمّى المعايير التي تعتمد عليها الصفحة في صف الشارات باستخدام معرّفاتها الدقيقة — على سبيل المثال Spec Spec: ISO 32000-2, §7 ISO 32000-2 §7 لصياغة PDF، أو Spec Spec: ETSI EN 319 142-1 ETSI EN 319 142-1 لـ PAdES — حتى تتمكن من الرجوع إلى المرجع في المصدر بنفسك.

مثال عملي

يُفترض أن تكون قراءة صفحة ⁨Insider_⁩ سريعة. لتقرّر ما إذا كانت معالجة التواقيع في ⁨NextPDF⁩ تناسب سير عمل منظَّماً، افتح كيف توجد التواقيع داخل ملف ⁨PDF⁩، واقرأ لمحة سريعة والنسخة المختصرة، ثم انتقل مباشرة إلى الحدود والقيود. تجيب ثلاثة أقسام قصيرة عن سؤال “هل يمكنني الدفاع عن هذا الخيار؟”. وقد أخبرك صف الشارات سلفاً بأن الادّعاء مدعوم بمعيار قبل أن تقرأ كلمة واحدة من نص المتن.

وإذا كانت الإجابة نعم، فإن المستندات ذات الصلة توجّهك إلى الخطوة التالية — ملفات ⁨PAdES⁩ الأساسية والتحقق طويل الأمد — دون الحاجة إلى البحث.

مفهوم خاطئ شائع

يُساء فهم ⁨Insider_⁩ أحياناً على أنه مادة تسويقية: مكان يُمتدح فيه المحرك. وهو، بحكم التصميم، عكس ذلك. والصفحة مستعدة لأن تُخبرك متى لا تستخدم ⁨NextPDF⁩ بقدر استعدادها لأن تُخبرك كيف تستخدمه. وهو لا يقارن ⁨NextPDF⁩ أبداً بأي منافس — لا سلباً ولا إيجاباً. فالموضوع الوحيد هنا هو ⁨NextPDF⁩ والمعايير التي يلتزم بها.

الحدود والقيود

هذه الصفحة توجيهية، وليست مواصفة. وهي لا تؤكّد أي سلوك للمحرك من تلقاء نفسها. فكل ادّعاء سلوكي يبقى في صفحة الموضوع التي تملكه ويحمل مستوى الدليل الخاص بتلك الصفحة. محتوى ⁨Insider_⁩ تحريري وأصيل في ⁨nextpdf-docs.⁩ يُكتب هنا، ويُراجَع هنا، ولا يُجمَّع من شجرة مصدر أي حزمة. وحيثما يمسّ موضوع معياراً مُرخَّصاً، تُعيد الصفحة صياغة البند وتستشهد به. وهي لا تنسخ نص المعيار أبداً.

المستندات ذات الصلة

• فلسفة تصميم ⁨NextPDF⁩ — المبادئ التي تُقاس بها كل صفحة.
• مشهد المعايير — خريطة المعايير التي يتتبّعها ⁨NextPDF⁩ وكيف يتحول البند إلى سلوك.
• التوثيق بوصفه منتجاً — المنهجية التي تقف وراء هذه الصفحات.
• انضباط الاستشهاد — ماذا يعني مستوى الدليل ولماذا تُعاد صياغة المعايير.

مسرد المصطلحات

• ⁨Insider_⁩ — القسم التحريري الذي يشرح المنطق وراء ⁨NextPDF⁩، ويمتاز عن مرجع واجهة ⁨API.⁩ الشرطة السفلية اللاحقة جزء من اسم القسم؛ وهي مُميَّزة باللون للتوكيد فقط.
• مستوى الدليل — الأساس المُعلَن لادّعاءات الصفحة (مدعوم بالأكواد، أو مدعوم بمعيار، أو مدعوم باختبار، أو مدعوم بقياس أداء، أو مدعوم بأثر، أو مبدأ تصميمي، أو تحريري، أو مختلط).
• صف الشارات — الشريط في أعلى كل صفحة من صفحات ⁨Insider_⁩ الذي يُسمّي المعايير ذات الصلة ومستوى دليل الصفحة.
• ⁨nextpdf-docs-native⁩ — محتوى يُؤلَّف ويُمتلَك في موقع التوثيق نفسه، وليس مُشتقاً من مستودع حزمة.