توثيق الإصدارات

بقشيش

لبدء استخدام SDK Documentize، لديك عدة خيارات لتنزيل الملفات الثنائية على نظامك. يرجى اختيار الطريقة التي تتماشى بشكل أفضل مع احتياجاتك المحددة.

تحذير

من خلال تنزيل SDK Documentize بأي شكل، فإنك توافق على EULA Smallize.

احصل على من NuGet

أبسط طريقة للبدء مع Documentize هي تثبيت حزمة .NET مباشرةً من NuGet. إليك بعض الطرق السريعة للقيام بذلك. لمزيد من التفاصيل، قم بزيارة دليل تثبيت NuGet.

dotnet add package Documentize
NuGet\Install-Package Documentize
<PackageReference Include="Documentize" Version="24.x.x" />

تنزيل مثبت MSI

خيار آخر للحصول على Documentize هو تحميل حزمة MSI، التي تثبت التجميعات اللازمة (DLLs). ما عليك سوى النقر على زر التنزيل التالي أو تعرف على المزيد حول هذه الطريقة في التثبيت في دليل تثبيت MSI.

تنزيل أحدث v25.7 MSI

تنزيل ZIP

يمكنك أيضًا تنزيل حزمة ZIP تحتوي على ملفات DLL فقط، والتي يمكنك تخزينها بأي طريقة ترغب بها. تعرف على المزيد عنها في دليل تثبيت ZIP.

تنزيل أحدث v25.7 ZIP
28‏/12‏/2024

توثيق الإصدارات الأقسام الفرعية

عن Documentize

ما هو Documentize؟

Documentize هو مكون قوي .NET يمكّن المطورين من إنشاء مستندات PDF احترافية ومتعددة الاستخدامات برمجياً، مما يلغي الحاجة إلى أدوات خارجية مثل Adobe Acrobat.

لماذا تستخدم Documentize؟

إليك لماذا تبرز Documentize:

  • إنشاء PDF بدون جهد: قم بإنشاء ملفات PDF بسيطة أو معقدة في الوقت الفعلي، مع دمج عناصر مثل الجداول والرسوم البيانية والصور والروابط التشعبية والخطوط المخصصة.
  • أمان معزز: دمج ميزات أمان قوية لحماية مستندات PDF الحساسة لديك.
  • خيارات تطوير مرنة: اختر بين إنشاء ملفات PDF باستخدام واجهة برمجة التطبيقات سهلة الاستخدام أو قوالب XML لتبسيط سير العمل.
  • تكامل مبسط: يندمج Documentize بسلاسة مع تطبيقات .NET المختلفة، بما في ذلك تطبيقات الويب ASP.NET والتطبيقات الخاصة بـ Windows، المكتوبة بلغات مثل C# و VB.NET و J#.
  • سريع وفعال: يقوم المكون الخفيف بإنشاء ملفات PDF بكفاءة، مما يحسن من أداء تطبيقك.
  • فعّال من حيث التكلفة ومدعوم: استمتع بسعر تنافسي، وأداء استثنائي، ودعم شامل لتجربة تطوير سلسة.

الميزات الرئيسية

  • دعم محتوى غني: أضف الجداول والرسوم البيانية والصور والروابط التشعبية والخطوط المخصصة، والمزيد إلى ملفات PDF الخاصة بك.
  • قدرات الضغط: تقليل حجم ملف PDF ليكون أكثر سهولة في التخزين والتوزيع.
  • أمان متقدم: تنفيذ ميزات الأمان لحماية المعلومات السرية داخل مستندات PDF الخاصة بك.
  • طرائق إنشاء مزدوجة: قم بإنشاء ملفات PDF باستخدام إما واجهة برمجة التطبيقات البرمجية أو قوالب XML لزيادة المرونة.
  • توافق عبر الأنظمة الأساسية: يعمل بسلاسة مع لغات .NET وأنواع التطبيقات المختلفة.
  • دعم متعدد الخيوط: يمكّن من إنشاء عدة ملفات PDF بشكل متزامن وآمن على خيوط مختلفة.
  • موارد التعلم: الوصول إلى عروض شاملة وأمثلة تعمل بلغة C# لتسريع عملية التطوير الخاصة بك.

الخيار المثالي للصناعات المتنوعة

تقدم Documentize خدماتها لمجموعة واسعة من الصناعات حيث تلعب إنشاء ملفات PDF دورًا حيويًا. تشمل هذه المجالات:

  • المالية والمحاسبة: إنشاء الفواتير والإيصالات والتقارير المالية وغيرها من المستندات المهمة.
  • الرعاية الصحية: إنشاء سجلات المرضى والوصفات الطبية وتقارير المختبر بتنسيق آمن وموحد.
  • التصنيع: إنتاج مواصفات المنتج وتقارير رقابة الجودة ومستندات الشحن.
  • الحكومة والقانون: إنشاء تصاريح ورخص وعقود ومستندات المحكمة مع ميزات أمان معززة.
  • التعليم: إنشاء شهادات وكشوفات و تقارير ومستندات أكاديمية أخرى.

