57 lines
2.9 KiB
Markdown
57 lines
2.9 KiB
Markdown
# html-to-image (v0.1.0)
|
|
|
|
**html-to-image**는 웹 에디터(TinyMCE)에서 작성한 풍부한 HTML 콘텐츠를 고해상도 이미지, PDF 또는 자급자족형(Self-contained) HTML 파일로 변환해주는 Electron 기반 데스크탑 애플리케이션입니다.
|
|
|
|
폐쇄망 환경에서도 안정적으로 동작하도록 설계되었으며, 전문가 수준의 정밀한 레이아웃 제어 기능을 제공합니다.
|
|
|
|
## ✨ 주요 기능 (Key Features)
|
|
|
|
### 📸 강력한 내보내기 (Export)
|
|
- **다양한 포맷 지원**: PNG, JPEG, WEBP, PDF, HTML 저장.
|
|
- **이미지 내장 HTML**: 모든 이미지가 Data URI로 포함된 단일 HTML 파일을 생성하여 오프라인에서도 모든 이미지와 스타일이 유지됩니다.
|
|
- **웹 최적화**: 고품질 압축 알고리즘을 통해 용량과 화질의 최적의 균형을 제공합니다.
|
|
|
|
### 📐 정밀 레이아웃 제어 (Layout Control)
|
|
- **너비 분리 설정**: 인쇄용 전체 너비(Print Width)와 실제 텍스트가 담길 본문 너비(Content Width)를 각각 지정할 수 있습니다.
|
|
- **가로 맞춤 (Fit-to-Width)**: 본문의 레이아웃 비율을 유지하면서 인쇄 너비에 맞춰 고해상도로 자동 확대합니다.
|
|
- **줄 간격 조절**: 100% ~ 250% 범위에서 정밀한 행간 조정이 가능합니다.
|
|
- **여백 조절**: 상하좌우 여백을 픽셀 단위로 세밀하게 조정할 수 있습니다.
|
|
|
|
### ✍️ 향상된 에디터 환경
|
|
- **TinyMCE 기반**: 강력한 표(Table) 편집 기능과 MS Word 문서와의 높은 호환성을 제공합니다.
|
|
- **IME 최적화**: 한글 입력 시 끊김이나 딜레이가 없는 안정적인 입력을 보장합니다.
|
|
- **로컬 폰트 내장**: 바탕(Batang), Noto Sans KR 등 주요 폰트가 내장되어 있어 오프라인 환경에서도 일관된 렌더링을 제공합니다.
|
|
|
|
### 💻 데스크탑 경험
|
|
- **설정 자동 유지**: 창 크기, 위치 및 레이아웃 옵션이 자동으로 저장되어 재실행 시 복원됩니다.
|
|
- **실시간 미리보기**: 저장 전 미리보기 모달을 통해 결과물을 확인하고 확대/축소할 수 있습니다.
|
|
- **폐쇄망 지원**: 모든 라이브러리 및 에셋이 로컬에 포함되어 인터넷 연결 없이도 완벽하게 동작합니다.
|
|
|
|
## 🚀 시작하기 (Getting Started)
|
|
|
|
### 개발 환경 (Development)
|
|
```bash
|
|
# 의존성 설치
|
|
npm install
|
|
|
|
# 개발 모드 실행
|
|
npm run electron:dev
|
|
```
|
|
|
|
### 빌드 (Build)
|
|
```bash
|
|
# 프로덕션 빌드 (Setup 및 Portable 버전 생성)
|
|
npm run electron:build
|
|
```
|
|
빌드된 파일은 `dist/` 디렉토리에 생성됩니다.
|
|
|
|
## 🛠 기술 스택 (Tech Stack)
|
|
- **Electron**: 데스크탑 앱 프레임워크
|
|
- **Vite + React**: 빠른 프론트엔드 개발 및 번들링
|
|
- **TinyMCE**: 리치 텍스트 에디터
|
|
- **html-to-image**: HTML DOM을 이미지로 변환
|
|
- **jsPDF**: PDF 생성 지원
|
|
|
|
---
|
|
Developed by Rinjae & Antigravity (Advanced Agentic Coding)
|