rhwp — HWP 문서 뷰어 & 에디터 (Firefox 확장)

브라우저에서 HWP/HWPX 파일을 바로 열고 편집할 수 있는 확장 프로그램입니다.

특징

• 설치 없이 열기 — 확장 설치 한 번이면 HWP 파일을 브라우저에서 바로 열람
• 편집 지원 — 텍스트 입력/수정, 표 편집, 서식 변경
• 인쇄 — Ctrl+P로 인쇄, PDF 저장 가능
• 자동 감지 — 웹페이지의 HWP 링크를 자동 감지하고 아이콘 표시
• 개인정보 보호 — 파일이 서버로 전송되지 않음, 모든 처리는 브라우저 내 WASM
• 무료 — MIT 라이선스, 개인/기업 무료
• 광고 없음

설치

• Firefox Add-ons (AMO) (준비 중)

사용 방법

HWP 파일 열기

1. 웹 다운로드: HWP 파일 다운로드 시 자동으로 뷰어 탭에서 열림
2. 드래그 & 드롭: 확장 아이콘 클릭 → 빈 뷰어 탭 → 파일 드래그
3. 우클릭 메뉴: HWP 링크 우클릭 → "rhwp로 열기"
4. 배지 클릭: 웹페이지의 HWP 링크 옆 파란색 H 배지 클릭

인쇄

• 파일 메뉴 → 인쇄 또는 Ctrl+P
• 인쇄 미리보기 창에서 [인쇄] 버튼 클릭

저장

• Ctrl+S 또는 파일 메뉴 → 저장
• HWP 형식으로 저장

웹사이트 개발자

공공 웹사이트에 data-hwp-* 속성을 추가하면 사용자 경험이 향상됩니다. 자세한 내용은 개발자 가이드를 참조하세요.

<a href="/files/공문.hwp" data-hwp="true" data-hwp-title="공문" data-hwp-pages="5">
  공문.hwp
</a>

빌드

cd rhwp-firefox
npm install
npm run build

빌드 결과물은 dist/ 폴더에 생성됩니다.

개발 모드 설치

1. Firefox 주소창에 about:debugging#/runtime/this-firefox 입력
2. "임시 부가 기능 로드..." 클릭
3. rhwp-firefox/dist/manifest.json 선택

Chrome 확장과의 차이

이 확장은 rhwp-chrome을 기반으로 Firefox WebExtensions API에 맞게 포팅하였습니다.

주요 차이점:

• manifest.json: service_worker → background.scripts (Firefox MV3 규격)
• background.js: browser.* 네임스페이스 사용 (Firefox 네이티브 Promise API)
• sw/download-interceptor.js: onDeterminingFilename → onCreated (Firefox 호환)

변경 이력

v0.2.2 (2026-04-26)

보안·품질 개선

• AMO 검증 워닝 해소 + 보안 강화 (외부 기여 by @postmelee — PR #339)
  • manifest.json 의 strict_min_version 을 142.0 으로 상향 (data_collection_permissions 호환)
  • 인쇄 팝업 경로의 document.write 를 DOM API 기반으로 변경
  • 메뉴/오버레이/대화상자 경로의 innerHTML 사용을 DOM API · textContent · replaceChildren() · SVG DOM 생성 방식으로 변경
  • 빌드 시 stale artifact 가 dist 에 섞이지 않도록 정리 단계 보강
• 목차 리더 도트 + 페이지번호 우측 탭 정렬 (외부 기여 by @seanshin — PR #282)
  • fill_type=3 점선 리더를 round cap 원형 점으로 표현 (한컴 동등)
  • 들여쓰기 문단의 페이지번호 정렬 보정

기여자 감사 이번 배포 주기에 기여해주신 분들: @postmelee, @seanshin

v0.2.1 (이전)

• AMO 등록 준비 (rhwp-firefox 첫 공개 빌드)

라이선스

MIT License — Copyright (c) 2026 Edward Kim

개인정보 처리방침

PRIVACY.md 참조