يمكن لـ Documentize تمكين المطورين في مختلف الصناعات من تبسيط سير عمل إنشاء ملفات PDF، مما يضمن الكفاءة والأمان والمرونة.

28‏/12‏/2024

التثبيت

تثبيت Documentize SDK

يمكن تثبيت Documentize من خلال عدة طرق، كل منها مصمم ليناسب بيئات التطوير المختلفة والتفضيلات. فيما يلي الطرق الموصى بها لتثبيت Documentize:

1. NuGet (الطريقة المفضلة)

يعد NuGet الطريقة الأكثر سهولة وتفضيلاً لتثبيت Documentize، مما يضمن لك دائماً الحصول على أحدث إصدار وتحديثات مباشرة داخل بيئة التطوير الخاصة بك. تحقق من المزيد من التفاصيل حول هذه الطريقة للتثبيت في كيفية تثبيت Documentize SDKs باستخدام NuGet.

2. مثبت MSI

يعد مثبت MSI خيارًا مريحًا إذا كنت تفضل تثبيت مكتبات Documentize DLL مباشرة على نظامك. هذه الطريقة مثالية للمطورين الذين قد يرغبون في استخدام Documentize عبر مشاريع متعددة دون الحاجة إلى إدارة ملفات DLL يدويًا. تحقق من المزيد من التفاصيل حول هذه الطريقة للتثبيت في كيفية تثبيت Documentize SDKs باستخدام MSI.

3. أرشيف ZIP

بالنسبة للمطورين الذين يفضلون نهجًا يدويًا، يحتوي أرشيف ZIP على مكتبات Documentize DLL، التي يمكن استخراجها وإضافتها مباشرة إلى مشروعك. تحقق من المزيد من التفاصيل حول هذه الطريقة للتثبيت في كيفية تثبيت Documentize SDKs باستخدام ZIP.

28‏/12‏/2024

التثبيت الأقسام الفرعية

تثبيت Documentize عبر NuGet


بقشيش

NuGet هو مدير حزم مجاني ومفتوح المصدر لـ .NET يسهل إضافة وإزالة وتحديث المكتبات في مشاريع Visual Studio. يدير ملفات المكتبات والمراجع والتغييرات في التكوين تلقائيًا.

كيفية التثبيت عبر وحدة تحكم مدير الحزم NuGet

  1. افتح مشروعك:

    • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.
  2. الوصول إلى وحدة تحكم مدير الحزم:

    • انتقل إلى الأدوات > مدير حزم NuGet > وحدة تحكم مدير الحزم.
  3. تثبيت الحزمة:

    • لتثبيت أحدث إصدار كامل، أدخل الأمر Install-Package Documentize.
    • لتثبيت أحدث إصدار بما في ذلك الإصلاحات العاجلة، استخدم Install-Package Documentize -prerelease.
    • اضغط Enter لتنفيذ الأمر.

كيفية تحديث الحزمة عبر وحدة تحكم مدير الحزم NuGet

إذا كنت قد قمت بالفعل بتثبيت Documentize عبر NuGet وترغب في التحديث إلى أحدث إصدار:

  1. افتح مشروعك:

    • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.
  2. الوصول إلى وحدة تحكم مدير الحزم:

    • انتقل إلى الأدوات > مدير حزم NuGet > وحدة تحكم مدير الحزم.
  3. تحديث الحزمة:

    • للتحديث إلى أحدث إصدار كامل، أدخل Update-Package Documentize.
    • للتحديث إلى أحدث إصدار بما في ذلك الإصلاحات العاجلة، استخدم Update-Package Documentize -prerelease.
    • اضغط Enter لتنفيذ الأمر.

كيفية التثبيت عبر واجهة المستخدم الرسومية لمدير الحزم NuGet

  1. افتح مشروعك:

    • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.
  2. انتقل إلى إدارة حزم NuGet:

    • من قائمة المشروع، اختر إدارة حزم NuGet.
  3. بحث عن Documentize:

    • انتقل إلى علامة التبويب تصفح وادخل Documentize في مربع البحث.
  4. تثبيت الحزمة:

    • انقر على تثبيت/تحديث بجانب أحدث إصدار من Documentize.
    • أكد بالضغط على قبول في نافذة منبثقة.

مزايا استخدام NuGet

  • إدارة التبعيات تلقائيًا:

    • يدير NuGet التبعيات تلقائيًا، مما يضمن تضمين جميع المكتبات المطلوبة وتحديثها بشكل صحيح. وهذا يقلل من خطر فقدان أو عدم توافق التبعيات.
  • تحديثات مبسطة:

    • عملية تحديث الحزم بسيطة مع NuGet، سواء من خلال وحدة تحكم مدير الحزم أو واجهة المستخدم الرسومية. يجعل هذا من السهل الحفاظ على مكتباتك محدثة مع أحدث الميزات وإصلاحات الأخطاء.
  • متكامل مع Visual Studio:

    • يتم دمج NuGet بسلاسة مع Visual Studio، يوفر واجهة مستخدم سهلة لإدارة الحزم دون مغادرة بيئة التطوير.
  • إدارة الإصدارات:

    • يتيح لك NuGet تحديد وإدارة إصدارات مختلفة من المكتبات، مما يمكنك من العودة بسهولة إلى الإصدارات السابقة أو اختبار الإصدارات الجديدة دون تعطيل تطويرك.

