gongnyang/bookforge

해결하는 문제

Bookforge는 마크다운 콘텐츠에서 전문적이고 상업용 수준의 전자책 PDF를 자동으로 생성하기 위한 에이전트형 기술입니다. 수작업 조판 및 레이아웃 설계 과정을 제거하고, 스타일 팩, 자동 빌드 스크립트, 그리고 저품질 또는 잘못 포맷된 문서가 최종화되는 것을 방지하는 엄격한 품질 관리(QC) 게이트 시스템을 제공합니다.

작동 방식

이 프로젝트는 렌더링 엔진(Typst 및 Chromium/HTML)과 미리 정의된 스타일 팩(예: 실용적, 통찰, 학술, 에세이, 비즈니스, 잡지)의 조합을 사용하여 마크다운을 PDF로 변환합니다.

주요 구성 요소:

• 스타일 팩: 각 팩은 특정 레이아웃 룰북, 폰트 설정, 색상 토큰을 포함하여 일관된 전문적인 외관을 보장합니다.
• 다이어그램 트랙: AntV 인포그래픽 DSL(서버사이드 렌더링을 위한 커밋된 벤더 번들로 렌더링)과 저자 작성 SVG를 지원하며, 폰트 크기와 색상 팔레트에 대해 정규화 및 검증됩니다.
• 목차 시스템: 책마다 조정 가능한 6가지 다른 레이아웃을 갖춘 유연한 목차 시스템입니다.
• QC 게이트: 폰트 임베딩(Type3 글리프), 페이지 기하학(오버플로우, 충돌), 콘텐츠 밀도, WCAG 색상 대비 등 모든 항목을 검사하는 17개의 기계적 게이트(G0-G17) 시스템입니다.
• 변이 테스트 세트: 책에 결함을 주입하는 테스트 프레임워크로, QC 게이트가 오류를 올바르게 탐지하고 거짓 긍정을 일으키지 않도록 보장합니다.

대상 사용자

이 도구는 AI 에이전트(특히 Claude Code 및 OpenAI Codex)와 전문적인 조판 소프트웨어나 수작업 레이아웃 조정 없이 고품질의 인쇄용 디지털 책을 생성하고자 하는 개발자에게 적합합니다.

주요 특징

• 상업용 수준의 레이아웃: 실제 상업 출판 측정 기준에 기반한 6가지 독특한 스타일.
• 엄격한 품질 관리: 레이아웃 또는 접근성 오류가 발견되면 최종 PDF 생성을 차단하는 17개의 자동 게이트.
• 통합 다이어그램 기능: AntV 및 사용자 정의 SVG 다이어그램에 대한 네이티브 지원과 자동 정규화.
• 프로페셔널 수준의 PDF 출력: 전용 변이 테스트 세트를 통해 품질 검사의 회귀를 방지합니다.
• 에이전트 워크플로우: "주제 모드"(연구에서 출판까지)와 "원고 모드"(기존 드래프트 수신)를 모두 지원합니다.