从 DOCX 生成 HTML 并渲染跟踪更改 (Java)

如果您需要 从 DOCX 生成 HTML 并同时显示每个跟踪修订，则您来对地方了。在本教程中，我们将演示如何渲染 Word 跟踪更改、将 Word 文档转换为干净、可导航的 HTML，并为您提供构建文档审查门户、法律案件管理系统或任何必须 查看 Word 文档修订 的应用程序的工具。您将看到完整的端到端流程——从 Maven 设置到最终的 HTML 文件——因此您可以在几分钟内将其放入您的 Java 项目中。

使用 GroupDocs.Viewer for Java 渲染 Word 文档中的跟踪更改

快速答案

  • “render word tracked changes” 是什么意思？ 它将 Word 文件的修订标记转换为可视的 HTML 表示。
  • 哪个库处理此功能？ GroupDocs.Viewer for Java。
  • 我需要许可证吗？ 免费试用可用于评估；完整许可证可消除所有限制。
  • 需要哪个 Java 版本？ Java 8 或更高版本。
  • 我可以禁用跟踪更改的渲染吗？ 可以——在视图选项中设置 setRenderTrackedChanges(false)。

什么是 “render word tracked changes”？

渲染 word 跟踪更改是指获取存储在 .docx 文件中的修订数据（插入、删除、评论等），并生成一种可视化格式——通常为 HTML——在该格式中这些更改会被视觉突出显示。这使得最终用户无需打开 Microsoft Word 即可准确看到哪些内容被修改。

为什么使用 GroupDocs.Viewer 来查看 Word 文档修订？

GroupDocs.Viewer for Java 抽象了底层的 OpenXML 处理，并提供一个单一的 API 调用即可生成 HTML、PDF 或图像。它还开箱即支持 view word document revisions，保留样式、嵌入资源和更改跟踪。

前提条件

  • GroupDocs.Viewer for Java 库版本 25.2 或更高。
  • Maven 用于依赖管理。
  • 基本的 Java 开发环境（IDE，JDK 8+）。

设置 GroupDocs.Viewer for Java

Maven 配置

将 GroupDocs 仓库和依赖添加到您的 pom.xml 中：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

获取许可证

先使用免费试用或请求临时评估许可证。当您准备好投入生产时，购买完整许可证以解锁所有功能。

基本初始化

在您的 Java 代码中导入所需的类，并准备输入和输出的文件路径。

如何从 DOCX 生成 HTML 并渲染跟踪更改

以下是逐步演练，展示您需要的完整代码。代码块保持原样未更改。

步骤 1：定义输出目录路径

创建一个文件夹，用于保存渲染后的 HTML 页面。

Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RenderTrackedChanges");

步骤 2：指定每页保存的格式

为每个生成的 HTML 文件设置命名模式。

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

步骤 3：配置视图选项

启用嵌入资源并打开跟踪更改的渲染。

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true);

步骤 4：创建 Viewer 实例并渲染

加载包含跟踪更改的 Word 文档并生成 HTML 输出。

try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SAMPLE_DOCX_WITH_TRACKED_CHANGES"))) {
    viewer.view(viewOptions);
}

如何在 Word 文档中渲染更改 – 常见陷阱

  • 文件路径不正确 – 请再次确认 YOUR_OUTPUT_DIRECTORY 和 YOUR_DOCUMENT_DIRECTORY 指向现有文件夹。
  • 不受支持的文档格式 – 确保文件是 GroupDocs.Viewer 支持的 .docx 或 .doc。
  • 缺少许可证 – 没有有效许可证时，库可能会限制渲染功能。

实际应用

  1. 文档审查系统 – 向审查者准确显示添加或删除的内容。
  2. 法律案件管理 – 突出合同或诉状中的修订。
  3. 学术协作 – 可视化多位作者的贡献。

性能考虑因素

  • 并发处理的文档数量应受限，以保持内存使用低。
  • 使用高效的目录结构以减少 I/O 开销。
  • 保持库的最新版本；新版本包含性能优化。

结论

您现在拥有一个完整的、可用于生产的方案，可使用 GroupDocs.Viewer for Java 从 DOCX 生成 HTML 并 渲染 word 跟踪更改。将这些步骤集成到您的应用程序中，您将为用户提供强大且交互式的文档审查体验。

常见问题

Q: 所需的最低 Java 版本是什么？
A: 通常建议使用 Java 8 或更高版本，以兼容像 GroupDocs.Viewer 这样的现代库。

Q: 我可以在不渲染跟踪更改的情况下渲染文档吗？
A: 可以，只需在配置选项中将 setRenderTrackedChanges(true) 设为关闭即可。

Q: 如何高效处理大文档？
A: 可以考虑将大文件拆分为更小的部分，或使用分页技术来有效管理资源使用。

Q: GroupDocs.Viewer 的授权选项有哪些？
A: 您可以先使用免费试用，选择临时评估许可证，或根据项目需求购买完整许可证。

Q: 如果遇到问题，是否有支持可用？
A: 是的，您可以通过 GroupDocs 论坛和官方文档资源获取支持。

最后更新： 2026-03-29
测试环境： GroupDocs.Viewer for Java 25.2
作者： GroupDocs

资源