عيوب استخدام NuGet

  • مقتصر على Visual Studio:

    • تم تصميم NuGet بشكل أساسي للاستخدام داخل Visual Studio. بالرغم من أنه يمكن استخدامه في بيئات أخرى، إلا أن التكامل هو الأكثر قوة في Visual Studio.
  • احتمالية تعارض الإصدارات:

    • في المشاريع الأكبر ذات العديد من التبعيات، قد تصبح إدارة الإصدارات وحل النزاعات معقدة. يوفر NuGet أدوات لإدارة ذلك، ولكنه يتطلب اهتمامًا دقيقًا.
  • اعتماد على الشبكة:

    • يتطلب تثبيت وتحديث الحزم اتصالاً بالإنترنت. إذا كنت تعمل في بيئة بها اتصال محدود أو لا يوجد اتصال بالإنترنت، قد تحتاج إلى استخدام طرق غير متصلة أو تحميل الحزم مسبقًا.
  • تعقيد للمشاريع الكبيرة:

    • بالنسبة للمشاريع الكبيرة جدًا ذات أشجار التبعيات الواسعة، قد يصبح العبء الناتج عن إدارة الحزم عبر NuGet مرهقًا. في مثل هذه الحالات، قد تكون أدوات أو استراتيجيات إضافية مطلوبة لإدارة التبعيات بفعالية.

تثبيت Documentize عبر MSI

بقشيش

مثبت MSI هو خيار مريح وسهل الاستخدام لتثبيت Documentize، خاصة إذا كنت تفضل أن يتم تثبيت المكتبات الديناميكية (DLLs) على مستوى النظام. هذه الطريقة تبسط عملية التثبيت من خلال أتمتة العديد من الخطوات المعنية.

كيفية التثبيت عبر مثبت MSI

  1. تحميل مثبت MSI:

    • انقر على v25.7 MSI لتحميل مثبت MSI لأحدث إصدار من Documentize.
  2. تشغيل المثبت:

    • انقر نقرًا مزدوجًا على ملف MSI الذي تم تحميله لبدء معالج التثبيت.
  3. اتباع معالج التثبيت:

    • اتبع التعليمات الظاهرة على الشاشة التي يقدمها المثبت. قد تحتاج إلى الموافقة على اتفاقية الترخيص واختيار خيارات التثبيت.
  4. إكمال التثبيت:

    • بمجرد اكتمال التثبيت، سيتم تثبيت مكتبات Documentize الديناميكية (DLLs) في ذاكرة التخزين المؤقت العامة (GAC) للنظام أو في موقع محدد آخر.
  5. التحقق من التثبيت:

    • تحقق من أن المكتبات الديناميكية قد تم تثبيتها بشكل صحيح من خلال التحقق من وجودها في دليل التثبيت المحدد أو في GAC.

مزايا استخدام مثبت MSI

  • سهولة الاستخدام:

    • يوفر مثبت MSI عملية تثبيت بسيطة وموجهة. يتولى جميع التكوينات اللازمة ويضع المكتبات الديناميكية في موقع مركزي، مما يسهل استخدام Documentize عبر مشاريع متعددة.
  • تثبيت على مستوى النظام:

    • تثبت طريقة MSI Documentize في ذاكرة التخزين المؤقت العامة (GAC) للنظام أو في موقع مركزي آخر. وهذا يسمح لأي تطبيق على النظام بالوصول إلى المكتبات الديناميكية دون الحاجة إلى الإشارة إليها بشكل فردي في كل مشروع.
  • تحديثات مؤتمتة:

    • إذا قدمت Documentize مثبتًا محدثًا، يمكنك بسهولة تحديث تثبيتك عن طريق تشغيل ملف MSI الجديد، والذي يتولى عادةً عملية التحديث بسلاسة.
  • اتساق:

    • يضمن استخدام مثبت MSI أن جميع الملفات المطلوبة تُثبت بشكل صحيح ومتسق عبر بيئات مختلفة، مما يقلل من خطر فقدان أو عدم مكان المكتبات الديناميكية.

