HWPX Converter Setup

hwpx-converter 스킬 사용을 위한 의존성을 자동으로 설치합니다.

---

설치 대상

프로그램	용도	설치 방법
Pandoc	문서 변환 엔진	winget (Windows) / brew (macOS) / apt (Linux)
Python	실행 환경	winget (Windows) / brew (macOS) / apt (Linux)
pypandoc-hwpx	HWPX 변환 도구	pip install

---

워크플로우

Phase 1: 환경 감지

운영체제를 감지하여 적절한 설치 명령을 선택합니다.

# Windows 감지
uname -s 2>/dev/null || echo "Windows"

Phase 2: Pandoc 설치 확인 및 설치

Step 2-1. 설치 확인

pandoc --version

Step 2-2. 미설치 시 설치

Windows (PowerShell):

winget install --id JohnMacFarlane.Pandoc --accept-source-agreements --accept-package-agreements

macOS:

brew install pandoc

Linux (Ubuntu/Debian):

sudo apt update && sudo apt install -y pandoc

Phase 3: Python 설치 확인 및 설치

Step 3-1. 설치 확인

python --version || python3 --version

Step 3-2. 미설치 시 설치

Windows (PowerShell):

winget install --id Python.Python.3.12 --accept-source-agreements --accept-package-agreements

macOS:

brew install python

Linux (Ubuntu/Debian):

sudo apt update && sudo apt install -y python3 python3-pip

Phase 4: pypandoc-hwpx 설치

pip install pypandoc-hwpx
# 또는
python -m pip install pypandoc-hwpx
# 또는
python3 -m pip install pypandoc-hwpx

Phase 5: 설치 검증

모든 설치가 완료되면 검증합니다:

pandoc --version
python --version
pypandoc-hwpx --help

성공 기준:

• pandoc: 버전 정보 출력
• python: 버전 정보 출력
• pypandoc-hwpx: 사용법 출력

---

에러 처리

상황	처리
winget 미설치 (Windows)	수동 설치 링크 제공
brew 미설치 (macOS)	brew 설치 명령 안내
관리자 권한 필요	sudo 사용 또는 수동 설치 안내
PATH 미등록	터미널 재시작 안내

---

수동 설치 링크

자동 설치 실패 시:

• Pandoc: https://pandoc.org/installing.html
• Python: https://python.org/downloads/
• pypandoc-hwpx: pip install pypandoc-hwpx

---

주의사항

• Windows에서 설치 후 터미널 재시작 필요 (PATH 반영)
• 일부 시스템에서 관리자 권한 필요
• Python 설치 시 "Add to PATH" 옵션 체크 권장