|
1 | 1 | --- |
2 | | -title: 在 Aspose.HTML for Java 中配置字體 |
3 | | -linktitle: 在 Aspose.HTML for Java 中配置字體 |
4 | | -second_title: 使用 Aspose.HTML 進行 Java HTML 處理 |
5 | | -description: 透過這份詳細的逐步指南,了解如何在 Aspose.HTML for Java 中設定字體。使用自訂字體和樣式增強 HTML 到 PDF 的轉換。 |
| 2 | +date: 2025-12-03 |
| 3 | +description: 學習如何在 Java 中使用 Aspose.HTML 配置 HTML 轉 PDF 的字型。使用自訂字型、臨時 Aspose 授權以及進階轉換設定,從 |
| 4 | + HTML 產生 PDF。 |
| 5 | +language: zh-hant |
| 6 | +linktitle: Configure Fonts in Aspose.HTML |
| 7 | +second_title: Java HTML Processing with Aspose.HTML |
| 8 | +title: 在 Java 中使用 Aspose.HTML 配置 HTML 轉 PDF 的字型 |
| 9 | +url: /java/configuring-environment/configure-fonts/ |
6 | 10 | weight: 11 |
7 | | -url: /zh-hant/java/configuring-environment/configure-fonts/ |
8 | 11 | --- |
9 | 12 |
|
10 | 13 | {{< blocks/products/pf/main-wrap-class >}} |
11 | 14 | {{< blocks/products/pf/main-container >}} |
12 | 15 | {{< blocks/products/pf/tutorial-page-section >}} |
13 | 16 |
|
14 | | -# 在 Aspose.HTML for Java 中配置字體 |
| 17 | +# 設定字型於 HTML 轉 PDF Java 使用 Aspose.HTML |
15 | 18 |
|
16 | | -## 介紹 |
17 | | -在 Java 中處理 HTML 文件時,正確配置字體對於建立具有視覺吸引力和可讀性的內容至關重要。無論您是產生報告、建立網頁還是轉換文檔,確保正確配置字體都會產生重大影響。本教學將引導您完成在 Aspose.HTML for Java 中配置字體的過程,從設定環境到使用自訂字體將 HTML 轉換為 PDF。那麼,讓我們深入了解一下吧! |
| 19 | +## 簡介 |
| 20 | +在 Java 中處理 HTML 文件時,正確設定字型對於產生視覺上吸引且易讀的 **html to pdf java** 轉換至關重要。無論是產生報表、建置網頁,或是文件轉換,適當的字型配置都會大幅提升最終 PDF 的品質。本指南將一步步說明整個流程——從建置開發環境到使用自訂字型將 HTML 轉為 PDF——讓您只需幾行程式碼即可產出專業外觀的 PDF。讓我們立即開始吧! |
18 | 21 |
|
19 | | -## 先決條件 |
20 | | -在我們開始之前,您需要滿足一些先決條件: |
21 | | -1. Java 開發工具包 (JDK):確保您的系統上安裝了 JDK 1.8 或更高版本。 |
22 | | -2. Aspose.HTML for Java Library:您可以從以下位置下載該程式庫:[阿斯普斯網站](https://releases.aspose.com/html/java/). |
23 | | -3. 整合開發環境 (IDE):使用 IntelliJ IDEA 或 Eclipse 等 IDE 來管理您的專案。 |
24 | | -4. Java 程式設計基礎:熟悉 Java 將幫助您更有效地遵循教學。 |
25 | | -5. Aspose.HTML 許可證:雖然您可以在沒有許可證的情況下使用 Aspose.HTML,但臨時許可證或完整許可證將消除任何評估限制。得到你的[臨時許可證在這裡](https://purchase.aspose.com/temporary-license/). |
| 22 | +## 快速解答 |
| 23 | +- **此教學的主要目的為何?** 使用 Aspose.HTML 在 Java 中設定 HTML‑to‑PDF 的字型。 |
| 24 | +- **哪個函式庫負責轉換?** Aspose.HTML for Java(`Converter` 類別)。 |
| 25 | +- **我需要授權嗎?** 臨時 Aspose 授權可移除評估限制;正式環境需購買完整授權。 |
| 26 | +- **自訂字型應放置於何處?** 放在 `FontsLookupFolder` 所指向的資料夾,例如專案旁的 `fonts` 目錄。 |
| 27 | +- **我可以自訂 PDF 輸出嗎?** 可以——使用 `PdfSaveOptions` 調整頁面大小、邊距等。 |
26 | 28 |
|
27 | | -## 導入包 |
28 | | -首先,您需要將必要的套件匯入到您的 Java 專案中。這些套件提供了配置字體、處理 HTML 文件以及將其轉換為其他格式所需的類別和方法。 |
| 29 | +## 前置條件 |
| 30 | +1. **Java Development Kit (JDK) 1.8+** – 程式碼可在任何現代 JDK 上執行。 |
| 31 | +2. **Aspose.HTML for Java** – 從 [Aspose 官方網站](https://releases.aspose.com/html/java/) 下載最新的 JAR。 |
| 32 | +3. **IDE** – IntelliJ IDEA、Eclipse 或任何相容 Java 的編輯器。 |
| 33 | +4. **基本的 Java 知識** – 需要熟悉類別、方法與檔案 I/O。 |
| 34 | +5. **Aspose.HTML 授權** – 使用 [臨時授權](https://purchase.aspose.com/temporary-license/) 可解除評估限制。 |
| 35 | + |
| 36 | +## 匯入套件 |
| 37 | +首先,匯入您將需要的核心 Java 與 Aspose.HTML 類別。 |
29 | 38 | ```java |
30 | 39 | import java.io.IOException; |
31 | 40 | ``` |
32 | | -這些導入引入了 Aspose.HTML for Java 的核心功能,可讓您以程式設計方式與 HTML 內容進行互動。 |
33 | | -## 第 1 步:建立 HTML 內容 |
34 | | -首先,我們需要建立一些基本的 HTML 內容,稍後我們將對其進行樣式設定並將其轉換為 PDF。該內容將保存在 HTML 文件中。 |
35 | | -### 1.1 編寫 HTML 程式碼 |
36 | | -我們首先定義一些帶有標題和段落的 HTML 程式碼。此程式碼將保存在名為的檔案中`user-agent-fontsetting.html`. |
| 41 | +這些匯入讓您能存取檔案處理功能與 Aspose.HTML API。 |
| 42 | + |
| 43 | +## 什麼是 **html to pdf java** 以及為何字型設定很重要? |
| 44 | +**html to pdf java** 的流程會將 HTML 文件渲染成 PDF 頁面。字型是渲染的關鍵要素,因為它會影響版面配置、行距與視覺忠實度。透過將 Aspose.HTML 指向自訂字型資料夾,您可以確保 PDF 使用與網頁相同的字體,避免備援字型,維持品牌一致性。 |
| 45 | + |
| 46 | +## 步驟指南 |
| 47 | + |
| 48 | +### 步驟 1:建立 HTML 內容 |
| 49 | +我們先產生一個簡單的 HTML 檔,稍後再將其轉換為 PDF。 |
| 50 | + |
| 51 | +#### 1.1 撰寫 HTML 程式碼 |
37 | 52 | ```java |
38 | 53 | String code = "<h1>FontsSettings property</h1>\r\n" + |
39 | 54 | "<p>The FontsSettings property is used for configuration of fonts handling.</p>\r\n"; |
40 | 55 | ``` |
41 | | -該字串包含我們想要設定樣式的 HTML 內容。請注意,它包含一個標頭 (`<h1>`)和一段(`<p>`)。 |
42 | | -### 1.2 將 HTML 內容儲存到文件 |
43 | | -接下來,您將使用以下命令將此 HTML 內容儲存到檔案中`FileWriter`. |
| 56 | +此程式碼片段定義了一個標題與一段文字。若需測試其他樣式,可自行擴充 HTML。 |
| 57 | + |
| 58 | +#### 1.2 儲存 HTML 為檔案 |
44 | 59 | ```java |
45 | 60 | try (java.io.FileWriter fileWriter = new java.io.FileWriter("user-agent-fontsetting.html")) { |
46 | 61 | fileWriter.write(code); |
47 | 62 | } |
48 | 63 | ``` |
49 | | -此程式碼片段將 HTML 字串寫入名為的文件`user-agent-fontsetting.html`在你的專案目錄中。 |
50 | | -## 步驟2:設定Aspose.HTML環境 |
51 | | -準備好 HTML 檔案後,下一步是設定 Aspose.HTML 環境,其中涉及設定字體處理和其他樣式參數。 |
52 | | -### 2.1 建立配置實例 |
53 | | -我們首先建立一個實例`Configuration`類,它允許我們配置 HTML 文件處理方式的各個方面。 |
| 64 | +`FileWriter` 會將字串寫入專案資料夾下的 `user-agent-fontsetting.html`。完成此步驟後,即可取得實體的 HTML 檔案供後續處理。 |
| 65 | + |
| 66 | +### 步驟 2:設定 Aspose.HTML 環境 |
| 67 | +現在我們要建立 Aspose.HTML 的 `Configuration` 物件,以控制 HTML 的渲染方式。 |
| 68 | + |
| 69 | +#### 2.1 建立 Configuration 實例 |
54 | 70 | ```java |
55 | 71 | com.aspose.html.Configuration configuration = new com.aspose.html.Configuration(); |
56 | 72 | ``` |
57 | | -此實例將用於存取和修改用戶代理設置,這些設置控制 HTML 的呈現方式。 |
58 | | -### 2.2 存取用戶代理服務 |
59 | | -用戶代理服務負責應用樣式和管理字體。我們將從配置中檢索此服務。 |
| 73 | +`Configuration` 物件是自訂渲染選項(如字型處理與使用者代理行為)的入口點。 |
| 74 | + |
| 75 | +#### 2.2 取得 User Agent服務 |
60 | 76 | ```java |
61 | 77 | com.aspose.html.services.IUserAgentService userAgent = configuration.getService(com.aspose.html.services.IUserAgentService.class); |
62 | 78 | ``` |
63 | | -這行程式碼獲取`IUserAgentService`,我們將使用它來應用自訂樣式和配置字體設定。 |
64 | | -## 第 3 步:套用自訂樣式和字體 |
65 | | -現在環境已經設定完畢,讓我們套用一些自訂樣式並指定我們要使用的字體。 |
66 | | -### 3.1 設定自訂樣式 |
67 | | -我們將為標題定義自訂樣式(`h1`)和段落(`p`) HTML 文件中的元素。 |
| 79 | +`IUserAgentService` 負責管理樣式表、字型與其他渲染細節,我們將利用它注入自訂 CSS 並指向字型資料夾。 |
| 80 | + |
| 81 | +### 步驟 3:套用自訂樣式與字型 |
| 82 | +環境設定完成後,我們即可加入 CSS 規則並告訴 Aspose.HTML 在哪裡尋找字型。 |
| 83 | + |
| 84 | +#### 3.1 設定自訂 CSS |
68 | 85 | ```java |
69 | 86 | userAgent.setUserStyleSheet("h1 { color:#a52a2a; }\r\n" + |
70 | 87 | "p { color:grey; }\r\n"); |
71 | 88 | ``` |
72 | | -在這裡,我們應用棕色(`#a52a2a`)到標題和灰色(`grey`到段落文字。處理文件時,這些樣式將會套用至元素。 |
73 | | -### 3.2 設定自訂字體資料夾 |
74 | | -為了確保我們的文件使用正確的字體,我們將設定一個儲存字體的自訂資料夾。 |
| 89 | +此 CSS 將標題設為棕色、段落設為灰色。您可以加入任何有效的 CSS 規則——Aspose.HTML 支援完整的 CSS2.1 規範以及多數 CSS3 功能。 |
| 90 | + |
| 91 | +#### 3.2 指向自訂字型資料夾 |
75 | 92 | ```java |
76 | 93 | userAgent.getFontsSettings().setFontsLookupFolder("fonts"); |
77 | 94 | ``` |
78 | | -這一行告訴 Aspose.HTML 在`fonts`目錄。確保此資料夾包含必要的字體檔案(例如,`.ttf`或者`.otf`文件)。 |
79 | | -## 第 4 步:載入帶有配置的 HTML 文檔 |
80 | | -一切配置完畢後,就可以使用我們的自訂設定來載入 HTML 文件了。 |
| 95 | +將任何 `.ttf` 或 `.otf` 檔案放入專案根目錄下名為 `fonts` 的資料夾。Aspose.HTML 會在渲染時自動載入這些字型。 |
| 96 | + |
| 97 | +> **專業提示:** 若有多個字型系列,請將它們分門別類放入子資料夾,並使用分號分隔的列表將每個父資料夾加入 `FontsLookupFolder`。 |
| 98 | +
|
| 99 | +### 步驟 4:使用設定載入 HTML 文件 |
| 100 | +現在載入先前建立的 HTML 檔,並套用剛才的自訂設定。 |
81 | 101 |
|
82 | | -我們將初始化一個`HTMLDocument`具有指定配置和 HTML 文件路徑的物件。 |
83 | 102 | ```java |
84 | 103 | com.aspose.html.HTMLDocument document = new com.aspose.html.HTMLDocument("user-agent-fontsetting.html", configuration); |
85 | 104 | ``` |
86 | | -此步驟建立一個`HTMLDocument`準備使用我們配置的自訂樣式和字體進行處理的物件。 |
87 | | -## 第 5 步:將 HTML 轉換為 PDF |
88 | | -本教學的最後一步是將樣式化的 HTML 文件轉換為 PDF 文件。 |
| 105 | +`HTMLDocument` 物件現在代表已套用樣式的 HTML,準備進行轉換。 |
| 106 | + |
| 107 | +### 步驟 5:將 HTML 轉為 PDF |
| 108 | +最後,我們執行 **aspose html pdf conversion**,產生遵循自訂字型與樣式的 PDF 檔案。 |
89 | 109 |
|
90 | | -我們將使用`Converter`類別將 HTML 文件轉換為 PDF 格式。 |
91 | 110 | ```java |
92 | 111 | com.aspose.html.converters.Converter.convertHTML( |
93 | 112 | document, |
94 | 113 | new com.aspose.html.saving.PdfSaveOptions(), |
95 | 114 | "user-agent-fontsetting_out.pdf" |
96 | 115 | ); |
97 | 116 | ``` |
98 | | -此程式碼片段將 HTML 文件轉換為名為的 PDF 文件`user-agent-fontsetting_out.pdf`。這`PdfSaveOptions`參數可讓您指定 PDF 輸出的各種設定。 |
99 | | -## 第 6 步:清理資源 |
100 | | -轉換完成後,處理物件以釋放資源非常重要。 |
101 | | -### 6.1 文件的處置 |
102 | | -請務必將其丟棄`HTMLDocument`對像以避免記憶體洩漏。 |
| 117 | +`PdfSaveOptions` 物件允許您調整輸出設定,如頁面大小、壓縮與中繼資料。對於基本轉換,預設選項已足夠。 |
| 118 | + |
| 119 | +### 步驟 6:清理資源 |
| 120 | +正確釋放資源可防止記憶體洩漏,特別是在長時間執行且處理大量文件的情況下。 |
| 121 | + |
| 122 | +#### 6.1 釋放 HTMLDocument |
103 | 123 | ```java |
104 | 124 | if (document != null) { |
105 | 125 | document.dispose(); |
106 | 126 | } |
107 | 127 | ``` |
108 | | -這確保了與該相關的所有資源`HTMLDocument`被釋放。 |
109 | | -### 6.2 配置的處理 |
110 | | -同樣,處置`Configuration`完成後對象。 |
| 128 | + |
| 129 | +#### 6.2 釋放 Configuration |
111 | 130 | ```java |
112 | 131 | if (configuration != null) { |
113 | 132 | configuration.dispose(); |
114 | 133 | } |
115 | 134 | ``` |
116 | | -最後的清理步驟可確保您的應用程式有效地運行,而不會消耗不必要的資源。 |
| 135 | +上述呼叫會釋放 Aspose.HTML 所分配的原生資源。 |
| 136 | + |
| 137 | +## 常見問題與解決方案 |
| 138 | +| 問題 | 解決方案 | |
| 139 | +|------|----------| |
| 140 | +| **字型未顯示** | 確認 `fonts` 資料夾已正確被引用且內含有效的 `.ttf`/`.otf` 檔案。若資料夾位於專案目錄之外,請使用絕對路徑。 | |
| 141 | +| **PDF 為空白** | 確認 HTML 檔案路徑正確且可讀取。檢查 `Configuration` 物件是否已傳入 `HTMLDocument` 建構子。 | |
| 142 | +| **授權例外** | 在呼叫任何 Aspose API 前先套用臨時或正式授權。將授權檔放入 classpath,並使用 `License license = new License(); license.setLicense("Aspose.Total.Java.lic");` 載入。 | |
| 143 | +| **CSS 渲染異常** | Aspose.HTML 支援大多數 CSS,但不支援所有最新功能(例如 CSS Grid)。請簡化樣式或改用支援的 CSS 屬性。 | |
| 144 | + |
| 145 | +## 常見問答 |
| 146 | + |
| 147 | +**Q: 可以在 Aspose.HTML for Java 中使用任何字型嗎?** |
| 148 | +A: 可以,任何作業系統支援的 TrueType(`.ttf`)或 OpenType(`.otf`)字型皆可使用。只要將檔案放入您於 `FontsLookupFolder` 設定的資料夾即可。 |
| 149 | + |
| 150 | +**Q: 使用 Aspose.HTML for Java 必須要授權嗎?** |
| 151 | +A: 雖然可以在未授權的情況下評估此函式庫,但 [臨時授權](https://purchase.aspose.com/temporary-license/) 可解除評估限制。正式上線時必須購買完整授權。 |
| 152 | + |
| 153 | +**Q: 如何自訂 PDF 輸出?** |
| 154 | +A: 將配置好的 `PdfSaveOptions` 實例傳入 `convertHTML`。您可以設定頁面大小、邊距、壓縮等參數。 |
| 155 | + |
| 156 | +**Q: 能否套用更複雜的 CSS 樣式?** |
| 157 | +A: 可以,Aspose.HTML 支援廣泛的 CSS。複雜的選擇器、媒體查詢與偽類在瀏覽器中同樣有效,但某些最新的 CSS3/4 功能可能尚未完整支援。 |
| 158 | + |
| 159 | +**Q: 哪裡可以找到更多範例與文件?** |
| 160 | +A: 請造訪官方的 [Aspose.HTML for Java 文件頁面](https://reference.aspose.com/html/java/),內含詳細的 API 參考與額外程式碼範例。 |
| 161 | + |
| 162 | +**Q: 臨時 Aspose 授權對轉換有何影響?** |
| 163 | +A: 臨時授權會解除評估模式下的 10 頁限制與浮水印,讓您能完整測試 **aspose html pdf conversion** 工作流程。 |
117 | 164 |
|
118 | 165 | ## 結論 |
119 | | -在 Aspose.HTML for Java 中配置字體是一個簡單的過程,可以大大增強 HTML 文件的外觀和可讀性。透過遵循本指南中概述的步驟,您只需幾行程式碼即可輕鬆套用自訂樣式、管理字體以及將 HTML 內容轉換為 PDF 格式。無論您是經驗豐富的開發人員還是 Java 新手,Aspose.HTML 都能提供您輕鬆建立專業品質文件所需的工具。 |
120 | | - |
121 | | -## 常見問題解答 |
122 | | -### 我可以在 Aspose.HTML for Java 中使用任何字體嗎? |
123 | | -是的,您可以使用作業系統支援的任何字體。確保將字型檔案放置在指定的目錄中`FontsLookupFolder`. |
124 | | -### 我需要許可證才能使用 Aspose.HTML for Java 嗎? |
125 | | -雖然您可以在沒有許可證的情況下使用 Aspose.HTML 進行評估,但[臨時執照](https://purchase.aspose.com/temporary-license/)或建議用於生產用途的完整許可證以避免限制。 |
126 | | -### 如何自訂輸出 PDF 設定? |
127 | | -您可以透過修改以下內容來自訂 PDF 輸出`PdfSaveOptions`對象傳遞給`convertHTML`方法。 |
128 | | -### 是否可以使用 Aspose.HTML 應用更複雜的 CSS 樣式? |
129 | | -是的,Aspose.HTML 支援多種 CSS 樣式。您可以像在常規 Web 環境中一樣套用複雜的樣式。 |
130 | | -### 在哪裡可以找到更多範例和文件? |
131 | | -您可以在以下位置找到更詳細的範例和文檔[Aspose.HTML for Java 文件頁面](https://reference.aspose.com/html/java/). |
| 166 | +使用 Aspose.HTML 為 **html to pdf java** 設定字型是一個簡單卻功能強大的方式,能確保 PDF 完全保留網頁的外觀與排版。只要建立自訂字型資料夾、透過使用者代理服務注入 CSS,並利用內建的轉換器,即可用極少的程式碼產生高品質的 PDF。無論是報表、發票或任何文件產生流程,此方法皆能讓您完整掌控排版與字體。 |
| 167 | + |
| 168 | +--- |
| 169 | +**最後更新:** 2025-12-03 |
| 170 | +**測試環境:** Aspose.HTML for Java 24.12(撰寫時最新版本) |
| 171 | +**作者:** Aspose |
| 172 | + |
132 | 173 | {{< /blocks/products/pf/tutorial-page-section >}} |
133 | 174 |
|
134 | 175 | {{< /blocks/products/pf/main-container >}} |
135 | 176 | {{< /blocks/products/pf/main-wrap-class >}} |
136 | 177 |
|
137 | | -{{< blocks/products/products-backtop-button >}} |
| 178 | +{{< blocks/products/products-backtop-button >}} |
0 commit comments