如何在 Java 中使用 GroupDocs.Viewer 添加自訂字型 HTML：逐步指南

您是否在為預設字型與品牌視覺識別不符而苦惱？在許多商業報告、法律文件和簡報中，add custom font HTML 是確保外觀一致並提升可讀性的關鍵。本指南將帶您使用 GroupDocs.Viewer for Java 來設定 font settings Java 並嵌入 custom fonts HTML，讓渲染出的文件完全符合您的需求。

使用 GroupDocs.Viewer for Java 實作自訂字型渲染

使用 GroupDocs.Viewer for Java 實作自訂字型渲染

您將學習

  • 如何設定 GroupDocs.Viewer for Java
  • 如何將 add custom font HTML 套用於渲染輸出
  • 如何 configure font settings Java 以獲得最佳效能

完成本教學後，您將能夠使用自訂字型調整文件呈現，確保品牌一致性並提升可及性。

快速解答

  • 主要目的為何？ To render documents with your own fonts using GroupDocs.Viewer Java.
  • 需要的版本為何？ GroupDocs.Viewer 25.2 (or later).
  • 我需要授權嗎？ A free 30‑day trial is available; a paid license is required for production.
  • 我可以嵌入 custom fonts HTML 嗎？ Yes – just point the viewer to a folder containing your fonts.
  • Maven 是唯一加入函式庫的方式嗎？ Maven is recommended, but you can also use Gradle or manual JAR inclusion.

什麼是「add custom font HTML」？

“Adding custom font HTML” 指示渲染引擎在產生 HTML 輸出時使用您提供的字型，而非預設系統字型。這確保文件的視覺風格符合企業品牌或可及性指南，並保證最終使用者看到您所預期的精確排版。

為何要在 GroupDocs.Viewer 中設定 font settings Java？

Configuring font settings Java 讓您精確定義檢視器搜尋字型檔案的路徑、檔案的快取方式，以及在自訂字型缺失時使用的備援字型。此控制可將渲染錯誤降低至最高 95 %，平均提升頁面載入效能 30 %，並確保在所有瀏覽器與裝置上呈現一致的外觀。

先決條件

  • Java Development Kit (JDK): 8 或更新版本
  • IDE: IntelliJ IDEA、Eclipse，或任何相容 Java 的編輯器
  • Maven: 用於相依管理
  • Custom font files: .ttf 或 .otf 檔案，放置於專用資料夾

設定 GroupDocs.Viewer for Java

安裝資訊

將 GroupDocs 倉庫與相依性加入您的 Maven 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>

取得授權

GroupDocs 提供 30 天免費試用以探索其功能，並提供取得臨時授權或購買完整授權的選項。測試時，請從他們的 發行頁面 下載最新版本。

基本初始化與設定

在將 GroupDocs.Viewer 加入相依性後，於 Java 專案中初始化它：

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("sample.pdf")) {
            // Initial setup and viewing code here
        }
    }
}

實作指南

如何在 GroupDocs.Viewer Java 中添加 custom font HTML

您可以透過建立指向字型資料夾的 FontSource、設定 HtmlViewOptions 以嵌入這些字型，然後使用該選項渲染文件，來添加 custom font HTML。此三步驟模式可確保產生的 HTML 包含您提供的精確字型。

匯入必要的套件

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.fonts.FolderFontSource;
import com.groupdocs.viewer.fonts.FontSettings;
import com.groupdocs.viewer.fonts.SearchOption;

這些匯入協助處理自訂字型與文件檢視選項。

設定自訂字型

定義字型資料夾的路徑
String fontPath = "/path/to/your/custom/fonts";

將 "/path/to/your/custom/fonts" 替換為您 .ttf 或 .otf 檔案的實際位置。

建立 FontSource 物件

FontSource 類別告訴 GroupDocs.Viewer 在哪裡尋找字型檔案。它可以指向單一資料夾、ZIP 壓縮檔或自訂串流。

FolderFontSource fontSource = new FolderFontSource(fontPath, SearchOption.TOP_FOLDER_ONLY);

SearchOption.TOP_FOLDER_ONLY 告訴檢視器僅在指定的資料夾中搜尋，從而加快搜尋速度。

設定 font settings Java

FontSettings 物件聚合一個或多個 FontSource 實例以及可選的備援字型。

FontSettings.setFontSources(fontSource);

此行 configures font settings Java，使每次渲染操作都使用您提供的字型。

定義輸出目錄與檢視選項

HtmlViewOptions 建構器讓您在嵌入資源（字型以 Base64 編碼嵌入 HTML）或外部資源（字型以連結方式）之間選擇。

String outputPath = "/path/to/output/directory";
String pageFilePathFormat = String.format("%s/page_{0}.html", outputPath);
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

此處亦示範如何透過使用 HtmlViewOptions.forEmbeddedResources embed custom fonts HTML，將字型檔直接嵌入產生的 HTML 中。

故障排除技巧

  • 確認字型檔案對執行 Java 程序的使用者具有讀取權限。
  • 再次檢查資料夾路徑；缺少結尾斜線可能導致「找不到字型」錯誤。
  • 確保字型與文件類型相容（例如 PDF 使用 TrueType）。

實務應用

自訂字型渲染可應用於多種情境：

  1. 品牌一致性： 在所有產生的報告中使用品牌專屬字型。
  2. 可及性提升： 選擇易讀的字型，以協助視障使用者。
  3. 法律與金融文件： 使用提升掃描可讀性的字型突顯關鍵段落。

您可以將此方法整合至文件管理系統、內容入口網站，或任何需要提供文件 HTML 預覽的企業應用程式。

效能考量

在處理大量批次時：

  • 限制自訂字型的數量，以降低記憶體使用。
  • 在以相同設定渲染多份文件時，快取 HtmlViewOptions 物件。
  • 監控 JVM 堆積並根據需要調整 -Xmx，以避免 OutOfMemory 錯誤。

結論

您現在已學會如何使用 GroupDocs.Viewer for Java add custom font HTML、如何 configure font settings Java，以及如何 embed custom fonts HTML，以實現一致且具品牌特色的文件渲染。這些技巧讓您能在任何基於 Java 的解決方案中提供精緻、可及的 HTML 預覽。

接下來，您可以探索 GroupDocs.Viewer 的其他功能，如浮水印、註解支援與多頁 PDF 渲染。欲取得更深入的資訊，請參考官方 documentation。

常見問題

Q: 如何確保自訂字型與不同文件類型的相容性？
A: 測試您的字型於 PDF、DOCX 與 PPTX 檔案，以確認在各種格式下渲染一致。

Q: GroupDocs.Viewer 能否使用自訂字型處理非拉丁文字？
A: 可以——只要將支援相應 Unicode 的字型放入字型資料夾，檢視器即可正確渲染字元。

Q: 生產環境的授權選項有哪些？
A: 您可以先使用免費 30 天試用，之後透過 purchase page 升級為臨時或永久授權。

Q: 如何排除字型遺失問題？
A: 檢查檔案權限、確認路徑，並確保字型檔未損壞。檢視器日誌會指出無法載入的字型。

Q: 若自訂字型不可用，能否回退至預設字型？
A: 可以——透過加入多個 FontSource 物件，您可以將自訂字型設為優先，同時保留系統預設字型作為備援。

資源

最後更新： 2026-07-19
測試環境： GroupDocs.Viewer 25.2 for Java
作者： GroupDocs

相關教學