عيوب استخدام مثبت MSI

  • مرونة محدودة:

    • يثبت مثبت MSI Documentize في موقع على مستوى النظام، وهو ما قد لا يكون مناسبًا لجميع بيئات التطوير. قد تفتقر هذه الطريقة إلى المرونة لتلبية تكوينات أو إصدارات خاصة بالمشاريع.
  • العبء المحتمل:

    • يمكن أن يؤدي تثبيت المكتبات الديناميكية في GAC إلى إدخال عبء وتعقيد، خاصة في السيناريوهات التي قد تحتاج فيها إلى نسخ متعددة من Documentize في وقت واحد.
  • إزالة يدوية:

    • إذا كنت بحاجة إلى إلغاء تثبيت Documentize، يجب عليك استخدام برنامج إلغاء التثبيت المقدم من MSI، مما قد يترك ملفات أو تكوينات متبقية إذا لم يتم إدارتها بشكل صحيح.
  • تعارضات الإصدارات:

    • يمكن أن تؤدي التثبيتات على مستوى النظام إلى تعارضات في الإصدارات إذا كانت المشاريع المختلفة تتطلب إصدارات مختلفة من Documentize. قد يتطلب إدارة هذه التعارضات تكوينات أو تنظيف إضافي.

تثبيت Documentize عبر ZIP

بقشيش

أرشيف ZIP مثالي للمطورين الذين يفضلون النهج اليدوي في إدارة المكتبات. تتيح لك هذه الطريقة تنزيل واستخراج ملفات DLL الضرورية مباشرة دون الاعتماد على مدير حزم أو مُثبِّت.

كيفية التثبيت عبر أرشيف ZIP

  1. تنزيل أرشيف ZIP:

    • انقر على v25.7 ZIP لتنزيل أحدث إصدار من Documentize بتنسيق أرشيف.
  2. استخراج المحتويات:

    • بعد التنزيل، قم باستخراج محتويات ملف ZIP إلى دليل من اختيارك. يمكنك اختيار الاحتفاظ بهذه الملفات في دليل مشترك أو ضمن هيكل مشروعك.
  3. إضافة المراجع إلى مشروعك:

    • افتح مشروعك في بيئة تطويرك (على سبيل المثال، Visual Studio).
    • انتقل إلى مشروع > إضافة مرجع > تصفح وانتقل إلى الدليل حيث قمت باستخراج ملفات DLL.
    • حدد ملفات DLL ذات الصلة وأضفها كمراجع لمشروعك.
  4. التحديثات اليدوية:

    • إذا تم إصدار إصدار جديد من Documentize، فستحتاج إلى تنزيل أرشيف ZIP المحدث يدويًا واستبدال ملفات DLL القديمة في مشروعك بالملفات الجديدة.

مزايا استخدام أرشيف ZIP

  • تحكم كامل:

    • لديك السيطرة الكاملة على مكان وكيفية تخزين ملفات DLL والإشارة إليها في مشروعك. يمكن أن يكون ذلك مفيدًا إذا كنت تفضل إعدادًا مخصصًا أو تحتاج إلى إدارة التبعيات يدويًا.
  • عدم الاعتماد على مديري الحزم:

    • على عكس NuGet، لا تعتمد على مدير حزم للتعامل مع التثبيتات. يمكن أن يكون ذلك مفيدًا في البيئات التي لا تتوفر فيها مديري الحزم أو لا يُفضل استخدامها.
  • قابلية النقل:

    • يمكن مشاركة أرشيف ZIP بسهولة ونقله عبر أنظمة مختلفة، مما يجعله مثاليًا للمشاريع التي تحتاج إلى أن تكون قابلة للنقل أو التوزيع دون الاعتماد على أدوات خارجية.

عيوب استخدام أرشيف ZIP

  • إدارة يدويه:

    • على عكس NuGet، حيث يتم أتمتة التحديثات وإدارة التبعيات، مع أرشيف ZIP، يجب عليك إدارة التحديثات يدويًا والتأكد من أن جميع ملفات DLL المطلوبة تم الإشارة إليها بشكل صحيح.
  • خطر تضارب الإصدارات:

    • إذا كنت تدير مشاريع متعددة أو تعمل في فريق، هناك خطر من تضارب الإصدارات إذا كانت المشاريع المختلفة تستخدم إصدارات مختلفة من ملفات DLL. يتطلب ذلك تتبعًا دقيقًا للإصدارات عبر المشاريع.
  • عدم وجود تحديثات تلقائية:

    • لن تتلقى تحديثات تلقائية أو إشعارات عند توفر إصدار جديد. يمكن أن يؤدي ذلك إلى خطر استخدام مكتبات قديمة ما لم تتحقق بانتظام من التحديثات.

بيئة غير ويندوز

العمل مع مكتبات .NET Core DLLs في بيئة غير ويندوز

