HTML을 렌더링하고 GroupDocs.Viewer Java에서 Arial 글꼴 제외하기

문서를 HTML로 렌더링하는 것은 웹 기반 애플리케이션에서 일반적인 요구 사항이지만, 원하지 않는 글꼴은 시각적 일관성을 깨뜨릴 수 있습니다. 이 튜토리얼에서는 Arial 글꼴을 제외하면서 HTML을 렌더링하는 방법을 배우게 되며, 출력물이 디자인 가이드라인에 맞도록 보장합니다. 설정 과정, 정확한 코드 변경 사항 및 원활한 docx to html java 변환을 위한 모범 사례를 단계별로 안내합니다.

GroupDocs.Viewer for Java를 사용한 HTML 렌더링에서 Arial 글꼴 제외

배우게 될 내용:

GroupDocs.Viewer for Java를 구성하여 문서를 HTML로 렌더링하는 방법.
문서 변환 중 Arial과 같은 특정 글꼴을 제외하는 과정.
GroupDocs.Viewer Java 사용 시 모범 사례 및 성능 고려 사항.

빠른 답변

HTML을 렌더링하는 방법? GroupDocs.Viewer Java와 함께 HtmlViewOptions를 사용하여 자체 포함형 HTML 페이지를 생성합니다.
Arial 글꼴을 제외할 수 있나요? 예—viewOptions.getFontsToExclude().add("Arial")를 호출합니다.
어떤 라이브러리 버전인가요? 이 가이드는 GroupDocs.Viewer for Java 25.2(또는 최신 안정 버전)를 사용합니다.
지원되는 입력 형식은 무엇인가요? DOCX, PDF, PPTX, XLSX 등 다양한 형식.
라이선스가 필요합니까? 무료 체험으로 테스트가 가능하지만, 프로덕션에서는 정식 라이선스가 필요합니다.

사전 요구 사항

이 튜토리얼을 따라하려면 다음을 준비하세요:

라이브러리 및 버전: GroupDocs.Viewer for Java 버전 25.2가 필요합니다.
환경 설정: Java 개발 환경(IDE, 예: IntelliJ IDEA 또는 Eclipse)과 Maven이 설치되어 있어야 합니다.
지식 사전 요구 사항: Java 프로그래밍에 대한 기본 이해와 Maven 프로젝트 설정에 대한 친숙함.

GroupDocs.Viewer for Java 설정하기

시작하려면 Maven을 사용하여 pom.xml 파일에 GroupDocs.Viewer에 필요한 종속성을 추가합니다:

<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 무료 체험에서 다운로드합니다.
임시 라이선스: 장기 테스트를 위해 GroupDocs 임시 라이선스를 신청합니다.
구매: GroupDocs.Viewer 기능에 만족하면 구매 페이지에서 정식 라이선스를 구매합니다.

기본 초기화 및 설정

Maven 프로젝트를 설정한 후, 새 Java 클래스를 만들고 필요한 GroupDocs 패키지를 임포트합니다. 이 설정은 문서를 렌더링하기 위해 뷰어를 초기화하는 데 필수적입니다.

HTML 렌더링 시 Arial 글꼴 제외 방법

개요

특정 글꼴을 제외하면 HTML 변환 시 시각적 출력에 대한 제어를 강화하여 HTML 렌더링 최적화를 통해 속도와 브랜드 일관성을 유지할 수 있습니다.

단계별 구현

1. 출력 디렉터리 정의

HTML 파일을 저장할 위치를 지정합니다:

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");

이 경로는 렌더링된 HTML 문서가 저장될 위치를 결정합니다.

2. HTML 페이지 파일 경로 설정

각 페이지 파일 이름 구조를 정의합니다:

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

플레이스홀더 {0}는 페이지 번호에 따라 파일 이름을 동적으로 지정할 수 있게 하여 정리된 저장을 보장합니다.

3. 임베디드 리소스를 포함한 뷰 옵션 구성

HtmlViewOptions 객체를 생성하여 HTML 렌더링 방식을 지정합니다:

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

이 설정은 모든 리소스를 HTML 파일에 임베드하여 자체 포함형이 되도록 합니다.

4. 특정 글꼴 제외

출력에서 제외하려는 글꼴(이 경우 Arial)을 추가합니다:

viewOptions.getFontsToExclude().add("Arial");

글꼴을 제외하면 디자인 일관성을 유지하고 파일 크기를 줄이는 데 중요합니다.

5. Viewer를 사용해 문서 렌더링

