2.9 KiB
2.9 KiB
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)
# 의존성 설치
npm install
# 개발 모드 실행
npm run electron:dev
빌드 (Build)
# 프로덕션 빌드 (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)