Установка 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. Хотя его можно использовать в других средах, интеграция наиболее robust в Visual Studio.

• Потенциальные конфликты версий:

  • В крупных проектах с множеством зависимостей управление версиями и разрешение конфликтов могут стать сложными. NuGet предоставляет инструменты для управления этим, но это требует внимательного подхода.

• Зависимость от сети:

  • Установка и обновление пакетов требуют подключения к интернету. Если вы работаете в среде с ограниченным или отсутствующим интернет-доступом, вам, возможно, придется использовать оффлайн-методы или заранее загрузить пакеты.

• Сложность для крупных проектов:

  • Для очень крупных проектов с расширенными деревьями зависимостей управление пакетами через NuGet может стать обременительным. В таких случаях могут потребоваться дополнительные инструменты или стратегии для эффективного управления зависимостями.

Установка Documentize с помощью MSI

Как установить с помощью MSI-установщика

1. Скачайте MSI-установщик:

   • Нажмите на v25.6 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-архив:

   • Нажмите на v25.6 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), его можно использовать в ядре приложений, работающих в операционных системах, подобных 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: Класс представляет построитель строки таблицы.
• Класс TableCellBuilder: Класс представляет построитель ячейки таблицы.

Пример использования:

// создать TableGenerator
var plugin = new TableGenerator();
// создать объект TableOptions для настройки параметров
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Имя")
            .AddCell().AddParagraph("Возраст")
        .AddRow()
            .AddCell().AddParagraph("Боб")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Сэм")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Сэнди")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Том")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Джим")
            .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

Выпущено