如何在 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
如何在渲染輸出中 add custom font HTML
如何為獲得最佳效能 configure font settings Java

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

快速答覆

主要目的為何？ 使用 GroupDocs.Viewer Java 以自訂字型渲染文件。
需要哪個版本？ GroupDocs.Viewer 25.2（或更新版本）。
是否需要授權？ 提供免費試用；正式環境需購買授權。
能否嵌入 custom fonts HTML？ 可以，只需將檢視器指向包含字型的資料夾。
Maven 是唯一的加入函式庫方式嗎？ 建議使用 Maven，但亦可使用 Gradle 或手動加入 JAR。

什麼是 “add custom font HTML”？

加入 custom font HTML 表示指示渲染引擎在產生 HTML 輸出時使用您提供的字型，而非預設系統字型。這可確保文件的視覺風格符合企業品牌或可及性指引。

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

設定 font settings Java 可讓您完整掌控搜尋哪些字型檔案、快取方式以及備援字型的應用。此舉可減少渲染錯誤、提升效能，並確保在各瀏覽器間呈現一致的外觀。

前置條件

Java Development Kit (JDK)： 8 或更新版本
IDE： IntelliJ IDEA、Eclipse 或任何相容 Java 的編輯器
Maven： 用於相依性管理
自訂字型檔案： 放置於專屬資料夾的 .ttf 或 .otf 檔案

設定 GroupDocs.Viewer for Java

安裝資訊

Add the GroupDocs repository and dependency to your 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 提供免費試用以探索其功能，並可取得臨時授權或購買完整授權。測試時，請從他們的發行頁面下載最新版本。

基本初始化與設定

After adding GroupDocs.Viewer as a dependency, initialize it in your Java project:

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 開啟文件。

實作指南

如何在 GroupDocs.Viewer Java 中 add custom font HTML

本節將逐步說明在渲染文件時 add custom font HTML 所需的精確步驟。

Importing Necessary Packages

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;

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

設定自訂字型

Define the Path to Your Font Folder

String fontPath = "/path/to/your/custom/fonts";

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

Create a FontSource Object

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

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

Configure Font Settings Java

FontSettings.setFontSources(fontSource);

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

Define Output Directory and View Options

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）。

實務應用

Custom font rendering can be applied in various scenarios:

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

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

效能考量

When processing large batches:

限制自訂字型數量，以降低記憶體使用。
在大量使用相同設定渲染文件時，快取 HtmlViewOptions 物件。
監控 JVM 堆積，必要時調整 -Xmx 以避免記憶體不足錯誤。

結論

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

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

常見問題

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

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

Q: 生產環境可使用哪些授權選項？
A: 您可先使用免費試用，之後透過購買頁面升級為臨時或永久授權。

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

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

資源

For further exploration:

文件說明： GroupDocs Viewer Java Docs
API 參考： GroupDocs API
下載： Latest Releases
購買與試用選項： GroupDocs Purchase Page & Free Trials
支援： 如需進一步協助，請造訪 [GroupDocs Forum](

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