نظرًا لأن Documentize لـ .NET يوفر دعم .NET Standard 2.0 (.NET Core 2.0)، يمكن استخدامه في تطبيقات Core التي تعمل على أنظمة تشغيل تشبه لينكس. نحن نعمل باستمرار على تحسين دعم .NET Core في واجهة برمجة التطبيقات الخاصة بنا. ومع ذلك، هناك بعض العمليات التي نوصي عملائنا بأدائها للحصول على نتائج أفضل عند استخدام ميزات Documentize لـ .NET. يرجى تثبيت:

  • حزمة libgdiplus
  • حزمة تحتوي على خطوط متوافقة مع Microsoft: ttf-mscorefonts-installer (على سبيل المثال، sudo apt-get install ttf-mscorefonts-installer). يجب وضع هذه الخطوط في دليل /usr/share/fonts/truetype/msttcorefonts حيث يقوم Documentize لـ .NET بفحص هذا المجلد على أنظمة تشغيل تشبه لينكس. في حال كان نظام التشغيل لديه مجلد/دليل افتراضي آخر للخطوط، يجب عليك استخدام السطر التالي من التعليمات البرمجية قبل إجراء أي عملية باستخدام Documentize:
    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<مسار المستخدم إلى خطوط Microsoft>"));

تقييم

تقييم Documentize لـ .NET

يمكنك تحميل Documentize لـ .NET بسهولة للتقييم. تحميل النسخة التجريبية هو نفسه تحميل النسخة المشتراة. النسخة التجريبية تصبح مرخصة ببساطة عندما تضيف بعض الأسطر من الكود لتطبيق الترخيص.

توفر النسخة التجريبية من Documentize (بدون ترخيص محدد) جميع ميزات المنتج، ولكن لديها حدان: تقوم بإدراج علامة مائية للتقييم، ويمكن عرض/edit أربعة عناصر فقط من أي مجموعة.

إذا كنت ترغب في تجربة Documentize لـ .NET بدون قيود النسخة التجريبية، يمكنك أيضًا طلب ترخيص مؤقت لمدة 30 يومًا. يرجى الإشارة إلى كيفية الحصول على ترخيص مؤقت؟

28‏/12‏/2024

ما الجديد

v25.7

  • تحسين قابلية استخدام مستخرج النصوص
  • تحسين قابلية استخدام محوّل HTML
  • تحسين قابلية استخدام مستخرج الصور

v25.6

  • تحسين قابلية استخدام محول TIFF

v25.5

  • إضافة المكون الإضافي الجديد: Form Exporter
  • تحسين قابلية الاستخدام في الأمان

v25.4

  • تحسين قابلية استخدام المحسّن
  • تحسين قابلية استخدام الملحق المفسر
  • تحسين قابلية استخدام الملحق الموحد

v25.3

  • إضافة إضافة جديدة: مُسطّح النموذج

v25.2

  • إضافة ملحق جديد: مولد جدول المحتويات

v25.1

  • تحسين المكون الإضافي: ImageExtractor

v24.12

  • أضيفت ملحق جديد: محول PDF إلى PNG
  • أضيفت ملحق جديد: محول PDF إلى TIFF
  • أضيفت ملحق جديد: مُولد جدول PDF
  • إعادة تسمية الفئة PdfDoc إلى DocConverter

v24.11

  • إضافة مكون إضافي جديد: محول PDF إلى JPEG
  • إضافة فئة DirectoryDataSource
  • إضافة فئة PdfToJpegOptions

v24.10

  • إضافة ملحق جديد: محول PDF/A

v24.9

  • تم الإصدار
28‏/12‏/2024

ما الجديد الأقسام الفرعية

v25.7

تحسين قابلية استخدام مستخرج النصوص

  • Class TextExtractor: ثابت ولا يتطلب استخدام منشئ.
  • Class TextExtractor: سلوك محسّن عند التشغيل في وضع التقييم. لا استثناء مع مستندات تزيد عن 4 صفحات.
  • Class TextExtractor: تم إصلاح مشكلات في طريقة Process.
  • Class PdfExtractorOptions: تمت إزالته.
  • Class TextExtractorOptions: تم إعادة هيكلة.
  • Enum TextFormattingMode: تمت إعادة تسميته وتحسينه.

مثال على الاستخدام:

// المثال يوضح كيفية استخراج محتوى النص من مستند PDF.
// إنشاء كائن TextExtractorOptions لتحديد التعليمات
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تنفيذ العملية
var results = TextExtractor.Process(options);
// الحصول على النص المستخرج من كائن ResultContainer
var textExtracted = results.ResultCollection[0].ToString();

تحسين قابلية استخدام محوّل HTML

  • Class HtmlConverter: ثابت ولا يتطلب استخدام منشئ.
  • Class HtmlConverter: تم إصلاح مشكلات في طريقة Process.
  • Class HtmlConverter: تمت إزالة منطق IDisposable.
  • Class PdfConverterOptions: تمت إزالته.

أمثلة على الاستخدام:

// المثال يوضح كيفية تحويل PDF إلى مستند HTML.
// إنشاء كائن PdfToHtmlOptions لتحديد نوع بيانات الإخراج كملف مع موارد مضمنة
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.pdf"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.html"));
// تنفيذ العملية
HtmlConverter.Process(options);

// المثال يوضح كيفية تحويل HTML إلى مستند PDF.
// إنشاء HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_input.html"));
// تحديد مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// تنفيذ العملية
HtmlConverter.Process(options);

