docs: Ubuntu PPT 슬라이드 한글 폰트(□) 트러블슈팅 안내
Made-with: Cursor
This commit is contained in:
@@ -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` 예시
|
||||
|
||||
|
||||
Reference in New Issue
Block a user