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를 사용한 사용자 정의 글꼴 렌더링 구현

배울 내용

  • 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? 무료 30일 체험판을 사용할 수 있으며, 프로덕션에서는 유료 라이선스가 필요합니다.
  • 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를 구성하면 뷰어가 글꼴 파일을 검색하는 위치, 파일 캐시 방식, 사용자 정의 글꼴이 없을 때 적용할 대체 글꼴을 정확히 정의할 수 있습니다. 이러한 제어를 통해 렌더링 오류를 최대 95 % 감소시키고, 평균 페이지 로드 성능을 30 % 향상시키며, 모든 브라우저와 디바이스에서 일관된 모습을 보장합니다.

사전 요구 사항

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

기본 초기화 및 설정

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을 추가하는 방법

FontSource를 생성하여 글꼴 폴더를 가리키고, HtmlViewOptions를 구성하여 해당 글꼴을 삽입한 뒤, 그 옵션으로 문서를 렌더링함으로써 add custom font HTML을 추가합니다. 이 3단계 패턴을 통해 생성된 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 객체 생성

FontSource 클래스는 GroupDocs.Viewer에 글꼴 파일을 찾을 위치를 알려줍니다. 단일 폴더, ZIP 아카이브 또는 사용자 정의 스트림을 대상으로 할 수 있습니다.

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

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

Font Settings Java 구성

FontSettings 객체는 하나 이상의 FontSource 인스턴스와 선택적 대체 글꼴을 집계합니다.

FontSettings.setFontSources(fontSource);

이 라인은 configures font settings Java를 설정하여 모든 렌더링 작업이 제공한 글꼴을 사용하도록 합니다.

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

HtmlViewOptions 빌더를 사용하면 임베디드 리소스(글꼴이 HTML 내부에 Base64 인코딩)와 외부 리소스(글꼴이 링크) 중 선택할 수 있습니다.

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).

실용적인 적용 사례

사용자 정의 글꼴 렌더링은 다양한 시나리오에 적용될 수 있습니다:

  1. Branding Consistency: 모든 생성된 보고서에 브랜드 전용 글꼴을 사용합니다.
  2. Accessibility Improvements: 시각 장애 사용자를 돕는 가독성 높은 글꼴을 선택합니다.
  3. 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: 무료 30일 체험판으로 시작한 후, 구매 페이지에서 임시 또는 영구 라이선스로 업그레이드할 수 있습니다.

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

Q: 사용자 정의 글꼴이 없을 경우 기본 글꼴로 대체할 수 있습니까?
A: 예—여러 FontSource 객체를 추가하면 사용자 정의 글꼴을 우선 순위로 두고 시스템 기본 글꼴을 백업으로 유지할 수 있습니다.

리소스

마지막 업데이트: 2026-07-19
테스트 환경: GroupDocs.Viewer 25.2 for Java
작성자: GroupDocs

관련 튜토리얼