خط أنابيب العرض

من المستند إلى صور الصفحات

بين OpenDocumentAsync وملف PNG الذي يصل إلى المتصفح توجد مرحلتان مميزتان: حل المشاهد (المحرك الذي يحمل المستند، يُحدد مرة واحدة عند الفتح) ومعالجة الصفحة (ما يحدث لكل صورة صفحة عند كل طلب). معرفة كلتا المرحلتين يوضح لماذا تُظهر الصيغة بطريقة معينة — وما الذي يبدله DefaultRender فعليًا.

المرحلة 1 — حل عارض الصيغة

المصنع يربط امتداد الملف بعارض من خلال كتالوج الصيغ، مع ثلاثة مستويات من الأولوية:

  1. أولاً العارضون المخصصون. أي شيء سجّلتَه باستخدام DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) يتفوق على جميع العارضين المدمجين.
  2. عارضو العائلة المدمجون. يربط الكتالوج كل امتداد قابل للعرض بعائلة عارض — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — كل واحدة لها محول محرك خاص. إذا أضاف مكوّن إضافي مرخص عارضًا لنفس الامتداد، يستبدل عارض المكوّن الإضافي العارض المدمج. AddDoconut() يتحقق من صلاحيات المكوّن الإضافي المسجّلة عند بدء التشغيل؛ والعودة إلى العارض المدمج هي قاعدة تشغيل دفاعية.
  3. الصيغ التي تعتمد على المكوّن الإضافي فقط. بعض الامتدادات لا يوجد لها عارض مدمج مطلقًا — DICOM (.dcm) موجود فقط عبر مكوّن DICOM الإضافي. فتح أحدها بدون القدرة المطلوبة يثير الاستثناء التالي:
text
LicenseException: This document type requires the 'Dicom' plugin license.

امتداد لا يدعي أي عارض يرفع الاستثناء التالي:

text
FormatNotSupportedException: Document format '<extension>' is not supported.

بعد حل الصيغة، يتم تثبيت الإعدادات: كائن الإعدادات الصريح إذا قمت بتمريره، وإلا إعدادات الصيغة الافتراضية من الكتالوج. يتم نسخ DocOptions.Password إلى الإعدادات للمستندات المحمية.

المرحلة 1b — وضع إعادة التوجيه (DefaultRender = false)

معظم إعدادات الصيغ تكشف عن علم DefaultRender. يختار بين مسارين مختلفين جوهريًا:

  • DefaultRender = true — المستند يُعرض أصلاً، مباشرة إلى صور الصفحات.
  • DefaultRender = false — المستند يُحوَّل أولاً إلى PDF في الذاكرة، يُحرَّر محرك المصدر، ويتولى عارض PDF المتابعة. يضمّن PDF المُنتج نصًا حقيقيًا، لذا يحصل البحث النصي الكامل على تمييزات بكسلية دقيقة؛ يفرض خط الأنابيب تشغيل AllowSearch وAllowCopy للـ PDF المعاد توجيهه لأن التحويل غير مرئي للمستخدم.

تستخدم XPS والكتالوج الافتراضي لـ MHT مسار إعادة التوجيه. يمكن لإسقاط PDF أن يوفر بحثًا أصليًا للصيغ مثل HTML وMicrosoft Project. إذا كان PDF الناتج يحتوي على صور دون طبقة نصية، لا يستطيع العارض القياسي البحث في تلك البكسلات.

استخدم وضع إعادة التوجيه عندما تحتاج إلى إسقاط PDF يحمل نصًا — على حساب تحويل مسبق عند فتح المستند.

المرحلة 2 — خط أنابيب صورة الصفحة

