從 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

資源