setup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HWPX Converter Setup

HWPX Converter 安装配置

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

自动安装使用hwpx-converter所需的依赖。

설치 대상

安装对象

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

程序	用途	安装方式
Pandoc	文档转换引擎	winget (Windows) / brew (macOS) / apt (Linux)
Python	运行环境	winget (Windows) / brew (macOS) / apt (Linux)
pypandoc-hwpx	HWPX转换工具	pip install

워크플로우

工作流程

Phase 1: 환경 감지

阶段1：环境检测

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

bash

undefined

检测操作系统以选择合适的安装命令。

bash

undefined

Windows 감지

Windows 检测

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

undefined

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

undefined

Phase 2: Pandoc 설치 확인 및 설치

阶段2：Pandoc 安装检查及安装

Step 2-1. 설치 확인

bash

pandoc --version

Step 2-2. 미설치 시 설치

Windows (PowerShell):

powershell

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

macOS:

bash

brew install pandoc

Linux (Ubuntu/Debian):

bash

sudo apt update && sudo apt install -y pandoc

步骤2-1. 安装检查

bash

pandoc --version

步骤2-2. 未安装时进行安装

Windows (PowerShell):

powershell

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

macOS:

bash

brew install pandoc

Linux (Ubuntu/Debian):

bash

sudo apt update && sudo apt install -y pandoc

Phase 3: Python 설치 확인 및 설치

阶段3：Python 安装检查及安装

Step 3-1. 설치 확인

bash

python --version || python3 --version

Step 3-2. 미설치 시 설치

Windows (PowerShell):

powershell

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

macOS:

bash

brew install python

Linux (Ubuntu/Debian):

bash

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

步骤3-1. 安装检查

bash

python --version || python3 --version

步骤3-2. 未安装时进行安装

Windows (PowerShell):

powershell

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

macOS:

bash

brew install python

Linux (Ubuntu/Debian):

bash

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

Phase 4: pypandoc-hwpx 설치

阶段4：pypandoc-hwpx 安装

bash

pip install pypandoc-hwpx

bash

pip install pypandoc-hwpx

또는

或

python -m pip install pypandoc-hwpx

또는

或

python3 -m pip install pypandoc-hwpx

undefined

python3 -m pip install pypandoc-hwpx

undefined

Phase 5: 설치 검증

阶段5：安装验证

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

bash

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

성공 기준:

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

所有安装完成后进行验证：

bash

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

成功标准:

pandoc：输出版本信息
python：输出版本信息
pypandoc-hwpx：输出使用方法

에러 처리

错误处理

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

情况	处理方式
Windows未安装winget	提供手动安装链接
macOS未安装brew	指导brew安装命令
需要管理员权限	指导使用sudo或手动安装
PATH未注册	指导重启终端

수동 설치 링크

手动安装链接

자동 설치 실패 시:

Pandoc: https://pandoc.org/installing.html
Python: https://python.org/downloads/
pypandoc-hwpx:
```
pip install 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" 옵션 체크 권장

Windows安装后需重启终端（以反映PATH设置）
部分系统需要管理员权限
Python安装时建议勾选**"Add to PATH"选项**