خط أنابيب العرض
من المستند إلى صور الصفحات
بين OpenDocumentAsync وملف PNG الذي يصل إلى المتصفح هناك مرحلتان مميزتان: حل عارض المستند (أي المحرك الذي يحمل المستند، يُحدد مرة واحدة عند الفتح) و معالجة الصفحة (ما يحدث لكل صورة صفحة عند كل طلب). معرفة كلاهما يوضح لماذا يتم عرض تنسيق معين بهذه الطريقة — وما الذي يفعله DefaultRender فعليًا.
المرحلة 1 — حل عارض التنسيق
يقوم المصنع بربط امتداد الملف بعارض عبر كتالوج الصيغ، مع ثلاثة مستويات من الأولوية:
- أولاً المشاهدات المخصصة. أي شيء سجلته باستخدام
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?)يتفوق على جميع المدمجات. - المشاهدات العائلية المدمجة. يربط الكتالوج كل امتداد قابل للعرض بعائلة مشاهد — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — كل منها بموصل محرك خاص به. إذا كان ملحق مرخص يضيف مشاهدًا لنفس الامتداد، فإن مشاهد الملحق يحل محل المدمج.
AddDoconut()يتحقق من صلاحيات الملحق المسجلة عند بدء التشغيل؛ العودة الافتراضية للمصنع إلى المشاهد المدمج هي قاعدة تشغيلية دفاعية. - الصيغ التي تعتمد على الملحق فقط. بعض الامتدادات لا تمتلك مشاهد مدمج على الإطلاق — DICOM (
.dcm) موجود فقط عبر ملحق DICOM. فتح أحدها بدون القدرة المطلوبة يسبب استثناء:
LicenseException: This document type requires the 'Dicom' plugin license.امتداد لا يدعي أي مشاهد يرفع:
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 — خط أنابيب صورة الصفحة
تُعالج الصفحات المعروضة حسب كل طلب عبر تسلسل ثابت:
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):
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 في صورة لينكس النموذجية — يحصل على أقرب خط مثبت بدلاً من ذلك، لذا قد يختلف عرض النص وفواصل الأسطر عن ويندوز. للحصول على مخرجات أقرب إلى ويندوز، قم بتثبيت البدائل المتوافقة مع المقاييس 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/البريد الإلكتروني/MHT/MPP | DefaultRender = false في إعدادات الصيغة |
| استخدام أقل للذاكرة على المستندات الضخمة | CachePages = false، إغلاق الجلسات صراحةً |
| ختمك الخاص على كل صفحة | DocOptions.Watermark |
هل كانت هذه الصفحة مفيدة؟