تحسين قابلية استخدام مستخرج الصور

  • Class ImageExtractor: ثابت ولا يتطلب استخدام منشئ.

مثال على الاستخدام:

// المثال يوضح كيفية استخراج الصور من مستند PDF.
// إنشاء ImageExtractorOptions لتحديد التعليمات
var options = new ImageExtractorOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار الدليل للإخراج
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
var results = ImageExtractor.Process(options);
// الحصول على مسار نتيجة الصورة
var imageExtracted = results.ResultCollection[0].ToFile();

إصلاحات طفيفة

  • إصلاحات داخلية.
  • إصلاح الأمثلة والتلميحات لمحّول TIFF.
  • تقليل مدة تحسين الصفحة.
  • إصلاح: صورة الإخراج غير صحيحة من تحويل PDF إلى PNG.
  • إصلاح: عدم عرض الأحرف الصينية بشكل صحيح أثناء تحويل PDF إلى PNG.
  • تحسين: الأداء أثناء تحويل PDF إلى HTML.
10‏/07‏/2025

v25.6

تحسين قابلية استخدام محول TIFF

  • Class PdfToTiffOptions: تمت إضافة معلمة إضافية للتحويل - الضغط.
  • Class PdfToTiffOptions: تمت إضافة معلمة إضافية للتحويل - عمق اللون.
  • Class TiffConverter ثابت ولا يتطلب استخدام مُنشئ.
  • تحسين الأمثلة الرئيسية.

أمثلة الاستخدام:

// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق TIFF.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// تنفيذ العملية
TiffConverter.Process(options);

// المثال يوضح كيفية تحويل مستند PDF إلى تنسيق TIFF مع معاملات إضافية.
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var options = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تحديد مسار دليل الإخراج
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// معاملات اختيارية
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// تنفيذ العملية
TiffConverter.Process(options);

إصلاحات طفيفة

  • إصلاحات داخلية.
10‏/07‏/2025

v25.5

إضافة المكون الإضافي الجديد: Form Exporter

  • Class FormExporter: يمثل مكون Documentize.FormExporter الذي يُستخدم لتصدير قيم النماذج من مستندات PDF إلى ملف DSV أو CSV
  • Class FormExportToDsvOptions: يمثل الخيارات لتصدير قيم مستندات PDF إلى ملف DSV أو CSV من خلال مكون Documentize.FormExporter.

مثال على الاستخدام:

// مثال يوضح كيفية تصدير قيم النماذج إلى ملف CSV.
// إنشاء كائن FormExportToDsvOptions لضبط التعليمات
var options = new FormExportToDsvOptions(',', true);
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// تنفيذ العملية
FormExporter.Process(options);

تحسين قابلية الاستخدام في الأمان

  • الفئة ثابتة ولا تتطلب استخدام مُنشئ.
  • تحسين الأمثلة الرئيسية.

أمثلة على الاستخدام:

// المثال يوضح كيفية تشفير مستند PDF.
// إنشاء كائن EncryptionOptions لضبط التعليمات
var options = new EncryptionOptions("123456", "qwerty");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Security.Process(options);

// المثال يوضح كيفية فك تشفير مستند PDF.
// إنشاء كائن DecryptionOptions لضبط التعليمات
var options = new DecryptionOptions("123456");
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
Security.Process(options);

إصلاحات طفيفة

  • تحسين تلميحات الفئة والتراخيص.
10‏/07‏/2025

v25.4

تحسين قابلية استخدام المحسّن

  • الصنف ثابت ولا يتطلب استخدام مُنشئ.
  • تحسين المثال الرئيسي.
  • إضافة أمثلة إضافية.

استخدام الأمثلة:

// المثال يوضح كيفية تحسين مستند PDF.
// إنشاء كائن OptimizeOptions لتعيين التعليمات
var options = new OptimizeOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

// المثال يوضح كيفية تدوير مستند PDF.
// إنشاء كائن RotateOptions لتعيين التعليمات
var options = new RotateOptions();
// تعيين الدوران الجديد
options.Rotation = Rotation.On90;
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

// المثال يوضح كيفية تغيير حجم مستند PDF.
// إنشاء كائن ResizeOptions لتعيين التعليمات
var options = new ResizeOptions();
// تعيين حجم الصفحة الجديد
options.PageSize = PageSize.A3;
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

// المثال يوضح كيفية ضغط مستند PDF.
// إنشاء كائن CompressOptions لتعيين التعليمات
var options = new CompressOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Optimizer.Process(options);

تحسين قابلية استخدام الملحق المفسر

  • الصنف ثابت ولا يتطلب استخدام مُنشئ.
  • تحسين المثال الرئيسي.

استخدام الأمثلة:

// المثال يوضح كيفية تقسيم مستند PDF.
// إنشاء كائن SplitOptions لتعيين التعليمات
var options = new SplitOptions();
// إضافة مسار الملف المدخل
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسارات الملفات الناتجة
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// إجراء العملية
Splitter.Process(options);

