Skip to content

Commit 26a4ab2

Browse files
Optimize page: html/english/java/configuring-environment/configure-fonts/_index.md - - Integrated primary keyword “html to pdf java” into title, intro, heading, and conclusion (4 occurrences).
- Added a “Quick Answers” section for AI-friendly snippets. - Expanded explanations before each code block, added tips and a troubleshooting table. - Inserted secondary keywords (“generate pdf from html”, “temporary aspose license”, “aspose html pdf conversion”) naturally throughout. - Added a comprehensive FAQ with additional Q&A and a trust‑signal block (last updated, tested version, author). - Updated front‑matter with current date and refined meta description for SEO.
1 parent d306584 commit 26a4ab2

File tree

23 files changed

+2635
-1653
lines changed
  • html
    • arabic/java/configuring-environment/configure-fonts
    • chinese/java/configuring-environment/configure-fonts
    • czech/java/configuring-environment/configure-fonts
    • dutch/java/configuring-environment/configure-fonts
    • english/java/configuring-environment/configure-fonts
    • french/java/configuring-environment/configure-fonts
    • german/java/configuring-environment/configure-fonts
    • greek/java/configuring-environment/configure-fonts
    • hindi/java/configuring-environment/configure-fonts
    • hongkong/java/configuring-environment/configure-fonts
    • hungarian/java/configuring-environment/configure-fonts
    • indonesian/java/configuring-environment/configure-fonts
    • italian/java/configuring-environment/configure-fonts
    • japanese/java/configuring-environment/configure-fonts
    • korean/java/configuring-environment/configure-fonts
    • polish/java/configuring-environment/configure-fonts
    • portuguese/java/configuring-environment/configure-fonts
    • russian/java/configuring-environment/configure-fonts
    • spanish/java/configuring-environment/configure-fonts
    • swedish/java/configuring-environment/configure-fonts
    • thai/java/configuring-environment/configure-fonts
    • turkish/java/configuring-environment/configure-fonts
    • vietnamese/java/configuring-environment/configure-fonts

23 files changed

+2635
-1653
lines changed

html/arabic/java/configuring-environment/configure-fonts/_index.md

Lines changed: 116 additions & 73 deletions
Large diffs are not rendered by default.

html/chinese/java/configuring-environment/configure-fonts/_index.md

Lines changed: 117 additions & 74 deletions
Large diffs are not rendered by default.

html/czech/java/configuring-environment/configure-fonts/_index.md

Lines changed: 116 additions & 72 deletions
Large diffs are not rendered by default.

html/dutch/java/configuring-environment/configure-fonts/_index.md

Lines changed: 116 additions & 72 deletions
Large diffs are not rendered by default.

html/english/java/configuring-environment/configure-fonts/_index.md

Lines changed: 108 additions & 68 deletions
Large diffs are not rendered by default.

html/french/java/configuring-environment/configure-fonts/_index.md

Lines changed: 115 additions & 71 deletions
Large diffs are not rendered by default.

html/german/java/configuring-environment/configure-fonts/_index.md

Lines changed: 104 additions & 69 deletions
Large diffs are not rendered by default.

html/greek/java/configuring-environment/configure-fonts/_index.md

Lines changed: 108 additions & 73 deletions
Large diffs are not rendered by default.

html/hindi/java/configuring-environment/configure-fonts/_index.md

Lines changed: 116 additions & 72 deletions
Large diffs are not rendered by default.
Lines changed: 113 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -1,137 +1,178 @@
11
---
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/
610
weight: 11
7-
url: /zh-hant/java/configuring-environment/configure-fonts/
811
---
912

1013
{{< blocks/products/pf/main-wrap-class >}}
1114
{{< blocks/products/pf/main-container >}}
1215
{{< blocks/products/pf/tutorial-page-section >}}
1316

14-
# 在 Aspose.HTML for Java 中配置字體
17+
# 設定字型於 HTML 轉 PDF Java 使用 Aspose.HTML
1518

