From 858ab71fce17680ab0ea062f6171a050faa9fb3b Mon Sep 17 00:00:00 2001 From: dsyoon Date: Sat, 18 Apr 2026 08:23:14 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20Ubuntu=20PPT=20=EC=8A=AC=EB=9D=BC?= =?UTF-8?q?=EC=9D=B4=EB=93=9C=20=ED=95=9C=EA=B8=80=20=ED=8F=B0=ED=8A=B8(?= =?UTF-8?q?=E2=96=A1)=20=ED=8A=B8=EB=9F=AC=EB=B8=94=EC=8A=88=ED=8C=85=20?= =?UTF-8?q?=EC=95=88=EB=82=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Made-with: Cursor --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index dab1e68..7020532 100644 --- a/README.md +++ b/README.md @@ -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` 예시