通过 NuGet 安装 Documentize

如何通过 NuGet 包管理器控制台安装

1. 打开项目:

   • 启动 Visual Studio 并打开你的 .NET 应用程序。

2. 访问包管理器控制台:

   • 导航至 工具 > NuGet 包管理器 > 包管理器控制台。

3. 安装包:

   • 要安装最新的完整版本，输入命令 Install-Package Documentize。
   • 要安装最新的版本，包括热修复，使用 Install-Package Documentize -prerelease。
   • 按 Enter 执行命令。

如何通过 NuGet 包管理器控制台更新包

如果你已经通过 NuGet 安装了 Documentize，并希望更新到最新版本：

1. 打开项目:

   • 启动 Visual Studio 并打开你的 .NET 应用程序。

2. 访问包管理器控制台:

   • 导航至 工具 > NuGet 包管理器 > 包管理器控制台。

3. 更新包:

   • 要更新到最新的完整版本，输入 Update-Package Documentize。
   • 要更新到最新版本，包括热修复，使用 Update-Package Documentize -prerelease。
   • 按 Enter 执行命令。

如何通过 NuGet 包管理器 GUI 安装

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 管理包的开销可能变得烦琐。在这种情况下，可能需要额外的工具或策略来有效管理依赖项。

通过 MSI 安装 Documentize

如何通过 MSI 安装程序安装

1. 下载 MSI 安装程序:

   • 点击 v25.7 MSI 下载最新版本 Documentize 的 MSI 安装程序。

2. 运行安装程序:

   • 双击下载的 MSI 文件以启动安装向导。

3. 按照安装向导进行操作:

   • 按照安装程序提供的屏幕说明进行操作。您可能需要同意许可协议并选择安装选项。

4. 完成安装:

   • 安装完成后，Documentize 的 DLL 将安装到您的系统的全局程序集缓存 (GAC) 或其他指定位置。

5. 验证安装:

   • 通过验证指定安装目录或 GAC 中是否存在 DLL 来检查其是否正确安装。

使用 MSI 安装程序的优点

• 易于使用:

  • MSI 安装程序提供简单且指导性的安装过程。它处理所有必要的配置，并将 DLL 放置在中心位置，使您能够在多个项目中轻松使用 Documentize。

• 系统范围安装:

  • MSI 方法将 Documentize 安装到系统的全局程序集缓存 (GAC) 或其他中心位置。这允许系统上的任何应用程序访问 DLL，而无需在每个项目中单独引用它们。

• 自动更新:

  • 如果 Documentize 提供了更新的安装程序，您可以通过运行新的 MSI 文件轻松更新安装，通常更新过程会顺利进行。

• 一致性:

  • 使用 MSI 安装程序可确保所有所需文件在不同环境中正确且一致地安装，从而减少缺失或放错 DLL 的风险。

使用 MSI 安装程序的缺点

• 灵活性有限:

  • MSI 安装程序将 Documentize 安装到系统范围位置，这可能不适合所有开发环境。它可能缺乏适应项目特定配置或版本的灵活性。

• 潜在开销:

  • 将 DLL 安装到 GAC 可能会引入开销和复杂性，特别是在需要同时使用多个版本的 Documentize 的情况下。

• 手动卸载:

  • 如果需要卸载 Documentize，必须使用 MSI 提供的卸载程序，如果未正确管理，可能会留下残余文件或配置。

• 版本冲突:

  • 系统范围的安装如果不同项目需要不同版本的 Documentize，可能会导致版本冲突。管理这些冲突可能需要额外的配置或清理。

通过 ZIP 安装 Documentize

如何通过 ZIP 存档安装

1. 下载 ZIP 存档：

   • 点击 v25.7 ZIP 下载最新版本的 Documentize 以存档格式。

2. 提取内容：

   • 下载后，将 ZIP 文件的内容提取到你选择的目录。你可以选择将这些文件保留在共享目录或项目结构内。

3. 将引用添加到项目中：

   • 在你的 IDE 中打开项目（例如 Visual Studio）。
   • 转到 项目 > 添加引用 > 浏览，导航到你提取 DLL 的目录。
   • 选择相关的 DLL 文件并将其添加为项目的引用。

4. 手动更新：

   • 如果发布了新版本的 Documentize，你需要手动下载更新的 ZIP 存档，并用新的 DLL 文件替换项目中的旧文件。

使用 ZIP 存档的优点

• 完全控制：

  • 你可以完全控制 DLL 的存储位置和引用方式。如果你更喜欢自定义设置或需要手动管理依赖关系，这可能是有益的。

• 不依赖包管理器：

  • 与 NuGet 不同，你不依赖包管理器来处理安装。在包管理器不可用或不受欢迎的环境中，这可能是有利的。

• 可移植性：

  • ZIP 存档可以轻松分享并在不同系统之间移动，非常适合需要可移植性或分发而不依赖于外部工具的项目。

使用 ZIP 存档的缺点

• 手动管理：

  • 与 NuGet 不同，更新和依赖管理是自动化的，对于 ZIP 存档，你必须手动管理更新并确保所有所需的 DLL 都被正确引用。

• 版本冲突的风险：

  • 如果你正在管理多个项目或在团队中工作，如果不同的项目使用不同版本的 DLL，就会有版本冲突的风险。这需要仔细跟踪项目间的版本。

• 没有自动更新：

  • 当有新版本可用时，你不会收到自动更新或通知。这可能导致使用过时库的风险，除非你定期检查更新。

非Windows环境

在非Windows环境中使用.NET Core DLL

由于Documentize for .NET支持.NET Standard 2.0 (.NET Core 2.0)，因此可以在Linux类操作系统中运行的Core应用程序中使用。我们一直在努力改善我们API中的.NET Core支持。然而，我们建议客户在使用Documentize for .NET的功能时执行一些操作以获得更好的效果。请安装：

• libgdiplus包
• 与Microsoft兼容的字体包： ttf-mscorefonts-installer（例如，sudo apt-get install ttf-mscorefonts-installer）。这些字体应该放置在/usr/share/fonts/truetype/msttcorefonts目录下，因为Documentize for .NET在Linux类操作系统中扫描此文件夹。如果操作系统有其他默认的字体文件夹/目录，则在使用Documentize执行任何操作之前，您应该使用以下代码行：

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<用户的ms字体路径>"));

v24.12

添加新插件：PDF转PNG转换器

• Class PngConverter: 代表 Documentize.PngConverter 插件。用于将PDF文档转换为PNG格式。
• Class PdfToPngOptions: 代表 Documentize.PngConverter 插件的PDF到PNG转换选项。

示例用法：

// 创建 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转换器

• Class TiffConverter: 代表 Documentize.TiffConverter 插件。用于将PDF文档转换为TIFF格式。
• Class PdfToTiffOptions: 代表 Documentize.TiffConverter 插件的PDF到TIFF转换选项。

示例用法：

// 创建 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表格生成器

• Class TableGenerator: 代表 Documentize.TableGenerator 插件。用于向PDF文档添加表格。
• Class TableBuilder: 该类代表PDF页面中表格的构建器。
• Class TableRowBuilder: 该类代表表格行的构建器。
• Class 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

• Class 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

发布