وسم عناصر الصفحة عبر Connect

وسم عناصر الصفحة عبر ⁨Connect⁩

لمحة سريعة

تغلّف هذه الوصفة عناصر التزيين المرتبطة بترقيم الصفحات، بما في ذلك الترويسات والتذييلات الجارية وأرقام الصفحات والعلامات المائية والخلفيات، داخل محتوى موسوم كعنصر عبر نواقل ⁨Connect.⁩ تبقى عناصر التزيين مرئية على الصفحة، لكنها تظل خارج شجرة البنية وترتيب القراءة لدى التقنيات المساعدة. أداة العناصر من فئة ⁨Enterprise⁩؛ يكتشفها ⁨NextPDF⁩ عبر فحص class_exists() ولا يسجّلها إلا عند تثبيت nextpdf/premium إلى جانب الخادم. يستخدم النوع الفرعي تعدادًا مضبوط النوع (Pagination، Layout، Page، Background).

للتحقق من المُخرَج، استخدم أداة فحص المعايير من فئة ⁨Enterprise⁩؛ فهي تُصدر تقريرًا مقابل ⁨PDF/UA-2.⁩ تمثل النتيجة الناجحة فحصًا من الأداة نفسها، لا شهادة مطابقة مستقلة.

التثبيت

composer require nextpdf/server

تأكّد من وجود أداة العناصر من فئة ⁨Enterprise⁩ باستدعاء tools/list. راجع /⁨connect/tool-catalog/.⁩

نظرة عامة مفاهيمية

يُوسَم المحتوى الذي لا يُعد جزءًا من البنية المنطقية كعنصر ويُستبعَد من ترتيب القراءة (⁨PDF/UA-2⁩ §8.3). تشمل العناصر محتوى الترقيم أو التخطيط أو الصفحة أو الخلفية، وهي مميّزة عن المحتوى الحقيقي (⁨PDF/UA-2⁩ §8.3). يظهر المحتوى الحقيقي في شجرة البنية؛ أما العناصر فلا (⁨PDF/UA-2⁩ §8.2.4).

تفتح الأداة تسلسل محتوى موسومًا كعنصر من النوع الفرعي المطلوب. تُغلَّف داخله أي عمليات رسم تُصدِرها قبل الإغلاق المطابق.

واجهة ⁨API⁩

طابق أسماء الأدوات مع السجل قيد التشغيل باستخدام tools/list. الكتالوج المعتمد هو /⁨connect/tool-catalog/.⁩ لا تعيد هذه الوصفة سرد الأدوات.

نموذج التعليمات البرمجية — البدء السريع

افتح عنصر ⁨Background⁩، وارسم العلامة المائية، ثم أغلقه:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Background" }
  }
}

نموذج التعليمات البرمجية — الإنتاج

قابِل كل عملية فتح بإغلاق، وتحقّق من أن الصفحة لا تحتوي على محتوى يتيم:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Page", "attached": "Bottom" }
  }
}

بعد رسم نص التذييل، أغلقه باستخدام أداة إنهاء العنصر وشغّل فحص المعايير مقابل ⁨PDF/UA-2.⁩ يجب أن تقتصر شجرة البنية على محتوى المتن؛ ويجب استبعاد العلامة المائية والتذييل.

الحالات الحدّية والمزالق

• النوع الفرعي غير المعروف (على سبيل المثال "Header") مرفوض. مرّر إحدى القيم Pagination، Layout، Page، Background.
• الإغلاق دون فتح يفشل برسالة تشير إلى عمق صفري. قابِل دائمًا كل فتح بإغلاق.
• الرسم قبل أي سياق عنصر أو بنية يُنتج محتوى يتيمًا وفشلًا في قاعدة البنية. افتح أولًا سياق بنية أو عنصر.
• الأداة غائبة. بدون nextpdf/premium، لا تُسجَّل أداة العناصر من فئة ⁨Enterprise⁩، ويفشل الاستدعاء بخطأ أداة غير معروفة.

الأداء

تمثل ميزانية ⁨frontmatter⁩ سقفًا توثيقيًا. لا يضيف تغليف العناصر أي مرحلة منفصلة قابلة للقياس.

ملاحظات الأمان

لا ينطبق هنا سوى إرشادات نقل ⁨Connect⁩ العامة.

المطابقة

تخطيط ⁨PDF/UA-2⁩

النوع الفرعي	حالة الاستخدام
Pagination	الترويسات والتذييلات الجارية (⁨headers/footers⁩)، وأرقام الصفحات، وعناصر تزيين التنقّل
Layout	الخطوط الفاصلة والفواصل والحدود الزخرفية
Page	العناصر المساعدة المرتبطة بالصفحة (علامات القص، علامات التسجيل)
Background	العلامات المائية وتعبئات الخلفية وعناصر الهوية البصرية

الوسم ← الإحالة المرجعية إلى ⁨ISO 32000-2⁩ §14.9

الادّعاء	البند	⁨reference_id⁩
يُوسَم المحتوى غير البنيوي كعنصر، ويُستبعَد من ترتيب القراءة	⁨PDF/UA-2⁩ §8.3
الأنواع الفرعية للعناصر: ⁨pagination/layout/page/background⁩	⁨PDF/UA-2⁩ §8.3
يظهر المحتوى الحقيقي في شجرة البنية؛ أما العناصر فلا	⁨PDF/UA-2⁩ §8.2.4

تخطيط ⁨WCAG 2.2⁩

يدعم استبعاد العناصر الزخرفية من ترتيب القراءة معيار النجاح ⁨SC 1.3.1⁩ (المعلومات والعلاقات) من إرشادات الوصول إلى محتوى الويب (⁨WCAG⁩) 2.2 على مستوى المحتوى.

تمثل نتيجة فحص المعايير الناجحة فحصًا، لا شهادة مطابقة. يتخذ مدقّق مستقل ذلك القرار.

السياق التجاري

أداة العناصر من فئة ⁨Enterprise⁩ ولا تُسجَّل إلا عند تثبيت nextpdf/premium إلى جانب الخادم.

تفاصيل ⁨Connect⁩

توفّر النواقل (⁨MCP⁩ / ⁨REST⁩ / ⁨gRPC⁩)

تُستدعى هذه الأدوات بالطريقة نفسها عبر ⁨MCP⁩ tools/call، ونقطة نهاية أداة ⁨REST⁩، وخدمة ⁨gRPC.⁩ تستخدم الثلاثة جميعها مُنفّذ الأدوات المشترك.

فئة مخاطر ⁨HITL⁩

يندرج إصدار العناصر ورسم المحتوى ضمن مستوى التنبيه؛ أما فحص المعايير فهو للقراءة فقط. لا يكون أي منها بحالة approval_required افتراضيًا. راجع /⁨connect/hitl-risk-tiers/.⁩

غلاف ⁨JSON⁩ لبوابة التأكيد

لا تُشغِّل هذه الأدوات البوابة ما لم يرفع تجاوز من المُشغِّل إحداها إلى approval_required. يوجد الغلاف وعقد الرمز المميز ذي الاستخدام الواحد في /⁨connect/hitl-risk-tiers/.⁩

انظر أيضًا

• /⁨cookbook/connect/aria-tagged-pdf/⁩ — تخطيط أدوار المعالم.
• /⁨cookbook/connect/figure-caption/⁩ — تجميع الصور بطريقة سهلة الوصول.
• /⁨connect/tool-catalog/⁩ — حساب مجموعة الأدوات لكل فئة.
• /⁨connect/hitl-risk-tiers/⁩ — نموذج المخاطر والبوابة.