[Code 개선] #30. [Functional] PDF 변환 시 한글 폰트 임베딩 및 스타일 완성도 향상 #4

New Issue

Kyeongmin · 2026-03-05T11:33:08+09:00

Kyeongmin commented

2026-03-05 11:33:08 +09:00

1. 목표

서버에서 PDF를 생성할 때 한글 폰트가 누락되거나 기본 폰트로 대체되어 디자인이 무너지는 문제를 해결하고, 출력용 전역 스타일을 정립합니다.

2. 상세 원인 및 배경

리눅스 서버 환경에는 기본적으로 한글 폰트가 설치되어 있지 않은 경우가 많아 WeasyPrint 등으로 PDF 변환 시 글자가 깨집니다.
또한 화면용 CSS와 출력용 CSS가 분리되어 있지 않으면 PDF 레이아웃이 화면과 다르게 나올 수 있습니다.

3. 주요 수정 파일 및 범위

geulbeot_10th/static/css/pdf_print.css: PDF 전용 스타일 (신규 생성)
geulbeot_10th/app.py: PDF 변환 시 폰트 경로 주입 로직
geulbeot_10th/assets/fonts/: 폰트 파일 저장소 (신규 생성)

Original: Kyeongmin/test#60

### 1. 목표 서버에서 PDF를 생성할 때 한글 폰트가 누락되거나 기본 폰트로 대체되어 디자인이 무너지는 문제를 해결하고, 출력용 전역 스타일을 정립합니다. ### 2. 상세 원인 및 배경 - 리눅스 서버 환경에는 기본적으로 한글 폰트가 설치되어 있지 않은 경우가 많아 `WeasyPrint` 등으로 PDF 변환 시 글자가 깨집니다. - 또한 화면용 CSS와 출력용 CSS가 분리되어 있지 않으면 PDF 레이아웃이 화면과 다르게 나올 수 있습니다. ### 3. 주요 수정 파일 및 범위 - `geulbeot_10th/static/css/pdf_print.css`: PDF 전용 스타일 (신규 생성) - `geulbeot_10th/app.py`: PDF 변환 시 폰트 경로 주입 로직 - `geulbeot_10th/assets/fonts/`: 폰트 파일 저장소 (신규 생성) --- *Original: Kyeongmin/test#60*

Kyeongmin referenced this issue

2026-03-05 11:56:39 +09:00

[Code 개선] #4. [Security] 안전한 파일 업로드 핸들링 및 한국어 파일명 보존 로직 구현 #42

Kyeongmin added this to the [Code 개선] 필요 시 나중에 진행 milestone 2026-03-05 12:30:09 +09:00

Kyeongmin referenced this issue

2026-03-05 12:57:28 +09:00

[문서 작성] #4. 목차 수정 및 웹 편집기 #50

Sign in to join this conversation.