تثبيت Documentize عبر NuGet

كيفية التثبيت عبر وحدة تحكم مدير الحزم 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

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

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>"));

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: تمثل الفئة التي تُستخدم لبناء صف جدول.
• الفئة TableCellBuilder: تمثل الفئة التي تُستخدم لبناء خلية جدول.

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

// إنشاء 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);

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.

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 لدعم زوايا دوران إضافية.

v24.9

صدر