تحسين قابلية استخدام الملحق الموحد

  • الصنف ثابت ولا يتطلب استخدام مُنشئ.
  • تحسين المثال الرئيسي.

استخدام الأمثلة:

// المثال يوضح كيفية دمج مستندين PDF.
// إنشاء كائن MergeOptions لتعيين التعليمات
var options = new MergeOptions();
// إضافة مسارات الملفات المدخلة
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// إجراء العملية
Merger.Process(options);

إصلاحات طفيفة

  • تحسين تلميحات الصفوف.
10‏/07‏/2025

v25.3

إضافة إضافة جديدة: مُسطّح النموذج

  • Class FormFlattener: يمثل إضافة Documentize.FormFlattener المستخدمة لتسطح الحقول في مستندات PDF.
  • Class FormFlattenerOptions: تمثل الخيارات لتسطح الحقول في المستند بواسطة إضافة Documentize.FormFlattener.

مثال على الاستخدام:

//المثال يوضح كيفية تسطح الحقول في ملف PDF.  
// إنشاء كائن FormFlattenerOptions لتحديد التعليمات  
var options = new FormFlattenerOptions();  
// إضافة مسار ملف الإدخال  
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));  
// تعيين مسار ملف الإخراج  
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));  
//معامل اختياري لتخطي الحقل الذي يحمل الاسم "Surname".
options.SkipFields.Add("Surname");  
// تنفيذ العملية  
FormFlattener.Process(options);  

//المثال يوضح كيفية الحصول على أسماء الحقول من ملف PDF.  
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");  

إصلاحات طفيفة

  • تحسين تلميحات الصفوف والأمثلة.
10‏/07‏/2025

v25.2

إضافة ملحق جديد: مولد جدول المحتويات

  • Class TocGenerator: يمثل ملحق Documentize.TocGenerator. يُستخدم لإضافة جدول محتويات إلى مستندات PDF.
  • Class TocOptions: يمثل الخيارات لإضافة جدول محتويات إلى المستند بواسطة ملحق Documentize.TocGenerator.
  • Class TocHeading: يمثل الخيارات للعناوين أو العناوين الفرعية لجدول المحتويات في المستند بواسطة ملحق Documentize.TocGenerator.

مثال على الاستخدام:

// المثال يوضح كيفية إضافة جدول محتويات إلى ملف PDF.
var options = new TocOptions();
// تعيين العنوان
options.Title = "جدول محتويات";
// توليد الروابط في العلامات
options.GenerateBookmarks = true;
// تصميم العناوين
options.Headings.Add(new TocHeading("المقدمة", 2, false, 1));
options.Headings.Add(new TocHeading("الفصل الأول", 3, true, 1));
options.Headings.Add(new TocHeading("الفصل الثاني", 4, true, 1));
options.Headings.Add(new TocHeading("مثال A", 4, true, 2));
options.Headings.Add(new TocHeading("مثال B", 4, true, 2));
options.Headings.Add(new TocHeading("مثال C", 4, true, 2));
options.Headings.Add(new TocHeading("مثال D", 4, true, 2));
options.Headings.Add(new TocHeading("الفصل الثالث", 5, true, 1));
// إضافة مسار ملف الإدخال
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار الملف الناتج
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// تنفيذ العملية
TocGenerator.Process(options);

إصلاحات طفيفة

  • تحسين تلميحات الفصول والأمثلة.
  • تحديث العلامات المائية.
  • تحسين تحويل PDF إلى XSLX.
  • تحسين تحويل PDF إلى PDF/A-1a.
10‏/07‏/2025

v25.1

تحسين المكون الإضافي: ImageExtractor

  • إضافة تجميع المخرجات إلى ImageExtractorOptions.
  • إضافة دعم لمدخلات متعددة إلى ImageExtractorOptions.
  • إصلاح تدفقات المخرجات المغلقة.

مثال على الاستخدام:

// انشاء كائن ImageExtractor لاستخراج الصور
var plugin = new ImageExtractor();
// انشاء ImageExtractorOptions
var opt = new ImageExtractorOptions();
// إضافة مسار ملف المدخل
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين دليل المخرجات
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ عملية الاستخراج
var resultContainer = plugin.Process(opt);
// الحصول على الصورة من كائن ResultContainer
var imageExtracted = resultContainer.ResultCollection[0].ToFile();

إصلاحات صغيرة

  • تحسين تلميحات الفئات والأمثلة.
  • التحقق من صحة توقيع PDF.
  • تحسين دعم الأحرف الصينية.
10‏/07‏/2025

v24.12

أضيفت ملحق جديد: محول PDF إلى PNG

  • الفئة PngConverter: تمثل ملحق Documentize.PngConverter. تستخدم لتحويل مستندات PDF إلى تنسيق PNG.
  • الفئة PdfToPngOptions: تمثل خيارات محول PDF إلى PNG لملحق Documentize.PngConverter.

مثال على الاستخدام:

