نصب 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 را فشار دهید.

چگونه از طریق رابط GUI مدیر بسته NuGet نصب کنیم

1. پروژه خود را باز کنید:

   • Visual Studio را راه‌اندازی کرده و برنامه .NET خود را باز کنید.

2. به مدیریت بسته‌های NuGet بروید:

   • از منوی پروژه، گزینه مدیریت بسته‌های NuGet را انتخاب کنید.

3. برای Documentize جستجو کنید:

   • به زبانه بررسی بروید و Documentize را در کادر جستجو وارد کنید.

4. بسته را نصب کنید:

   • روی نصب/به‌روزرسانی کنار آخرین نسخه Documentize کلیک کنید.
   • با کلیک بر روی پذیرفتن در پنجره پاپ آپ، تأیید کنید.

مزایای استفاده از NuGet

• مدیریت وابستگی خودکار:

  • NuGet به صورت خودکار وابستگی‌ها را مدیریت می‌کند و اطمینان می‌دهد که همه کتابخانه‌های مورد نیاز به درستی شامل و به روز هستند. این خطر عدم وجود یا ناسازگاری وابستگی‌ها را کاهش می‌دهد.

• به‌روزرسانی‌های ساده‌شده:

  • به‌روزرسانی بسته‌ها با NuGet ساده است، چه از طریق کنسول مدیر بسته و چه از طریق GUI. این کار نگه‌داشتن کتابخانه‌های شما به‌روز با آخرین ویژگی‌ها و اصلاحات باگ را آسان می‌کند.

• ادغام با Visual Studio:

  • NuGet به طور یکپارچه با Visual Studio ادغام شده و یک رابط کاربری دوستانه برای مدیریت بسته‌ها بدون ترک محیط توسعه فراهم می‌کند.

• نسخه بندی:

  • NuGet به شما اجازه می‌دهد تا نسخه‌های مختلف کتابخانه‌ها را مشخص و مدیریت کنید، که به شما امکان می‌دهد به راحتی به نسخه‌های قبلی بازگردید یا نسخه‌های جدید را بدون مختل کردن توسعه خود آزمایش کنید.

معایب استفاده از NuGet

• محدود به Visual Studio:

  • NuGet عمدتاً برای استفاده در Visual Studio طراحی شده است. اگرچه می‌توان در محیط‌های دیگر هم از آن استفاده کرد، اما ادغام آن در Visual Studio قوی‌تر است.

• امکان تداخل نسخه‌ها:

  • در پروژه‌های بزرگ با وابستگی‌های زیاد، مدیریت نسخه‌ها و حل تعارضات می‌تواند پیچیده شود. NuGet ابزارهایی برای مدیریت این موضوع فراهم می‌کند، اما نیاز به توجه دقیق دارد.

• وابستگی به شبکه:

  • نصب و به‌روزرسانی بسته‌ها به یک اتصال اینترنتی نیاز دارد. اگر در محیطی با دسترسی محدود یا بدون اینترنت کار می‌کنید، ممکن است نیاز به استفاده از روش‌های آفلاین یا پیش‌دانلود بسته‌ها داشته باشید.

• پیچیدگی برای پروژه‌های بزرگ:

  • برای پروژه‌های بسیار بزرگ با درخت‌های وابستگی گسترده، مدیریت بسته‌ها از طریق NuGet می‌تواند cumbersome شود. در چنین مواردی، ممکن است به ابزارها یا استراتژی‌های اضافی نیاز باشد تا وابستگی‌ها به طور مؤثر مدیریت شوند.

نصب Documentize از طریق MSI

چگونگی نصب از طریق نصب‌کننده MSI

1. نصب‌کننده MSI را دانلود کنید:

   • بر روی v24.12 MSI کلیک کنید تا نصب‌کننده MSI را برای آخرین نسخه Documentize دانلود کنید.

2. نصب‌کننده را اجرا کنید:

   • با دوبار کلیک بر روی فایل MSI دانلود شده، جادوگر نصب را شروع کنید.

3. دنبال کردن جادوگر نصب:

   • دستورالعمل‌های روی صفحه که توسط نصب‌کننده ارائه شده است را دنبال کنید. ممکن است نیاز باشد که به توافق‌نامه مجوز موافقت کنید و گزینه‌های نصب را انتخاب کنید.

4. پایان نصب:

   • پس از اتمام نصب، DLLهای Documentize در کش Assembly جهانی (GAC) یا مکان دیگری که مشخص شده است، نصب خواهند شد.

5. بررسی نصب:

   • بررسی کنید که DLLها به درستی نصب شده‌اند با تأیید حضور آن‌ها در دایرکتوری نصب مشخص شده یا GAC.

مزایای استفاده از نصب‌کننده MSI

