docs: Ubuntu PPT 슬라이드 한글 폰트(□) 트러블슈팅 안내

Made-with: Cursor
This commit is contained in:
2026-04-18 08:23:14 +09:00
parent e063bcd732
commit 858ab71fce

View File

@@ -200,6 +200,7 @@ PPT 썸네일·슬라이드 이미지는 **macOS**에서는 `qlmanage`가 우선
- **Node.js**: 배포판 기본 패키지가 오래된 경우가 많으므로 **[NodeSource](https://github.com/nodesource/distributions)** 또는 **nvm**으로 **v18+** 설치를 권장합니다.
- **PostgreSQL 클라이언트/서버**: 원격 DB만 쓰면 클라이언트 라이브러리만으로도 되고, 로컬 DB면 `postgresql` 패키지 설치 후 DB·사용자 생성.
- **PPT 변환(선택)**: `sudo apt install -y libreoffice poppler-utils`
- **PPT 슬라이드 이미지 한글(□·토푸)**: 변환은 서버에서 이루어지므로 **한글 글꼴**이 없으면 PNG에만 한글이 깨집니다(HTML UI 한글은 정상일 수 있음). 예: `sudo apt install -y fonts-nanum fonts-noto-cjk`, 이후 `sudo fc-cache -fv` 로 fontconfig 갱신 → 관리자 화면에서 해당 강의 **슬라이드 이미지 재생성**.
2. **코드 배치**
```bash
@@ -427,7 +428,8 @@ ENABLE_PPT_THUMBNAIL=1 npm start
**PPT 슬라이드 이미지(뷰어용):** PPTX 파일은 LibreOffice로 PDF 변환 후 `pdftoppm`으로 이미지 생성.
- **PPTX**: LibreOffice 필수. macOS: `brew install --cask libreoffice`
- **PDF**: `pdftoppm`만 있으면 동작 (poppler 패키지)
- **PDF**: `pdftoppm`만 있으면 동작 (poppler 패키지)
- **한글 깨짐(이미지 안만 □)**: 서버에 PPT가 쓰는 글꼴·한글 폰트가 없을 때 발생. Linux: `fonts-nanum`, `fonts-noto-cjk` 등 설치 후 `fc-cache -fv`, 슬라이드 이미지 재생성.
### `.env` 예시