// إنشاء PngConverter
var plugin = new PngConverter();
// إنشاء كائن PdfToPngOptions لتحديد التعليمات
var opt = new PdfToPngOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
plugin.Process(opt);

أضيفت ملحق جديد: محول PDF إلى TIFF

  • الفئة TiffConverter: تمثل ملحق Documentize.TiffConverter. تستخدم لتحويل مستندات PDF إلى تنسيق TIFF.
  • الفئة PdfToTiffOptions: تمثل خيارات محول PDF إلى TIFF لملحق Documentize.TiffConverter.

مثال على الاستخدام:

// إنشاء TiffConverter
var plugin = new TiffConverter();
// إنشاء كائن PdfToTiffOptions لتحديد التعليمات
var opt = new PdfToTiffOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// تنفيذ العملية
plugin.Process(opt);

أضيفت ملحق جديد: مُولد جدول PDF

  • الفئة TableGenerator: تمثل ملحق Documentize.TableGenerator. تستخدم لإضافة جدول إلى مستند PDF.
  • الفئة TableBuilder: تمثل البناء للجدول في صفحة PDF.
  • الفئة TableRowBuilder: تمثل البناء لصف الجدول.
  • الفئة TableRowBuilder: تمثل البناء لخلية الجدول.

مثال على الاستخدام:

// إنشاء TableGenerator
var plugin = new TableGenerator();
// إنشاء كائن TableOptions لتحديد التعليمات
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Name")
            .AddCell().AddParagraph("Age")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// تعيين مسار ملف الإخراج
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// تنفيذ العملية
plugin.Process(opt);

إعادة تسمية الفئة PdfDoc إلى DocConverter

  • الفئة DocConverter: تمثل ملحق Documentize.DocConverter. تستخدم لتحويل مستندات PDF إلى تنسيق DOC/DOCX.

مثال على الاستخدام:

// إنشاء DocConverter
var plugin = new DocConverter();
// إنشاء كائن PdfToDocOptions لتحديد التعليمات
var opt = new PdfToDocOptions();
// إضافة مسار ملف الإدخال
opt.AddInput(new FileDataSource(inputPath));
// تعيين مسار ملف الإخراج
opt.AddOutput(new FileDataSource(outputPath));
// تنفيذ العملية
plugin.Process(opt);
10‏/07‏/2025

v24.11

إضافة مكون إضافي جديد: محول PDF إلى JPEG

  • الهدف: تم تصميم فئة JpegConverter لتحويل مستندات PDF إلى تنسيق JPEG، مما يسهل على المستخدمين التعامل مع الصور المشتقة من مستندات PDF ومشاركتها.
  • الباني:
    • JpegConverter(): يقوم بتهيئة مثيل جديد من محول JPEG.

مثال على الاستخدام:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);
  • الطريقة:
    • Process(PdfToJpegOptions options): يبدأ عملية تحويل JPEG باستخدام الخيارات المحددة.

إضافة فئة DirectoryDataSource

  • الهدف: تتيح فئة DirectoryDataSource للمستخدمين إدارة بيانات الدليل لعمليات التحميل والحفظ داخل المكونات الإضافية.
  • الباني:
    • DirectoryDataSource(string path): يقوم بتهيئة كائن بيانات دليل جديد باستخدام المسار المحدد.

مثال على الاستخدام:

var directorySource = new DirectoryDataSource("path_to_your_directory");
  • الخصائص:
    • DataType: يسترجع نوع مصدر البيانات.
    • Path: يحصل على مسار الدليل الحالي للبيانات.

إضافة فئة PdfToJpegOptions

  • الهدف: تحتوي هذه الفئة على خيارات لتكوين عملية تحويل JPEG، مما يسمح للمستخدمين بتحديد الدقة، قوائم الصفحات، وجودة الصورة.
  • الباني:
    • PdfToJpegOptions(): يقوم بتهيئة مثيل خيارات جديد لمحول JPEG.

الخصائص:

  • OutputResolution: يحدد دقة الصور الناتجة عن JPEG.
  • PageList: قائمة بالصفحات للتحويل من PDF.
  • Quality: يحدد جودة ناتج JPEG.
10‏/07‏/2025

v24.10

إضافة ملحق جديد: محول PDF/A

  • تم تقديم ميزة جديدة لتحويل PDF/A، مما يسمح للمستخدمين بتحويل ملفات PDF القياسية بسهولة إلى مستندات متوافقة مع PDF/A.

مثال على الاستخدام:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

إصلاحات الأخطاء

  • تم إصلاح مشكلات تتعلق بفئة FileResult والتي أدت إلى مسارات مخرجات غير صحيحة.
  • تم حل أخطاء صغيرة تؤثر على HtmlConverter عند التعامل مع ملفات كبيرة.

تحسينات

  • تحسين أداء PdfExtractor و ImageExtractor للحصول على أوقات معالجة أسرع.
  • تحديث فئة RotateOptions لدعم زوايا دوران إضافية.
10‏/07‏/2025

v24.9

تم الإصدار

 عربي