• راحتی استفاده:

  • نصب‌کننده MSI یک فرآیند نصب ساده و هدایت‌شده ارائه می‌دهد. تمام پیکربندی‌های لازم را مدیریت می‌کند و DLLها را در یک مکان مرکزی قرار می‌دهد، که کار با Documentize را در پروژه‌های متعدد آسان می‌کند.

• نصب سراسری:

  • روش MSI Documentize را به کش Assembly جهانی (GAC) یا مکان مرکزی دیگری نصب می‌کند. این امکان را فراهم می‌کند که هر برنامه‌ای در سیستم بدون نیاز به ارجاع به DLLها به‌صورت جداگانه در هر پروژه، به آنها دسترسی پیدا کند.

• به‌روزرسانی‌های خودکار:

  • اگر Documentize نصب‌کننده به‌روز شده‌ای ارائه دهد، می‌توانید به سادگی نصب خود را با اجرای فایل MSI جدید به‌روز کنید که به‌طور معمول فرآیند به‌روزرسانی را به‌نرمی مدیریت می‌کند.

• ثبات:

  • استفاده از نصب‌کننده MSI اطمینان می‌دهد که تمام فایل‌های مورد نیاز به‌درستی و به‌طور مداوم در محیط‌های مختلف نصب شده‌اند، که خطر آسیب‌دیدگی یا گم‌شدن DLLها را کاهش می‌دهد.

معایب استفاده از نصب‌کننده MSI

• انعطاف‌پذیری محدود:

  • نصب‌کننده MSI Documentize را به یک مکان سراسری نصب می‌کند که ممکن است برای تمام محیط‌های توسعه مناسب نباشد. ممکن است فاقد انعطاف‌پذیری باشد تا پیکربندی‌ها یا نسخه‌های خاص پروژه را پشتیبانی کند.

• بار اضافی بالقوه:

  • نصب DLLها به GAC می‌تواند بار اضافی و پیچیدگی را به‌ویژه در سناریوهایی که ممکن است نیاز به چندین نسخه از Documentize به‌طور همزمان باشد، معرفی کند.

• حذف دستی:

  • اگر نیاز به حذف Documentize دارید، باید از ابزار حذف ارائه شده توسط MSI استفاده کنید که ممکن است فایل‌ها یا پیکربندی‌های باقی‌مانده‌ای را در صورت مدیریت نادرست به جا بگذارد.

• تعارض نسخه‌ها:

  • نصب‌های سراسری می‌توانند به تعارض نسخه‌ها منجر شوند اگر پروژه‌های مختلف نیاز به نسخه‌های مختلف Documentize داشته باشند. مدیریت این تعارض‌ها ممکن است به پیکربندی یا پاک‌سازی اضافی نیاز داشته باشد.

نصب Documentize از طریق ZIP

نحوه نصب از طریق آرشیو ZIP

1. دانلود آرشیو ZIP:

   • بر روی v24.12 ZIP کلیک کنید تا آخرین نسخه Documentize را در فرم آرشیو دانلود کنید.

2. استخراج محتویات:

   • پس از دانلود، محتویات فایل ZIP را به یک دایرکتوری دلخواه استخراج کنید. می‌توانید تصمیم بگیرید که این فایل‌ها را در یک دایرکتوری مشترک نگه‌دارید یا در ساختار پروژه‌تان.

3. اضافه کردن مرجع به پروژه‌تان:

   • پروژه‌تان را در IDE خود (مثلاً Visual Studio) باز کنید.
   • به Project > Add Reference > Browse بروید و به دایرکتوری که DLLها را در آن استخراج کرده‌اید، بروید.
   • DLLهای مربوطه را انتخاب کرده و به عنوان مرجع به پروژه‌تان اضافه کنید.

4. به‌روزرسانی‌های دستی:

   • اگر نسخه جدیدی از Documentize منتشر شود، شما باید به‌طور دستی آرشیو ZIP بروزرسانی شده را دانلود کرده و فایل‌های DLL قدیمی را در پروژه‌تان با نسخه جدید جایگزین کنید.

مزایای استفاده از آرشیو ZIP

• کنترل کامل:

  • شما کنترل کامل بر روی اینکه DLLها کجا و چگونه در پروژه‌تان ذخیره و ارجاع داده شوند، دارید. این می‌تواند در صورتی که تنظیمات سفارشی را ترجیح دهید یا نیاز به مدیریت دستی وابستگی‌ها داشته باشید، مفید باشد.

• عدم وابستگی به مدیران بسته:

  • بر خلاف NuGet، شما به یک مدیر بسته برای مدیریت نصب‌ها وابسته نیستید. این می‌تواند در محیط‌هایی که مدیران بسته موجود نیستند یا مورد استفاده قرار نمی‌گیرند، سودمند باشد.

• قابلیت حمل:

  • آرشیو ZIP به راحتی قابل اشتراک‌گذاری و جابجایی بین سیستم‌های مختلف است و این دارا بودن ایده‌آل برای پروژه‌هایی است که باید قابل حمل یا توزیع بدون وابستگی به ابزارهای خارجی باشند.

