2026-02-10" maybe keep as is.

“Tested With: GroupDocs.Viewer 25.2 for Java” -> “Tested With: GroupDocs.Viewer 25.2 for Java”

“Author: GroupDocs” -> same.

Now produce final markdown with Korean translations.

Make sure to keep placeholders unchanged.

Let’s construct final output.# Java와 GroupDocs.Viewer를 사용한 add custom font 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 방법

이 튜토리얼을 마치면 커스텀 폰트를 사용해 문서 프레젠테이션을 맞춤화할 수 있게 되며, 브랜드 일관성과 향상된 접근성을 보장할 수 있습니다.

빠른 답변

What is the primary purpose? GroupDocs.Viewer Java를 사용해 자체 폰트로 문서를 렌더링하는 것입니다.
Which version is required? GroupDocs.Viewer 25.2(이상).
Do I need a license? 무료 체험을 이용할 수 있으며, 프로덕션에서는 유료 라이선스가 필요합니다.
Can I embed custom fonts HTML? 예 – 뷰어가 폰트가 들어있는 폴더를 가리키게 하면 됩니다.
Is Maven the only way to add the library? Maven이 권장되지만 Gradle이나 수동 JAR 포함도 가능합니다.

“add custom font HTML”이란?

add custom font HTML을 추가한다는 것은 HTML 출력 생성 시 기본 시스템 폰트가 아니라 사용자가 제공한 폰트를 렌더링 엔진이 사용하도록 지시하는 것을 의미합니다. 이를 통해 문서의 시각적 스타일이 기업 브랜딩이나 접근성 가이드라인과 일치하도록 보장합니다.

왜 GroupDocs.Viewer와 함께 font settings Java를 구성해야 할까요?

font settings Java를 구성하면 검색할 폰트 파일, 캐시 방식, 폴백 폰트 적용 방식을 완전히 제어할 수 있습니다. 이는 렌더링 오류를 줄이고 성능을 향상시키며 브라우저 전반에 걸쳐 일관된 모습을 보장합니다.

사전 요구 사항

Java Development Kit (JDK): 8 이상
IDE: IntelliJ IDEA, Eclipse 또는 Java 호환 편집기
Maven: 의존성 관리용
Custom font files: 전용 폴더에 배치된 .ttf 또는 .otf 파일

GroupDocs.Viewer for Java 설정

설치 정보

Maven pom.xml에 GroupDocs 저장소와 의존성을 추가합니다:

<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는 기능을 체험할 수 있는 무료 체험을 제공하며, 임시 라이선스를 얻거나 정식 라이선스를 구매할 수 있는 옵션이 있습니다. 테스트용으로는 release page에서 최신 버전을 다운로드하십시오.

기본 초기화 및 설정

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에서 add custom font HTML 추가 방법

이 섹션에서는 문서를 렌더링할 때 add custom font 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;

이러한 import는 커스텀 폰트와 문서 보기 옵션을 처리하는 데 도움이 됩니다.

커스텀 폰트 설정

폰트 폴더 경로 정의

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

"/path/to/your/custom/fonts"를 실제 .ttf 또는 .otf 파일이 있는 위치로 교체하십시오.

FontSource 객체 생성

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

SearchOption.TOP_FOLDER_ONLY는 뷰어가 지정된 폴더만 검색하도록 하여 검색 속도를 높입니다.

Font Settings Java 구성

FontSettings.setFontSources(fontSource);

이 라인은 configures font settings Java를 수행하여 모든 렌더링 작업이 제공한 폰트를 사용하도록 합니다.

출력 디렉터리 및 보기 옵션 정의

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 프로세스를 실행하는 사용자가 폰트 파일에 대한 읽기 권한을 가지고 있는지 확인하십시오.
폴더 경로를 다시 확인하십시오; 끝에 슬래시가 없으면 “font not found” 오류가 발생할 수 있습니다.
폰트가 문서 유형과 호환되는지 확인하십시오(예: PDF의 경우 TrueType).

실용적인 적용 사례

커스텀 폰트 렌더링은 다양한 시나리오에 적용될 수 있습니다:

Branding Consistency: 모든 생성된 보고서에 브랜드 전용 폰트를 사용합니다.
Accessibility Improvements: 시각 장애 사용자를 돕는 가독성 높은 폰트를 선택합니다.
Legal & Financial Documents: 스캔 가능성을 높이는 폰트로 주요 섹션을 강조합니다.

이 방식을 문서 관리 시스템, 콘텐츠 포털 또는 문서의 HTML 미리보기를 제공해야 하는 모든 엔터프라이즈 애플리케이션에 통합할 수 있습니다.

성능 고려 사항

대량 배치를 처리할 때:

메모리 사용량을 낮게 유지하려면 커스텀 폰트 수를 제한하십시오.
동일한 설정으로 많은 문서를 렌더링할 때 HtmlViewOptions 객체를 캐시하십시오.
JVM 힙을 모니터링하고 필요에 따라 -Xmx를 조정하여 OutOfMemory 오류를 방지하십시오.

결론

이제 GroupDocs.Viewer for Java를 사용해 add custom font HTML을 추가하고, configure font settings Java를 구성하며, 일관되고 브랜드화된 문서 렌더링을 위해 embed custom fonts HTML을 수행하는 방법을 배웠습니다. 이러한 기술을 통해 Java 기반 솔루션에서 세련되고 접근성 높은 HTML 미리보기를 제공할 수 있습니다.

다음 단계로 워터마크, 주석 지원, 다중 페이지 PDF 렌더링 등 추가적인 GroupDocs.Viewer 기능을 탐색해 보십시오. 자세한 내용은 공식 documentation을 참조하십시오.

자주 묻는 질문

Q: 커스텀 폰트와 다양한 문서 유형 간의 호환성을 어떻게 보장할 수 있나요?
A: PDF, DOCX, PPTX 파일에 폰트를 테스트하여 형식 전반에 걸쳐 일관된 렌더링을 확인하십시오.

Q: GroupDocs.Viewer가 커스텀 폰트를 사용해 비라틴 스크립트를 처리할 수 있나요?
A: 예—적절한 유니코드 지원 폰트를 폰트 폴더에 배치하면 뷰어가 문자를 올바르게 렌더링합니다.

Q: 프로덕션 사용을 위한 라이선스 옵션은 무엇인가요?
A: 무료 체험으로 시작한 뒤 purchase page에서 임시 또는 영구 라이선스로 업그레이드할 수 있습니다.

Q: 폰트 누락 문제를 어떻게 해결하나요?
A: 파일 권한을 확인하고, 경로를 검증하며, 폰트 파일이 손상되지 않았는지 확인하십시오. 뷰어 로그에 로드되지 않은 폰트가 표시됩니다.

Q: 커스텀 폰트를 사용할 수 없을 때 기본 폰트로 대체할 수 있나요?
A: 예—여러 FontSource 객체를 추가하면 커스텀 폰트를 우선 적용하면서 시스템 기본 폰트를 백업으로 유지할 수 있습니다.

리소스

추가 탐색을 위해:

Documentation: GroupDocs Viewer Java Docs
API Reference: GroupDocs API
Download: Latest Releases
Purchase and Trial Options: GroupDocs Purchase Page & Free Trials
Support: For additional help, visit the [GroupDocs Forum](

Last Updated: 2026-02-10
Tested With: GroupDocs.Viewer 25.2 for Java
Author: GroupDocs