تُعالج الصفحات المرسومة حسب الطلب عبر تسلسل ثابت:

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • علامة مائية — تُطبق بناءً على حالة الترخيص (ترخيص مفقود، مؤقت منتهي أو اشتراك، نطاق غير صالح، نسخة خاطئة) ومن خلال DocOptions.Watermark للنص المخصص الخاص بك. التطبيق المرخص بشكل صحيح — أو ترخيص مؤقت نشط — بدون علامة مائية مخصصة يتخطى هذه الخطوة.
  • تدوير/قلب — حالة كل صفحة يحددها المستخدم في الواجهة (90°/180°/270°، قلب أفقي/عمودي) تُخزن في الجلسة وتُطبق على كل عرض لاحق لتلك الصفحة.
  • تحجيم — تُنتج المصغرات ومستويات التكبير عن طريق تحجيم الصفحة المرسومة إلى الحجم المستهدف المطلوب؛ 0 يعني تقديمها بالحجم الأصلي.
  • حرق التعليقات التوضيحية — تُرسم التعليقات التوضيحية المحفوظة على البت ماب بحيث تظهر في الصادرات وصور الصفحات.
  • ترميز — تُشفَّر النتيجة إلى PNG باستخدام تدفقات الذاكرة المشتركة وتُكتب مباشرةً إلى استجابة HTTP.

الأخطاء داخل الطبقة الوسيطة تُعاد كـ صور خطأ PNG (نص أحمر على خلفية بيضاء) بدلاً من صفحات خطأ HTTP، بحيث يمكن للواجهة عرضها في منطقة الصفحة.

تخزين الصفحات مؤقتًا

BaseConfig.CachePages (الافتراضي true) يحتفظ بصور الصفحات المرسومة في الذاكرة طوال عمر جلسة المستند، لذا إعادة زيارة صفحة لا تُعيد رسمها. BaseConfig.ImageResolution (25–300 DPI، 0 = الافتراضي حسب الصيغة) هو المنقب الرئيسي للجودة/الذاكرة؛ كل صيغة لها إعداد افتراضي موثَّق في صفحة إعداداتها.

العرض على عقدة واحدة مقابل عدة عقد

كل ما سبق يصف عرض عقدة واحدة عند الطلب للجلسة التي فتحت المستند. في نشر حيث تُعيد عقدة واحدة رسم وتُنشِر مجموعة الأصول بالكامل، وتُقدِّم العقد الأخرى تلك الصفحات من تخزين مشترك، يُستَخدم مسار قراءة مختلف — انظر النشر الموزع.

الخطوط على لينكس

تُرسم الصفحات باستخدام الخطوط المثبتة على الخادم. على لينكس، ثبّت مكتبة تكوين الخطوط قبل فتح أول مستند (fontconfig على RHEL وFedora):

bash
apt-get update && apt-get install -y libfontconfig1

بدونها، فشل فتح المستند مع The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. هذه هي الحزمة النظامية الوحيدة التي يحتاجها Doconut؛ libgdiplus غير مطلوبة.

تعتمد تبعياتها على مجموعة خطوط أساسية (DejaVu)، لذا تُظهر المستندات دون إعداد إضافي. المستند الذي يطلب خطًا غير موجود على الخادم — مثل Calibri أو Arial أو Times New Roman في صورة لينكس شائعة — يحصل على أقرب خط مثبت، مما قد يغيّر عرض النص وتفاصيل السطر مقارنةً بنظام Windows. للحصول على مخرجات أقرب إلى Windows، ثبّت البدائل المتوافقة مع المقاييس fonts-liberation، fonts-crosextra-carlito، وfonts-crosextra-caladea؛ أضف fonts-noto-core أو fonts-noto-cjk للخطوط الأخرى، أو انسخ ملفات .ttf/.otf الخاصة بك إلى /usr/share/fonts/ وشغّل fc-cache -f.

توزيعات Alpine وغيرها من التوزيعات القائمة على musl غير مدعومة.

أين تُضبط ماذا

ما تريدالضبط
صفحات أكثر حدةImageResolution في إعداد الصيغة
بحث نصي دقيق على HTML/EPUB/email/MHT/MPPDefaultRender = false في إعداد الصيغة
تقليل الذاكرة في المستندات الضخمةCachePages = false، أغلق الجلسات صراحة
ختمك الخاص على كل صفحةDocOptions.Watermark

هل كانت هذه الصفحة مفيدة؟