리눅스 Docker 컨테이너에서 IronPDF로 사용자 지정 글꼴 내장

This article was translated from English: Does it need improvement?
Translated
View the article in English

Windows에서 PDF를 생성할 때 사용자 지정 글꼴이 제대로 내장되지만 Linux Docker 컨테이너 내에서는 내장이 실패합니다. 의도한 글꼴 대신 렌더러는 대체 글꼴로 DejaVu Sans를 사용합니다.

Linux 시스템 및 Docker 컨테이너 내에서는 글꼴을 명시적으로 설치하거나 참조해야 합니다. Chrome 렌더링 엔진에서 글꼴을 사용할 수 없는 경우, IronPDF는 시스템의 기본 대체 글꼴을 대체하여 시각적 차이와 내장 실패를 초래합니다.

해결책

옵션 1: Arial 및 유사한 글꼴을 위한 Microsoft 핵심 글꼴 설치

Dockerfile에 추가하십시오:

RUN apt update && apt install -y ttf-mscorefonts-installer

옵션 2: @font-face로 사용자 지정 글꼴 내장

Poppins 또는 Roboto와 같은 비시스템 글꼴의 경우 Docker 이미지 내부에 번들로 제공되는 .ttf 파일에 대한 경로와 함께 HTML에서 @font-face을 사용하여 선언하세요:

<!DOCTYPE html>
<html>
<head>
<style>
@font-face {
    font-family: 'Poppins';
    src: url('fonts/Poppins-Regular.ttf');
}
p {
    font-family: 'Poppins';
    font-size: 16px;
}
</style>
</head>
<body>
<p>Custom font text</p>
</body>
</html>
<!DOCTYPE html>
<html>
<head>
<style>
@font-face {
    font-family: 'Poppins';
    src: url('fonts/Poppins-Regular.ttf');
}
p {
    font-family: 'Poppins';
    font-size: 16px;
}
</style>
</head>
<body>
<p>Custom font text</p>
</body>
</html>
HTML

옵션 3: 인쇄 CSS 미디어 유형 사용

인쇄에 특화된 스타일을 적용하기 위해 CssMediaType을 설정하고, @font-face 선언을 포함하세요:

renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
$vbLabelText   $csharpLabel

전체 Linux Docker 설정은 IronPDF Docker 가이드를 참조하십시오.

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 20,088,359 | 버전: 2026.7 방금 출시
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronPdf
샘플을 실행하세요 HTML이 PDF로 변환되는 것을 지켜보세요.