마지막으로 Viewer 클래스를 사용해 문서를 HTML 형식으로 렌더링합니다:

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX")) {
    viewer.view(viewOptions);
}

try‑with‑resources 구문은 렌더링 후 viewer가 적절히 닫히도록 보장합니다.

문제 해결 팁

일반적인 문제: 경로가 올바르고 접근 가능하도록 확인하세요; 잘못된 경로는 파일을 찾을 수 없음 오류를 일으킬 수 있습니다.
성능 팁: 대용량 문서를 렌더링할 때는 임베디드 리소스로 인해 로드 시간이 늘어날 수 있으므로 메모리 사용량을 모니터링하세요.

왜 중요한가: 실제 사용 사례

기업 보고 – 기본 글꼴을 제외하여 보고서를 브랜드 가이드라인에 맞게 유지합니다.
교육 자료 – 다양한 디바이스에서 가독성을 높이기 위해 글꼴 렌더링을 맞춤 설정합니다.
법률 문서 – 법원 제출용 HTML 프레젠테이션의 일관된 외관을 유지합니다.
전자상거래 목록 – 제품 설명이 브랜드 표준을 따르도록 합니다.
CMS 통합 – 콘텐츠 관리 시스템 내에서 깔끔하고 글꼴이 제어된 미리보기를 제공합니다.

HTML 렌더링 성능 최적화

빠른 변환을 위한 팁

효율적인 파일 경로 사용: 디렉터리 구조를 얕게 유지해 I/O 오버헤드를 줄입니다.
임베디드 리소스 제한: 필수 CSS/JS만 임베드해 HTML을 가볍게 유지합니다.

Java 메모리 관리 모범 사례

Viewer를 즉시 닫기: try‑with‑resources 패턴은 렌더링이 끝나는 즉시 메모리를 해제합니다.
애플리케이션 부하 모니터링: 여러 개 또는 대용량 문서를 처리할 때 JVM을 프로파일링해 메모리 부족 오류를 방지하세요.

자주 묻는 질문

Q1: GroupDocs.Viewer는 무엇에 사용되나요?
A1: 개발자가 HTML, 이미지, PDF 등 다양한 형식으로 문서를 렌더링할 수 있게 해주는 강력한 라이브러리입니다.

Q2: Arial 외에 다른 글꼴을 제외하려면 어떻게 해야 하나요?
A2: 원하는 글꼴 이름을 사용해 getFontsToExclude().add("FONT_NAME") 메서드를 호출하면 됩니다.

Q3: GroupDocs.Viewer가 대용량 문서 변환을 효율적으로 처리할 수 있나요?
A3: 예, 이 가이드에 설명된 리소스 처리 및 메모리 관리 최적화를 통해 가능합니다.

Q4: GroupDocs.Viewer 설정 시 흔히 발생하는 문제는 무엇인가요?
A4: 일반적인 문제는 경로 설정 오류나 Maven 종속성 누락입니다. 모든 경로를 확인하고 Maven 좌표가 올바른지 확인하세요.

Q5: Java와 함께 GroupDocs.Viewer를 사용하는 추가 자료는 어디서 찾을 수 있나요?
A5: 자세한 가이드와 API 레퍼런스는 GroupDocs 문서를 참고하세요.

Q6: 이 방법이 Java에서 DOCX를 HTML로 변환하는 데 적용되나요?
A6: 물론입니다—Viewer 생성자에 .docx 파일을 지정하면 동일한 글꼴 제외 로직이 적용됩니다.

Q7: 모바일 디바이스용 HTML 렌더링 최적화를 어떻게 더 할 수 있나요?
A7: 생성된 HTML을 압축하고 임베디드 리소스와 함께 반응형 CSS를 제공하는 것을 고려하세요.

Q8: 개발 빌드에 라이선스가 필수인가요?
A8: 개발 및 테스트에는 무료 체험으로 충분하지만, 프로덕션 배포에는 상용 라이선스가 필요합니다.

리소스

문서: GroupDocs Viewer Java 문서
API 레퍼런스: GroupDocs Viewer Java API
GroupDocs.Viewer 다운로드: GroupDocs 다운로드 페이지
라이선스 구매: GroupDocs 라이선스 구매
무료 체험 및 임시 라이선스: 무료 체험 시작 | 임시 라이선스 요청
지원: 추가 도움이 필요하면 GroupDocs 지원 페이지를 방문하세요.

Last Updated: 2026-01-28
Tested With: GroupDocs.Viewer for Java 25.2
Author: GroupDocs