docs: 운영서버 LibreOffice 및 폰트 설치 가이드 추가
- LibreOffice 24.2.7 헤드리스 문서 변환 설정 - Pretendard (9 웨이트), Nanum, Noto CJK 폰트 설치 정보 - 폰트 관리 명령어 및 추가 절차 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -277,4 +277,63 @@ sudo ufw allow from IP주소 to any port 포트번호 # 규칙 추가
|
|||||||
sudo ufw delete 번호 # 규칙 삭제 (번호 기반)
|
sudo ufw delete 번호 # 규칙 삭제 (번호 기반)
|
||||||
sudo ufw disable # 비활성화 (비상시만)
|
sudo ufw disable # 비활성화 (비상시만)
|
||||||
sudo ufw enable # 활성화
|
sudo ufw enable # 활성화
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## LibreOffice (문서 변환)
|
||||||
|
|
||||||
|
API 서버에서 문서 변환(Excel→PDF 등)에 사용. 헤드리스 모드로 동작.
|
||||||
|
|
||||||
|
**버전:** 24.2.7.2 (개발/운영 동일)
|
||||||
|
|
||||||
|
**명령어:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
libreoffice --version # 버전 확인
|
||||||
|
libreoffice --headless --convert-to pdf input.xlsx # CLI 변환 테스트
|
||||||
|
```
|
||||||
|
|
||||||
|
**설치 패키지:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt-get install -y libreoffice-core libreoffice-writer libreoffice-calc libreoffice-impress
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 폰트
|
||||||
|
|
||||||
|
LibreOffice 문서 변환 시 폰트가 없으면 글자가 깨지므로 개발/운영 서버 동일하게 설치 필수.
|
||||||
|
|
||||||
|
**설치된 한글 폰트:**
|
||||||
|
|
||||||
|
| 폰트 | 설치 방식 | 경로 |
|
||||||
|
|------|----------|------|
|
||||||
|
| **Pretendard** (9 웨이트) | 수동 설치 (OTF) | `/usr/local/share/fonts/Pretendard-*.otf` |
|
||||||
|
| **Nanum** (고딕/명조/스퀘어/손글씨 등) | apt (`fonts-nanum`, `fonts-nanum-extra`) | `/usr/share/fonts/truetype/nanum/` |
|
||||||
|
| **Noto CJK** (Sans/Serif) | apt (`fonts-noto-cjk`) | `/usr/share/fonts/opentype/noto/` |
|
||||||
|
|
||||||
|
**폰트 관리 명령어:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
fc-list :lang=ko family | sort -u # 설치된 한글 폰트 목록
|
||||||
|
fc-list | grep -i pretendard # Pretendard 설치 확인
|
||||||
|
sudo fc-cache -fv # 폰트 캐시 갱신 (새 폰트 추가 후 필수)
|
||||||
|
```
|
||||||
|
|
||||||
|
**새 폰트 추가 시:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. OTF/TTF 파일을 /usr/local/share/fonts/ 에 복사
|
||||||
|
sudo cp *.otf /usr/local/share/fonts/
|
||||||
|
|
||||||
|
# 2. 폰트 캐시 갱신
|
||||||
|
sudo fc-cache -fv
|
||||||
|
|
||||||
|
# 3. 확인
|
||||||
|
fc-list | grep -i "폰트이름"
|
||||||
|
```
|
||||||
|
|
||||||
|
> **주의:** 개발서버에 폰트를 추가하면 운영서버에도 동일하게 설치해야 변환 결과가 일치한다.
|
||||||
```
|
```
|
||||||
Reference in New Issue
Block a user