Skip to content

Commit fe6c285

Browse files
Optimize 46 Viewer Java pages (#32)
Auto-merge: Optimize 46 Viewer Java pages (arbiter score 100/100)
1 parent e2bdec1 commit fe6c285

46 files changed

Lines changed: 4103 additions & 4032 deletions

File tree

  • content
    • arabic/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • chinese/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • czech/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • dutch/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • english/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • french/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • german/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • greek/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • hindi/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • hongkong/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • hungarian/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • indonesian/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • italian/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • japanese/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • korean/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • polish/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • portuguese/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • russian/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • spanish/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • swedish/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • thai/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • turkish/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer
    • vietnamese/java
      • custom-rendering/java-groupdocs-viewer-custom-font-rendering
      • export-conversion/convert-documents-pdf-java-groupdocs-viewer

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

content/arabic/java/custom-rendering/java-groupdocs-viewer-custom-font-rendering/_index.md

Lines changed: 91 additions & 78 deletions
Large diffs are not rendered by default.

content/arabic/java/export-conversion/convert-documents-pdf-java-groupdocs-viewer/_index.md

Lines changed: 95 additions & 101 deletions
Large diffs are not rendered by default.
Lines changed: 95 additions & 86 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,57 @@
11
---
2-
"date": "2025-04-24"
3-
"description": "了解如何在 GroupDocs.Viewer for Java 中使用自定义字体来提升文档美感并保持品牌一致性。请遵循这份全面的指南,了解设置、配置和实际应用。"
4-
"title": "如何使用 GroupDocs.Viewer 在 Java 中实现自定义字体渲染——分步指南"
5-
"url": "/zh/java/custom-rendering/java-groupdocs-viewer-custom-font-rendering/"
6-
"weight": 1
2+
date: '2026-02-10'
3+
description: 了解如何使用 GroupDocs.Viewer for Java 添加自定义字体 HTML,配置 Java 字体设置,并嵌入自定义字体 HTML,以实现品牌化和可读性。
4+
keywords:
5+
- custom font rendering Java
6+
- GroupDocs Viewer setup
7+
- Java GroupDocs Viewer custom fonts
8+
title: 如何在 Java 中使用 GroupDocs.Viewer 添加自定义字体 HTML:一步一步指南
79
type: docs
10+
url: /zh/java/custom-rendering/java-groupdocs-viewer-custom-font-rendering/
11+
weight: 1
812
---
9-
# 如何使用 GroupDocs.Viewer 在 Java 中实现自定义字体渲染:分步指南
13+
14+
# 如何在 Java 中使用 GroupDocs.Viewer 添加自定义字体 HTML:一步一步指南
1015

1116
## 介绍
1217

13-
您是否面临默认字体不符合品牌审美或可读性要求的难题?无论是商业报告、法律文件还是演示文稿,自定义字体都能显著提升文档的吸引力和专业性。在本分步指南中,我们将探讨如何使用 **GroupDocs.Viewer Java** 用于有效的自定义字体渲染。
18+
您是否为默认字体与品牌视觉标识不匹配而苦恼?在许多商业报告、法律文件和演示文稿中,**add custom font HTML** 是保持外观一致并提升可读性的关键。本指南将带您使用 **GroupDocs.Viewer for Java** 配置 font settings Java 并嵌入 custom fonts HTML,以便渲染的文档呈现出您期望的效果。
19+
20+
![Implement Custom Font Rendering with GroupDocs.Viewer for Java](/viewer/custom-rendering/implement-custom-font-rendering.png)
21+
22+
### 您将学习的内容
23+
- 如何设置 GroupDocs.Viewer for Java
24+
- 如何将 **add custom font HTML** 添加到渲染输出中
25+
- 如何为获得最佳性能 **configure font settings Java**
26+
27+
通过本教程,您将能够使用自定义字体定制文档呈现,确保品牌一致性并提升可访问性。
1428

15-
### 您将学到什么:
16-
- 为 Java 设置 GroupDocs.Viewer
17-
- 在文档渲染中集成自定义字体
18-
- 优化配置以提高性能
29+
## 快速答案
30+
- **主要目的是什么?** 使用 GroupDocs.Viewer Java 用您自己的字体渲染文档。
31+
- **需要哪个版本?** GroupDocs.Viewer 25.2(或更高)。
32+
- **我需要许可证吗?** 提供免费试用;生产环境需要付费许可证。
33+
- **我可以嵌入 custom fonts HTML 吗?** 可以——只需将查看器指向包含字体的文件夹。
34+
- **Maven 是唯一的添加库的方式吗?** 推荐使用 Maven,但也可以使用 Gradle 或手动引入 JAR。
1935

20-
完成本教程后,您将掌握使用自定义字体定制文档演示文稿的方法。首先,请确保您的开发环境已准备好必要的工具。
36+
## 什么是 “add custom font HTML”?
2137

22-
## 先决条件
38+
添加 custom font HTML 意味着指示渲染引擎在生成 HTML 输出时使用您提供的字体,而不是默认系统字体。这可确保文档的视觉风格符合您的企业品牌或可访问性指南。
2339

24-
在开始之前,请确保您已:
25-
- **Java 开发工具包 (JDK):** 版本 8 或更高版本
26-
- **集成开发环境(IDE):** 例如 IntelliJ IDEA 或 Eclipse
27-
- **Maven:** 用于管理项目依赖关系
40+
## 为什么要在 GroupDocs.Viewer 中配置 font settings Java?
2841

29-
对 Java 编程有基本的了解并熟悉 Maven 将会很有帮助
42+
配置 font settings Java 可让您完全控制搜索哪些字体文件、如何缓存以及如何应用回退字体。这可减少渲染错误、提升性能,并确保在各浏览器间外观一致
3043

31-
## 为 Java 设置 GroupDocs.Viewer
44+
## 前置条件
45+
- **Java Development Kit (JDK):** 8 或更高
46+
- **IDE:** IntelliJ IDEA、Eclipse 或任何兼容 Java 的编辑器
47+
- **Maven:** 用于依赖管理
48+
- **自定义字体文件:** 放置在专用文件夹中的 `.ttf``.otf` 文件
49+
50+
## 设置 GroupDocs.Viewer for Java
3251

3352
### 安装信息
3453

35-
在你的 Maven 中包含以下内容 `pom.xml` 文件
54+
将 GroupDocs 仓库和依赖添加到您的 Maven `pom.xml`
3655

3756
```xml
3857
<repositories>
@@ -51,37 +70,33 @@ type: docs
5170
</dependencies>
5271
```
5372

54-
### 许可证获取
73+
### License Acquisition
5574

56-
GroupDocs 提供免费试用,方便用户探索其功能,并提供获取临时许可证或购买完整许可证的选项。如需测试,请从其 [发布页面](https://releasesgroupdocs.com/viewer/java/).
75+
GroupDocs 提供免费试用以探索其功能,并提供获取临时许可证或购买完整许可证的选项。测试时,可从其[release page](https://releases.groupdocs.com/viewer/java/)下载最新版本。
5776

58-
#### 基本初始化和设置
77+
#### Basic Initialization and Setup
5978

60-
添加 GroupDocs.Viewer 作为依赖项后,在 Java 项目中初始化它
79+
在将 GroupDocs.Viewer 添加为依赖后,在 Java 项目中进行初始化
6180

6281
```java
6382
import com.groupdocs.viewer.Viewer;
6483

6584
public class ViewerSetup {
6685
public static void main(String[] args) {
6786
try (Viewer viewer = new Viewer("sample.pdf")) {
68-
// 初始设置和查看代码在这里
87+
// Initial setup and viewing code here
6988
}
7089
}
7190
}
7291
```
7392

74-
这个基本示例演示了如何使用 GroupDocs.Viewer 打开文档。
75-
76-
## 实施指南
77-
78-
### GroupDocs.Viewer Java 中的自定义字体渲染
93+
## Implementation Guide
7994

80-
在本节中,我们将探讨如何在使用 GroupDocs.Viewer 渲染文档时集成自定义字体。此功能对于保持品牌一致性和增强可读性至关重要。
95+
### GroupDocs.Viewer Java 中如何 add custom font HTML
8196

82-
#### 导入必要的包
97+
本节将逐步演示在渲染文档时所需的 **add custom font HTML** 的具体步骤。
8398

84-
首先导入所需的包:
99+
#### Importing Necessary Packages
85100

86101
```java
87102
import com.groupdocs.viewer.Viewer;
@@ -93,101 +108,95 @@ import com.groupdocs.viewer.fonts.SearchOption;
93108

94109
这些导入有助于处理自定义字体和文档查看选项。
95110

96-
#### 设置自定义字体
111+
#### Setting Up Custom Fonts
97112

98-
##### 定义自定义字体的路径
99-
100-
创建一个指向自定义字体目录的字符串变量:
113+
##### Define the Path to Your Font Folder
101114

102115
```java
103116
String fontPath = "/path/to/your/custom/fonts";
104117
```
105118

106-
代替 `"/path/to/your/custom/fonts"` 替换为自定义字体的实际存储路径。此设置可确保 GroupDocs.Viewer 在渲染过程中能够找到并使用这些字体。
107-
108-
##### 创建 FontSource 对象
119+
`"/path/to/your/custom/fonts"` 替换为 `.ttf``.otf` 文件的实际位置。
109120

110-
接下来,实例化 `FolderFontSource` 对象指向该目录:
121+
##### Create a FontSource Object
111122

112123
```java
113124
FolderFontSource fontSource = new FolderFontSource(fontPath, SearchOption.TOP_FOLDER_ONLY);
114125
```
115126

116-
`SearchOption.TOP_FOLDER_ONLY` 参数指示查看器仅在指定的顶级文件夹中搜索字体。
117-
118-
##### 设置渲染的字体源
127+
`SearchOption.TOP_FOLDER_ONLY` 告诉查看器仅在指定文件夹中查找,从而加快搜索速度。
119128

120-
现在,配置 GroupDocs.Viewer 以使用您的自定义字体:
129+
##### Configure Font Settings Java
121130

122131
```java
123132
FontSettings.setFontSources(fontSource);
124133
```
125134

126-
此步骤确保所有后续文档渲染操作都将使用这些自定义字体
135+
此行 **configures font settings Java**,使每次渲染操作都使用您提供的字体
127136

128-
#### 定义输出目录和视图选项
129-
130-
设置渲染文档的保存位置:
137+
#### Define Output Directory and View Options
131138

132139
```java
133140
String outputPath = "/path/to/output/directory";
134141
String pageFilePathFormat = String.format("%s/page_{0}.html", outputPath);
135142
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
136143
```
137144

138-
代替 `"/path/to/output/directory"` 替换为您想要的输出路径。 `HtmlViewOptions` 类帮助配置如何将文档呈现为 HTML 格式。
139-
140-
### 故障排除提示
141-
- 确保字体文件具有适当的读取权限。
142-
- 仔细检查路径是否有拼写错误或目录结构不正确。
143-
- 验证自定义字体与正在处理的文档类型的兼容性。
145+
这里我们还演示如何通过使用 `HtmlViewOptions.forEmbeddedResources`**embed custom fonts HTML**,该方法将字体文件直接嵌入生成的 HTML 中。
144146

145-
## 实际应用
147+
### 故障排除技巧
148+
- 确认字体文件对运行 Java 进程的用户具有读取权限。
149+
- 再次检查文件夹路径;缺少结尾的斜杠可能导致 “font not found” 错误。
150+
- 确保字体与文档类型兼容(例如,PDF 使用 TrueType)。
146151

147-
自定义字体渲染可以应用于各种场景:
148-
1. **品牌一致性:** 在所有文档中使用品牌特定的字体来保持一致的标识。
149-
2. **辅助功能改进:** 选择能够提高视障用户可读性的字体。
150-
3. **法律和财务文件:** 使用强调重要部分的字体来提高清晰度。
152+
## Practical Applications
151153

152-
集成可能性包括将 GroupDocs.Viewer Java 与文档管理系统或自定义企业应用程序连接起来,从而实现跨平台的无缝字体定制。
154+
自定义字体渲染可应用于多种场景:
155+
1. **品牌一致性:** 在所有生成的报告中使用品牌专用字体。
156+
2. **可访问性提升:** 选择易读的字体,以帮助视力受限的用户。
157+
3. **法律与金融文档:** 使用提升可扫描性的字体突出关键章节。
153158

154-
## 性能考虑
159+
您可以将此方法集成到文档管理系统、内容门户或任何需要提供文档 HTML 预览的企业应用中。
155160

156-
处理大量文档时,请考虑以下技巧来优化性能:
157-
- 限制自定义字体的数量以减少资源开销。
158-
- 对经常访问的文档实施缓存策略。
159-
- 监视内存使用情况并根据需要调整 JVM 设置。
161+
## Performance Considerations
160162

161-
遵循 Java 内存管理的最佳实践,确保资源在使用后正确关闭。这种方法可以最大限度地减少内存泄漏并增强应用程序的稳定性。
163+
在处理大批量时:
164+
- 限制自定义字体数量,以降低内存使用。
165+
- 在使用相同设置渲染大量文档时缓存 `HtmlViewOptions` 对象。
166+
- 监控 JVM 堆并根据需要调整 `-Xmx`,以避免 OutOfMemory 错误。
162167

163-
## 结论
168+
## Conclusion
164169

165-
现在,您已经掌握了使用 GroupDocs.Viewer for Java 实现自定义字体渲染的基础知识。遵循本指南,您可以增强文档呈现效果,以满足特定的品牌推广或可读性需求
170+
您现在已经学习了如何使用 GroupDocs.Viewer for Java **add custom font HTML**,如何 **configure font settings Java**,以及如何 **embed custom fonts HTML**,以实现一致且符合品牌的文档渲染。这些技术使您能够在任何基于 Java 的解决方案中提供精美、可访问的 HTML 预览
166171

167-
下一步,请考虑探索 GroupDocs.Viewer 提供的其他功能,例如水印和注释支持。深入了解他们的 [文档](https://docs.groupdocs.com/viewer/java/) 以获得更高级的功能
172+
下一步,您可以探索 GroupDocs.Viewer 的其他功能,如水印、批注支持和多页 PDF 渲染。欲了解更深入的细节,请参阅官方[documentation](https://docs.groupdocs.com/viewer/java/)
168173

169-
## 常见问题解答部分
174+
## Frequently Asked Questions
170175

171-
**问:如何确保自定义字体与不同文档类型之间的兼容性**
172-
答:使用各种文档格式测试您的字体,以确认一致的渲染
176+
**问:如何确保自定义字体与不同文档类型的兼容性**
177+
**答:** 使用 PDF、DOCX 和 PPTX 文件测试您的字体,以确认在各种格式下渲染一致
173178

174-
**问:GroupDocs.Viewer 可以使用自定义字体处理非拉丁字母脚本吗**
175-
答:是的,正确配置后它支持多种字符集
179+
**问:GroupDocs.Viewer 能否使用自定义字体处理非拉丁文字脚本**
180+
**答:** 能——只要将支持相应 Unicode 的字体放入字体文件夹,查看器即可正确渲染字符
176181

177-
**问:在生产中使用 GroupDocs.Viewer 有哪些许可选项**
178-
答:选项包括免费试用、临时许可证和永久购买。详情请访问他们的 [购买页面](https://purchasegroupdocs.com/buy).
182+
**问:生产使用有哪些许可选项**
183+
**答:** 您可以先使用免费试用,然后通过[购买页面](https://purchase.groupdocs.com/buy)升级为临时或永久许可证。
179184

180-
**问:如何解决 GroupDocs.Viewer 中的字体渲染问题**
181-
答:请检查权限、路径和兼容性设置。请参阅文档以了解具体的错误消息
185+
**问:如何排查缺失字体的问题**
186+
**答:** 检查文件权限、确认路径,并确保字体文件未损坏。查看器日志会指示未能加载的字体
182187

183-
**问:自定义字体可以与默认字体一起使用作为后备选项吗**
184-
答:是的,您可以配置多个字体源,如果自定义字体不可用,则默认字体可作为备份
188+
**问:如果自定义字体不可用,是否可以回退到默认字体**
189+
**答:** 可以——通过添加多个 `FontSource` 对象,您可以优先使用自定义字体,同时保留系统默认字体作为备份
185190

186-
## 资源
191+
## Resources
187192

188193
进一步探索:
189-
- **文档:** [GroupDocs 查看器 Java 文档](https://docs.groupdocs.com/viewer/java/)
194+
- **文档:** [GroupDocs Viewer Java Docs](https://docs.groupdocs.com/viewer/java/)
190195
- **API 参考:** [GroupDocs API](https://reference.groupdocs.com/viewer/java/)
191-
- **下载:** [最新发布](https://releases.groupdocs.com/viewer/java/)
192-
- **购买和试用选项:** [GroupDocs 购买页面](https://purchase.groupdocs.com/buy) & [免费试用](https://releases.groupdocs.com/viewer/java/)
193-
- **支持:** 如需更多帮助,请访问 [GroupDocs 论坛](
196+
- **下载:** [Latest Releases](https://releases.groupdocs.com/viewer/java/)
197+
- **购买与试用选项:** [GroupDocs Purchase Page](https://purchase.groupdocs.com/buy)[Free Trials](https://releases.groupdocs.com/viewer/java/)
198+
- **支持:** 如需更多帮助,请访问 [GroupDocs Forum](
199+
200+
**最后更新:** 2026-02-10
201+
**测试环境:** GroupDocs.Viewer 25.2 for Java
202+
**作者:** GroupDocs

0 commit comments

Comments
 (0)