معایب استفاده از آرشیو ZIP

• مدیریت دستی:

  • بر خلاف NuGet، که به‌روزرسانی‌ها و مدیریت وابستگی‌ها به‌طور خودکار انجام می‌شود، در آرشیو ZIP شما باید به‌طور دستی به مدیریت به‌روزرسانی‌ها بپردازید و اطمینان حاصل کنید که تمام DLLهای لازم به‌طور صحیح ارجاع داده شده‌اند.

• ریسک درگیری نسخه‌ها:

  • اگر چندین پروژه را مدیریت می‌کنید یا در یک تیم کار می‌کنید، خطر درگیری نسخه‌ها وجود دارد اگر پروژه‌های مختلف از نسخه‌های مختلف DLLها استفاده کنند. این نیازمند پیگیری دقیق نسخه‌ها در پروژه‌های مختلف است.

• عدم به‌روزرسانی خودکار:

  • شما به‌روزرسانی‌های خودکار یا اعلان‌ها را زمانی که نسخه جدیدی در دسترس است، دریافت نخواهید کرد. این ممکن است به خطر استفاده از کتابخانه‌های قدیمی منجر شود مگر اینکه به‌طور مرتب برای به‌روزرسانی‌ها بررسی کنید.

محیط غیر ویندوز

کار کردن با DLLهای .NET Core در محیط غیر ویندوز

از آنجا که Documentize برای .NET از .NET Standard 2.0 (.NET Core 2.0) پشتیبانی می‌کند، می‌توان از آن در برنامه‌های Core که در سیستم‌عامل‌های شبیه به لینوکس اجرا می‌شوند، استفاده کرد. ما به طور مداوم در حال بهبود پشتیبانی از .NET Core در API خود هستیم. با این حال، برخی از عملیات وجود دارند که توصیه می‌کنیم مشتریان ما انجام دهند تا نتایج بهتری را در هنگام استفاده از ویژگی‌های Documentize برای .NET به دست آورند. لطفاً نصب کنید:

• بسته libgdiplus
• بسته با فونت‌های سازگار با مایکروسافت: 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("<مسیر کاربر به فونت‌های ms>"));

v24.12

افزوده شده پلاگین جدید: مبدل PDF به PNG

• کلاس PngConverter: نمایانگر پلاگین Documentize.PngConverter است. برای تبدیل مدارک PDF به فرمت PNG استفاده می‌شود.
• کلاس PdfToPngOptions: نمایانگر گزینه‌های مبدل PDF به PNG برای پلاگین Documentize.PngConverter است.

نمونه استفاده:

// create PngConverter
var plugin = new PngConverter();
// create PdfToPngOptions object to set instructions
var opt = new PdfToPngOptions();
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// set output file path
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// perform the process
plugin.Process(opt);

افزوده شده پلاگین جدید: مبدل PDF به TIFF

• کلاس TiffConverter: نمایانگر پلاگین Documentize.TiffConverter است. برای تبدیل مدارک PDF به فرمت TIFF استفاده می‌شود.
• کلاس PdfToTiffOptions: نمایانگر گزینه‌های مبدل PDF به TIFF برای پلاگین Documentize.TiffConverter است.

نمونه استفاده:

// create TiffConverter
var plugin = new TiffConverter();
// create PdfToTiffOptions object to set instructions
var opt = new PdfToTiffOptions();
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// set output file path
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// perform the process
plugin.Process(opt);

افزوده شده پلاگین جدید: تولیدکننده جدول PDF

• کلاس TableGenerator: نمایانگر پلاگین Documentize.TableGenerator است. برای افزودن یک جدول به یک سند PDF استفاده می‌شود.
• کلاس TableBuilder: کلاس نمایانگر سازنده جدول در صفحه PDF است.
• کلاس TableRowBuilder: کلاس نمایانگر سازنده ردیف جدول است.
• کلاس TableCellBuilder: کلاس نمایانگر سازنده سلول جدول است.

نمونه استفاده:

// create TableGenerator
var plugin = new TableGenerator();
// create TableOptions object to set instructions
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");
// add input file path
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// set output file path
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// perform the process
plugin.Process(opt);

تغییر نام کلاس PdfDoc به DocConverter

• کلاس DocConverter: نمایانگر پلاگین Documentize.DocConverter است. برای تبدیل مدارک PDF به فرمت DOC/DOCX استفاده می‌شود.

نمونه استفاده:

// create DocConverter
var plugin = new DocConverter();
// create PdfToDocOptions object to set instructions
var opt = new PdfToDocOptions();
// add input file path
opt.AddInput(new FileDataSource(inputPath));
// set output file path
opt.AddOutput(new FileDataSource(outputPath));
// perform the process
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

منتشر شده