Встановлення 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-інсталятора:

   • Натисніть v24.12 MSI, щоб завантажити MSI-інсталятор для останньої версії Documentize.

2. Запустіть інсталятор:

   • Двічі клацніть на завантаженому MSI-файлі, щоб запустити майстер встановлення.

3. Слідуйте інструкціям майстра встановлення:

   • Дотримуйтесь інструкцій на екрані, наданих інсталятором. Вам може знадобитися погодитися з ліцензійною угодою та вибрати параметри встановлення.

4. Завершіть встановлення:

   • Як тільки встановлення буде завершено, DLL-системи Documentize будуть встановлені у всесвітній кеш збірок (GAC) вашої системи або в іншому вказаному місці.

5. Перевірте встановлення:

   • Переконайтеся, що DLL-системи встановлені правильно, перевіривши їх наявність у вказаній директорії встановлення або в GAC.

Переваги використання MSI-інсталятора

• Простота використання:

  • MSI-інсталятора надає простий і керований процес встановлення. Він обробляє всі необхідні конфігурації та розміщує DLL-системи в центральному місці, що дозволяє легко використовувати Documentize в кількох проектах.

• Встановлення на системному рівні:

  • Метод MSI встановлює Documentize у всесвітній кеш збірок (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).
   • Перейдіть до Проект > Додати посилання > Перегляд і перейдіть до каталогу, в якому ви витягли DLL.
   • Виберіть відповідні файли DLL і додайте їх як посилання на ваш проект.

4. Ручні оновлення:

   • Якщо буде випущена нова версія Documentize, вам потрібно буде вручну завантажити оновлений ZIP-архів і замінити старі файли DLL у вашому проекті на нові.

Переваги використання ZIP-архіву

• Повний контроль:

  • У вас є повний контроль над тим, де і як зберігаються та посилаються DLL у вашому проекті. Це може бути корисно, якщо ви віддаєте перевагу індивідуальному налаштуванню або потрібно вручну управляти залежностями.

• Відсутність залежності від менеджерів пакетів:

  • На відміну від NuGet, ви не залежите від менеджера пакетів для управління встановленнями. Це може бути вигідно в середовищах, де менеджери пакетів недоступні або не є пріоритетними.

• Портативність:

  • ZIP-архів може бути легко поділений та переміщений між різними системами, що робить його ідеальним для проектів, які потрібно робити портативними або розподіляти без використання зовнішніх інструментів.

Недоліки використання ZIP-архіву

• Ручне управління:

  • На відміну від NuGet, де оновлення та управління залежностями автоматизовані, з ZIP-архівом вам потрібно вручну керувати оновленнями та забезпечити правильне посилання на всі необхідні DLL.

• Ризик конфліктів версій:

  • Якщо ви управляєте кількома проектами або працюєте в команді, існує ризик конфліктів версій, якщо різні проекти використовують різні версії DLL. Це вимагає ретельного відстеження версій в різних проектах.

• Відсутність автоматичних оновлень:

  • Ви не отримаєте автоматичних оновлень або сповіщень, коли доступна нова версія. Це може призвести до ризику використання застарілих бібліотек, якщо ви не регулярно перевіряєте наявність оновлень.

Некомерційне середовище

Робота з .NET Core DLL у некомерційному середовищі

Оскільки Documentize для .NET підтримує .NET Standard 2.0 (.NET Core 2.0), його можна використовувати в Core-додатках, що працюють у подібних до Linux операційних системах. Ми постійно працюємо над покращенням підтримки .NET Core у нашому API. Проте є деякі операції, які ми рекомендуємо нашим клієнтам виконувати для досягнення кращих результатів при використанні можливостей Documentize для .NET. Будь ласка, встановіть:

• пакет libgdiplus
• Пакет з шрифтами, сумісними з Microsoft: ttf-mscorefonts-installer (наприклад, sudo apt-get install ttf-mscorefonts-installer). Ці шрифти повинні бути розміщені в директорії /usr/share/fonts/truetype/msttcorefonts, оскільки Documentize для .NET сканує цю папку в подібних до Linux операційних системах. Якщо операційна система має іншу стандартну папку/каталог для шрифтів, вам слід використати наступний рядок коду перед виконанням будь-якої операції за допомогою Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<шлях користувача до шрифтів ms>"));

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

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

Випущено