Skip to content
BranchesTags

Repository files navigation

RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리

Node.jspnpmLicense: MITCI

Re-imagined ePub. AI가 다시 짓는 전자책.

구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.

📦 구성

repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능

기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)

🚀 빠른 시작

요구사항

  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)

설치 및 빌드

git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build

CLI 사용

# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json

라이브러리로 사용

import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);

🧪 Mock 모드

API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.

API 키를 설정하려면 .env 파일에 추가:

  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)

🧰 Sigil 플러그인 사용

packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.

🛠 개발

pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제

📚 문서

🌐 라이브 데모 / 서비스

본 라이브러리를 활용한 SaaS 서비스 (별도 운영):

🏛 사업 배경

본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.

📜 라이선스

MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)

🤝 기여

CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.

About

RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)

gov-epub-2026-three.vercel.app

Topics

accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript

Resources

Readme
MIT license

Contributing

Contributing
Activity
Custom properties

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();
GitHub - hayanmind/repub: RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인) · GitHub
Skip to content
BranchesTags
Repository files navigation
RePub — AI 기반 ePub 2.0 → 3.0 리마스터링 라이브러리
Node.jspnpmLicense: MITCI
Re-imagined ePub. AI가 다시 짓는 전자책.
구형 ePub 2.0 전자책을 최신 국제표준 ePub 3.0 인터랙티브 콘텐츠로 자동 변환하는 오픈소스 라이브러리입니다. 라이브러리(@gov-epub/core)와 Sigil 편집기 플러그인(ePubRemaster)으로 구성됩니다.
📦 구성
repub/
├── packages/
│ ├── core/ # ePub 2.0 → 3.0 변환 엔진 + CLI (epub-remaster)
│ └── sigil-plugin/ # Sigil 편집기 Python 플러그인 (ePubRemaster)
├── fixtures/ # 테스트용 ePub 샘플 (3종 자체 + 4종 공개 도메인)
├── docs/ # 기술 문서
│ ├── README.md # 라이브러리 사용 가이드
│ ├── API.md # 프로그래매틱 API 명세
│ ├── ARCHITECTURE.md # 아키텍처 설계 문서
│ ├── FAQ.md # 자주 묻는 질문
│ └── SIGIL-INTEGRATION.md # Sigil 플러그인 연동 분석
├── CLAUDE.md # 개발 가이드라인
├── CONTRIBUTING.md # 기여 가이드
└── LICENSE # MIT

✨ 주요 기능
기능설명
ePub 2.0 자동 파싱OPF/NCX/XHTML 구조 분석, 메타데이터 추출, 인코딩 자동 복구, 10종 핵심 오류 패턴 자동 검출
AI 콘텐츠 재구성시맨틱 태그(h1~h6, figcaption, blockquote 등) 자동 부여, 스타일 매핑, 불필요 태그 정리
인터랙티브 요소퀴즈 자동 생성, TTS 음성 변환, SMIL 미디어 오버레이 자동 싱크, 용어 팝업, AI 이미지 추천, AI 튜터
ePub 3.0 변환HTML5/CSS3/JS 기반 자동 패키징, ePubCheck 자동 검증
접근성 자동 적용KWCAG 2.1 AA, EPUB Accessibility 1.1, 이미지 alt 텍스트 자동 생성, 읽기 순서 최적화
Sigil 플러그인출판사 편집자가 기존 워크플로우 유지하며 변환 가능 (API/Local 듀얼 모드)
🚀 빠른 시작
요구사항
  • Node.js 20 이상
  • pnpm 9 이상 (npm install -g pnpm)
설치 및 빌드
git clone https://github.com/hayanmind/repub.git
cd repub
pnpm install
pnpm build
CLI 사용
# 변환
npx @gov-epub/core convert input.epub -o output.epub
# 검증만
npx @gov-epub/core validate input.epub
# 메타데이터만 출력
npx @gov-epub/core info input.epub --format json
라이브러리로 사용
import{processEpub}from'@gov-epub/core';constresult=awaitprocessEpub('./input.epub',{output: './output.epub',enableQuiz: true,enableTTS: true,enableAccessibility: true,});console.log(`변환 성공: ${result.success}`);console.log(`ePubCheck 통과: ${result.report.epubcheck.passed}`);
🧪 Mock 모드
API 키 없이도 전체 기능을 테스트할 수 있습니다. 환경 변수에 API 키가 없으면 자동으로 Mock 모드로 동작하여 데모용 결과를 생성합니다.
API 키를 설정하려면 .env 파일에 추가:
  • GEMINI_API_KEY (메인 LLM, 권장)
  • OPENAI_API_KEY, ANTHROPIC_API_KEY (선택 LLM)
  • ELEVENLABS_API_KEY (TTS, 선택)
  • STABILITY_API_KEY (이미지 생성, 선택)
🧰 Sigil 플러그인 사용
packages/sigil-plugin/ 디렉토리의 ePubRemaster_v1.0.0.zip을 Sigil 편집기에 import하면 됩니다. 자세한 설치 가이드는 packages/sigil-plugin/README.md 참조.
🛠 개발
pnpm install # 의존성 설치
pnpm build # 모든 패키지 빌드
pnpm test# 단위·통합 테스트 (60+ 케이스)
pnpm lint # 린트
pnpm clean # 빌드 산출물 삭제
📚 문서
🌐 라이브 데모 / 서비스
본 라이브러리를 활용한 SaaS 서비스 (별도 운영):
🏛 사업 배경
본 프로젝트는 2025년 한국출판문화산업진흥원 출판콘텐츠 기술개발 지원 사업의 결과물로, (주)하얀마인드가 단독 주관 개발하였습니다. 사업 종료 후 핵심 모듈을 MIT 오픈소스로 공개합니다.
📜 라이선스
MIT License © 2025-2026 ㈜하얀마인드 (Hayanmind Inc.)
🤝 기여
CONTRIBUTING.md를 참조하세요. 이슈와 PR을 환영합니다.
About
RePub — ePub 리마스터링 자동화 툴체인 (검수·KPI·카드뉴스/영상/내레이션 파이프라인)
gov-epub-2026-three.vercel.app
Topics
accessibilityaiepubepub3koreannextjsopen-sourcepublishingremasteringtypescript
Resources
Readme
MIT license
Contributing
Contributing
Activity
Custom properties
Stars
1 star
Watchers
0 watching
Forks
0 forks
Report repository
Releases
Packages
Used by
Contributors
Languages