LibreOffice 문서 도구셋

# LibreOffice 문서 도구셋

통합 LibreOffice 워크플로를 통해 Writer, Calc, Impress 문서를 생성, 편집 및 자동화합니다.

## 사전 요구사항

- **LibreOffice** 설치됨 (7.x 이상 권장)
- LibreOffice가 **侦听 모드**에서 실행 중이어야 UNO API에 접근할 수 있습니다:
  ```bash
  soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore
  ```
- **Python 3** 및 `uno` 모듈 (대부분의 시스템에서 LibreOffice와 번들 제공)
- 지원 플랫폼: Linux, macOS, Windows (세 플랫폼 모두 LibreOffice + UNO 사용 가능)

### 빠른 환경 확인

```bash
# LibreOffice 설치 확인
soffice --version

# 헤드리스侦听 시작 (백그라운드)
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &

# UNO 연결 확인
python3 -c "import uno; print('UNO available')"
```

`import uno`이 실패하면 Python 경로에 LibreOffice site-packages가 포함되어 있는지 확인하세요 (예: `/usr/lib/libreoffice/program/`).

## 이 플러그인의 기능

세 가지 핵심 LibreOffice 애플리케이션용 세 가지 스킬:

| 스킬 | 형식 | 기능 |
|-------|--------|-------------|
| **Writer** | .odt | 텍스트 삽입, 테이블, 이미지, 메타데이터, 단락 스타일 |
| **Calc** | .ods | 셀 작업, 수식, 서식, 차트, 이름 범위, 데이터 유효성 검사 |
| **Impress** | .odp | 슬라이드, 콘텐츠 배치, 테이블, 차트, 미디어, 노트, 마스터 페이지 |

## 전체 예시: 주간 보고서 파이프라인

팀에서 금요 보고서 워크플로를 자동화합니다 — 데이터를 스프레드시트로 수집하고, 서면 요약을 생성하며, 프레젠테이션 덱을 제작합니다.

### 1단계: Calc — 주간 지표 집계

```
새로운 Calc 스프레드시트 "weekly-metrics.ods"를 생성합니다.
시트 1 "Revenue": Date, Product, Units, Revenue 열과 월-금 샘플 데이터.
시트 2 "Summary": SUMIF 수식으로 제품별 수익을 합산합니다.
시트 2에 제품별 수익을 시각화하는 막대 차트를 추가합니다.
헤더 행을 파란색 배경의 굵은 글꼴로 서식을 지정합니다.
```

### 2단계: Writer — 서면 보고서 생성

```
Writer 문서 "weekly-report.odt"를 생성합니다.
제목: "Weekly Report — March 10, 2026"
섹션 1: 경영진 요약 (스프레드시트의 지표를 요약하는 2단락).
섹션 2: 주요 성과 (상위 3개 성과 글머리 기호 목록).
섹션 3: 다음 주 우선순위 (번호 매기기 목록).
스프레드시트의 요약 합계가 포함된 테이블을 삽입합니다.
글꼴을 Liberation Serif 12pt, 제목은 16pt 굵게 설정합니다.
```

### 3단계: Impress — 프레젠테이션 덱 구축

```
Impress 프레젠테이션 "weekly-deck.odp"를 생성합니다.
슬라이드 1: 제목 슬라이드 — "Weekly Review Q1 W10" 및 날짜 자막.
슬라이드 2: 지표 개요 — 제품별 수익이 포함된 테이블 삽입.
슬라이드 3: 주요 성과 — 상위 성과 글머리 기호.
슬라이드 4: 다음 단계 — 번호 매기기 우선순위.
슬라이드 5: 감사 슬라이드.
슬라이드 2-4에 발화 노트 추가.
```

**결과:** 세 가지 조정된 문서 (스프레드시트, 보고서, 덱)가 단일 워크플로에서 생성됨 — 수동 서식 지정이나 앱 간 복사-붙여넣기 불필요.

## 오류 처리 및 실패 복구

### LibreOffice가 실행 중이 아닌 경우

UNO 소켓 연결이 실패하면:
```
Error: could not connect to socket on localhost:2002
```
**해결책:** 헤드리스侦听 시작:
```bash
soffice --headless --accept="socket,host=localhost,port=2002;urp;" --norestore &
```

### UNO 모듈을 찾을 수 없는 경우

```
ModuleNotFoundError: No module named 'uno'
```
**해결책:** LibreOffice Python을 경로에 추가:
```bash
# Linux
export PYTHONPATH=/usr/lib/libreoffice/program:$PYTHONPATH

# macOS
export PYTHONPATH="/Applications/LibreOffice.app/Contents/Frameworks/:$PYTHONPATH"
```

### 템플릿 또는 파일을 찾을 수 없는 경우

템플릿 파일이 참조되었지만 누락된 경우, 스킬은 대신 새 빈 문서를 생성합니다. 템플릿 경로가 작업 디렉토리에 상대적이거나 절대 경로인지 확인하세요.

### 저장 시 권한 오류

출력 디렉터리에 쓰기 권한이 없으면 저장 작업이 실패합니다. 문서 생성 전에 쓰기 권한 확인:
```bash
test -w ./output/ || mkdir -p ./output/
```

### 동시 접근

LibreOffice UNO는 동시 연결을 잘 지원하지 않습니다. 여러 스크립트가 같은侦听을 동시에 사용하려고 하면 작업이 실패하거나 손상된 출력이 발생할 수 있습니다. 한 번에 하나씩 연결을 사용하거나 다른 포트에서 별도의 헤드리스 인스턴스를 시작하세요.