HWPX Converter Setup

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

설치 대상

워크플로우

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: 사용법 출력

에러 처리

수동 설치 링크

자동 설치 실패 시:

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

주의사항

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