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 미등록 터미널 재시작 안내
수동 설치 링크
자동 설치 실패 시:
-
Python: https://python.org/downloads/
-
pypandoc-hwpx: pip install pypandoc-hwpx
주의사항
-
Windows에서 설치 후 터미널 재시작 필요 (PATH 반영)
-
일부 시스템에서 관리자 권한 필요
-
Python 설치 시 "Add to PATH" 옵션 체크 권장