المرجع
لمحة سريعة
قسم بعنوان «لمحة سريعة»تجيب المواد المرجعية عن أسئلة محددة: ما الرمز؟ وما القيمة؟ وما مستوى الدعم؟ وما البند؟ يجمع هذا القسم السطح المتحقَّق منه في NextPDF: مرجع الوحدات، ومصفوفات الدعم، وسطح واجهة API، ومرجع الأخطاء، والتوافق مع المعايير، والسياسات التي ينشرها المشروع. لا يشرح المحتوى هنا كيفية إنجاز هدف ما؛ لذلك ارجع إلى الأدلة أو كتاب الوصفات.
خريطة المراجع
قسم بعنوان «خريطة المراجع»محرك النواة
قسم بعنوان «محرك النواة»يُوثَّق محرك nextpdf/core بحسب كل وحدة.
| الصفحة | الغرض منها |
|---|---|
| مرجع المحرّك الأساسي | خريطة فضاء الأسماء: جميع صفحات الوحدات والعائلات الفرعية الأربع. |
| العقود: 41 واجهة عامة (SPI) | الواجهات العامة والتعدادات التي يُتابَع مستوى استقرارها. |
| النواة: واجهة Document وسمات المسؤولية | واجهة Document وعائلة السمات Has*. |
| HTML: النظام الفرعي لتصيير HTML+CSS إلى PDF | مُصيِّر HTML تدفقي بمرور واحد. |
| الأمان: التشفير وسياسة التعمية وسطح التوقيع | التشفير والأذونات ونقاط تكامل التوقيع. |
دعم التصيير
قسم بعنوان «دعم التصيير»ما يتحقّق منه المُصيِّر، أو يعلنه، أو يدعمه جزئيًا، أو لا يدعمه.
| الصفحة | الغرض منها |
|---|---|
| مصفوفة دعم CSS | مستويات دعم صفحات الأنماط المتتالية (CSS) لكل ميزة ضمن مسار HTML. |
| ميزات CSS غير المدعومة والحلول البديلة | ما يقع خارج النطاق، وما يجب استخدامه بدلًا منه. |
| مصفوفة دعم الخطوط والكتابات | تقنيات الخطوط ودعم أنظمة الكتابة. |
| تأليف سطور نمط الكتابة العمودية (vertical-lr وvertical-rl) | دعم نمط الكتابة العمودية للنصوص الصينية واليابانية والكورية. |
| تشكيل الأنظمة الكتابية المعقّدة للتبتية والمنغولية (HarfBuzz) | دعم تشكيل أنظمة الكتابة التي تتطلب ذلك. |
سطح واجهة API
قسم بعنوان «سطح واجهة API»الرموز الدقيقة، والقيم المسموح بها، وعقود الخدمة.
| الصفحة | الغرض منها |
|---|---|
| مرجع التعدادات: القيم المسموح بها لواجهة API العامة | كل تعداد عام مع قيمه المسموح بها. |
| إعداد TSA: سلطة الطوابع الزمنية الافتراضية وكيفية تغييرها | سلطة الطوابع الزمنية (TSA) الافتراضية وطريقة تغييرها. |
| مرجع واجهة Connect REST API | نقاط نهاية REST في NextPDF Connect كما يصفها مستند OpenAPI 3.1. |
| مستكشف واجهة Connect API | مستكشف تفاعلي لنفس العقد. |
تَرِد مراجع واجهة برمجة التطبيقات (API) على مستوى الحزمة ضمن حِزَمها: مرجع API في NextPDF Connect، وفهرس API لعمليات الدمج، ومرجع واجهة برمجة التطبيقات بلغة Python ضمن قسم الأدلة.
مرجع الأخطاء
قسم بعنوان «مرجع الأخطاء»كل استثناء يرميه المحرك، مصنَّفًا بحسب المجال، ومرفقًا بسياقه المنظَّم وإرشادات التعافي.
| الصفحة | الغرض منها |
|---|---|
| مرجع الأخطاء | نموذج الاستثناءات: الفئة الأساسية NextPdfException وعقد السياق. |
| أخطاء النواة والأخطاء العامة | إخفاقات دورة حياة المستند وإخفاقات المحرك العامة. |
| أخطاء العرض والإدخال/الإخراج (HTML والخطوط والكاتب والقارئ) | إخفاقات HTML والخطوط والكاتب والقارئ. |
| مرجع الأخطاء: الأمان والتوقيع والبنية التحتية للمفتاح العام (PKI) | إخفاقات التشفير والتوقيع والبنية التحتية للمفتاح العام (PKI). |
| أخطاء وقت التشغيل والدعم (HTTP والمرونة وقابلية الملاحظة) | إخفاقات HTTP والمرونة وقابلية الملاحظة. |
| مرجع الأخطاء: أخطاء المُسرِّع (Spectrum) | إخفاقات المكوّن الجانبي الاختياري الخاص بالتسريع. |
| أخطاء المطابقة | إخفاقات التحقق وأدوات المطابقة. |
التوافق مع المعايير
قسم بعنوان «التوافق مع المعايير»ملفات تعريف المعايير التي يستهدفها NextPDF Core، مع بيان الحد المعلن لكلٍّ منها: ينتج المحرك مخرجات يُقصد بها التوافق، ويقرِّر مُتحقِّق خارجي مدى هذا التوافق.
| الصفحة | الغرض منها |
|---|---|
| الصفحة الرئيسة للتوافق: ما ينتجه NextPDF ومن يقرّر توافقه | حالة التوافق وفهرس ملفات التعريف. |
| خط أساس PDF 2.0: بنود ISO 32000-2 التي ينفّذها NextPDF | خط أساس ISO 32000-2 الذي يستهدفه المحرك. |
| مطابقة PDF/A-4: مخرجات NextPDF لـ ISO 19005-4 | التوافق الأرشيفي، ومعه ISO 19005-4 (PDF/A-4): خريطة ميزات NextPDF. |
| مطابقة PDF/UA-2: البنية الموسومة التي يُصدرها NextPDF وفق ISO 14289-2 | توافق إمكانية الوصول، ومعه خريطة مواصفة PDF/UA-2 (ISO 14289-2). |
| التوافق مع PDF/X: قصد إخراج الإنتاج الطباعي الذي يُصدره NextPDF | توافق الإنتاج الطباعي. |
| تخطيط مستويات الأساس في PAdES | تخطيط ملف التعريف الأساسي وفق ETSI EN 319 142 لتوقيعات PDF. |
| توافق ZUGFeRD / Factur-X: ملف تعريف الفاتورة المضمَّن وفق EN 16931 | توافق الفاتورة الإلكترونية الهجينة. |
مركز الثقة
قسم بعنوان «مركز الثقة»الحالة الهندسية للمحرك الأساسي، وحدود كل ادعاء.
| الصفحة | الغرض منها |
|---|---|
| مركز الثقة | فهرس الحالة. |
| ترخيص المنتج | شروط ترخيص النواة المفتوحة والإصدارات التجارية. |
| العلامة التجارية واستخدام الهوية | طريقة استخدام اسم NextPDF وعلاماته. |
| معالجة البيانات ومعلومات تحديد الهوية الشخصية (PII) والقياس عن بُعد | ما يقرؤه المحرك ويخزّنه ويرسله. |
| نموذج أمان التشفير والتوقيع | التصميم التشفيري وحدوده. |
| نموذج تهديدات المحرّك | ما يدافع عنه المحرك وما لا يدافع عنه. |
| سياسة الإفصاح عن الثغرات | آلية الإبلاغ عن الثغرات. |
المشروع والإصدارات
قسم بعنوان «المشروع والإصدارات»| الصفحة | الغرض منها |
|---|---|
| سجل التغييرات | ما تغيّر في كل إصدار. |
| أعراف سجل التغييرات | طريقة كتابة إدخالات سجل التغييرات وتصنيفها. |
| سياسة الإصدارات والاستقرار والإهمال والدعم | التزامات التوافق عبر الإصدارات. |
| كيفية هيكلة توثيق NextPDF | بنية مجموعة التوثيق هذه وحوكمتها. |
مسرد المصطلحات
قسم بعنوان «مسرد المصطلحات»مسرد المصطلحات — المصطلحات المستخدمة في هذا التوثيق، معرَّفة مرة واحدة لإعادة استخدامها في كامل التوثيق.
متطلبات مدخل المرجع
قسم بعنوان «متطلبات مدخل المرجع»اجعل كل مدخل في واجهة API يجيب عن الأسئلة نفسها:
| السؤال | الإجابة المطلوبة |
|---|---|
| ما الذي تستدعيه؟ | رمز مؤهَّل بالكامل، أو نقطة نهاية، أو أمر واجهة سطر الأوامر (CLI)، أو مفتاح تهيئة. |
| ما المدخلات المقبولة؟ | جدول معاملات يوضّح النوع، وحالة الإلزام، والقيمة الافتراضية، والقيم المقبولة. |
| ماذا يحدث افتراضيًا؟ | السلوك عند إغفال المدخلات الاختيارية. |
| ما الذي يُعاد؟ | نوع القيمة المُرجَعة، أو نص الاستجابة، أو ملف الإخراج، أو الدفق، أو الأثر الجانبي. |
| ما الذي قد يفشل؟ | استثناء، أو خطأ تحقّق، أو حالة HTTP، أو نمط فشل تشغيلي. |
| كيف تستخدمه بأمان؟ | ملاحظات عن الأمان، وسلامة العامل (worker)، وقيود الحجم، والمسار، والمهلة الزمنية، والتعامل مع الأسرار. |
سياسة التغطية
قسم بعنوان «سياسة التغطية»تستند صفحات مرجع واجهة API والسلوك إلى المصدر. تُوثَّق واجهات API العامة بالاعتماد على مصدر الحزمة وملفات التهيئة والاختبارات والأمثلة. ولا تُوثَّق الفئات المساعِدة الداخلية إلا عندما يحتاج مطورو التطبيقات إلى فهم سلوكها لتهيئة الحزمة أو تشغيلها.
جاهزية الترجمة
قسم بعنوان «جاهزية الترجمة»تُفضِّل صفحات المرجع الجداول على الفقرات الكثيفة. اجعل كل صف قائمًا بذاته، لأن تجزئة تنسيق ملف تبادل التوطين القابل للتوسعة (XLIFF) لاحقًا ستقسّم المحتوى بحسب الكتلة.