16-
## 介紹
17-
在 Java 中處理 HTML 文件時,正確配置字體對於建立具有視覺吸引力和可讀性的內容至關重要。無論您是產生報告、建立網頁還是轉換文檔,確保正確配置字體都會產生重大影響。本教學將引導您完成在 Aspose.HTML for Java 中配置字體的過程,從設定環境到使用自訂字體將 HTML 轉換為 PDF。那麼,讓我們深入了解一下吧
19+
## 簡介
20+
在 Java 中處理 HTML 文件時,正確設定字型對於產生視覺上吸引且易讀的 **html to pdf java** 轉換至關重要。無論是產生報表、建置網頁,或是文件轉換,適當的字型配置都會大幅提升最終 PDF 的品質。本指南將一步步說明整個流程——從建置開發環境到使用自訂字型將 HTML 轉為 PDF——讓您只需幾行程式碼即可產出專業外觀的 PDF。讓我們立即開始吧
1821

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` 調整頁面大小、邊距等。
2628

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 類別。
2938
```java
3039
import java.io.IOException;
3140
```
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 程式碼
3752
```java
3853
String code = "<h1>FontsSettings property</h1>\r\n" +
3954
"<p>The FontsSettings property is used for configuration of fonts handling.</p>\r\n";
4055
```
41-
該字串包含我們想要設定樣式的 HTML 內容。請注意,它包含一個標頭 (`<h1>`)和一段(`<p>`
42-
### 1.2 將 HTML 內容儲存到文件
43-
接下來,您將使用以下命令將此 HTML 內容儲存到檔案中`FileWriter`.
56+
此程式碼片段定義了一個標題與一段文字。若需測試其他樣式,可自行擴充 HTML
57+
58+
#### 1.2 儲存 HTML 為檔案
4459
```java
4560
try (java.io.FileWriter fileWriter = new java.io.FileWriter("user-agent-fontsetting.html")) {
4661
fileWriter.write(code);
4762
}
4863
```
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 實例
5470
```java
5571
com.aspose.html.Configuration configuration = new com.aspose.html.Configuration();
5672
```
57-
此實例將用於存取和修改用戶代理設置,這些設置控制 HTML 的呈現方式
58-
### 2.2 存取用戶代理服務
59-
用戶代理服務負責應用樣式和管理字體。我們將從配置中檢索此服務。
73+
`Configuration` 物件是自訂渲染選項(如字型處理與使用者代理行為)的入口點
74+
75+
#### 2.2 取得 User Agent服務
6076
```java
6177
com.aspose.html.services.IUserAgentService userAgent = configuration.getService(com.aspose.html.services.IUserAgentService.class);
6278
```
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
6885
```java
6986
userAgent.setUserStyleSheet("h1 { color:#a52a2a; }\r\n" +
7087
"p { color:grey; }\r\n");
7188
```
72-
在這裡,我們應用棕色(`#a52a2a`)到標題和灰色(`grey`到段落文字。處理文件時,這些樣式將會套用至元素
73-
### 3.2 設定自訂字體資料夾
74-
為了確保我們的文件使用正確的字體,我們將設定一個儲存字體的自訂資料夾。
89+
此 CSS 將標題設為棕色、段落設為灰色。您可以加入任何有效的 CSS 規則——Aspose.HTML 支援完整的 CSS2.1 規範以及多數 CSS3 功能
90+
91+
#### 3.2 指向自訂字型資料夾
7592
```java
7693
userAgent.getFontsSettings().setFontsLookupFolder("fonts");
7794
```
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 檔,並套用剛才的自訂設定。
81101

82-
我們將初始化一個`HTMLDocument`具有指定配置和 HTML 文件路徑的物件。
83102
```java
84103
com.aspose.html.HTMLDocument document = new com.aspose.html.HTMLDocument("user-agent-fontsetting.html", configuration);
85104
```
86-
此步驟建立一個`HTMLDocument`準備使用我們配置的自訂樣式和字體進行處理的物件。
87-
## 第 5 步:將 HTML 轉換為 PDF
88-
本教學的最後一步是將樣式化的 HTML 文件轉換為 PDF 文件。
105+
`HTMLDocument` 物件現在代表已套用樣式的 HTML,準備進行轉換。
106+
107+
### 步驟 5:將 HTML 轉為 PDF
108+
最後,我們執行 **aspose html pdf conversion**,產生遵循自訂字型與樣式的 PDF 檔案。
89109

90-
我們將使用`Converter`類別將 HTML 文件轉換為 PDF 格式。
91110
```java
92111
com.aspose.html.converters.Converter.convertHTML(
93112
document,
94113
new com.aspose.html.saving.PdfSaveOptions(),
95114
"user-agent-fontsetting_out.pdf"
96115
);
97116
```
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
103123
```java
104124
if (document != null) {
105125
document.dispose();
106126
}
107127
```
108-
這確保了與該相關的所有資源`HTMLDocument`被釋放。
109-
### 6.2 配置的處理
110-
同樣,處置`Configuration`完成後對象。
128+
129+
#### 6.2 釋放 Configuration
111130
```java
112131
if (configuration != null) {
113132
configuration.dispose();
114133
}
115134
```
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** 工作流程。
117164

118165
## 結論
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+
132173
{{< /blocks/products/pf/tutorial-page-section >}}
133174

134175
{{< /blocks/products/pf/main-container >}}
135176
{{< /blocks/products/pf/main-wrap-class >}}
136177

137-
{{< blocks/products/products-backtop-button >}}
178+
{{< blocks/products/products-backtop-button >}}

0 commit comments

Comments
 (0)