DETOX ENGLISHMagic Read AI 웹 매뉴얼
교재 PDF실습 키트

CHAPTER 03

사진과 PDF가 넘기는 책으로

이 챕터가 끝나면 PDF나 책 사진을 올렸을 때 글자가 내 화면 크기에 맞는 쪽으로 다시 짜이고, 모서리를 끌면 종이처럼 넘어가는 화면이 생깁니다. 다음 챕터의 형광펜과 옵션 바가 모두 이 화면 위에서 동작합니다.

올린 파일이 넘기는 책이 되기까지

  1. 01올리기PDF 또는 폰으로 찍은 책 사진
  2. 02글자 꺼내기PDF는 글자를 그대로, 사진은 글자 인식
  3. 03문단으로 다시 잇기줄바꿈, 줄 끝 하이픈, 쪽 번호 정리
  4. 04내 화면에 맞게 쪽 나누기실제로 그려 보고 넘치면 다음 쪽으로
  5. 05넘기는 책모서리 끌기, 화살표, 키보드

1. 앱 뼈대 만들기

키트의 CLAUDE.md에 쓸 부품이 이미 정해져 있어서, Claude에게는 뼈대를 만들라고만 하면 됩니다. 뼈대가 생기면 내 컴퓨터에서 앱이 뜨고, 화면 한구석에 서버 연결 상태가 보입니다.

Opus 5.5 권장앱 뼈대 만들기
CLAUDE.md와 DESIGN.md를 읽고 Magic Read AI의 뼈대를 만들어 줘.
- 첫 화면은 '내 서재': 올린 책이 카드로 보이고, 가운데에 '책 올리기' 버튼
- 서버에 /api/health를 만들고, 화면 오른쪽 아래에 서버 연결 상태를 작게 표시
- npm run dev 하나로 화면과 서버가 같이 뜨게
만들기 전에 계획을 5줄로 먼저 보여 줘. 다 만들면 브라우저로 열어서 스크린샷을 찍어 확인해 줘.

Claude가 계획을 보여 주면 읽어 보고 "좋아"라고 답하세요. 설치에 몇 분이 걸립니다. 다 되면 브라우저에서 http://localhost:5173(내 컴퓨터 안에서만 열리는 주소)을 엽니다.

2. PDF와 사진에서 글자 꺼내기

PDF에는 대부분 글자가 들어 있어서 그대로 꺼내면 됩니다. 사진은 그림이라 글자 인식(OCR)을 거쳐야 합니다. 오늘 앱은 무료 인식기(Tesseract.js)로 먼저 읽고, 결과가 이상한 쪽만 AI로 다시 읽습니다. 교재용 시험 사진으로 재 보니 무료 인식기가 한 쪽 294단어를 틀리지 않고 2초 만에 읽었습니다. 다만 가운데가 휘거나 빛이 반사된 실제 책 사진은 그보다 어려우니 AI 다시 읽기 버튼을 같이 둡니다.

Opus 5.5 권장글자 꺼내기
'책 올리기'를 만들어 줘.
- PDF: pdfjs-dist로 글자를 꺼낸다. 줄을 이어 문단으로 합치고, 줄 끝 하이픈을 붙이고, 머리말과 쪽 번호는 뺀다. 글자가 없는 스캔 PDF는 사진처럼 글자 인식으로 보낸다.
- 사진: 폰에서는 카메라로 바로 찍을 수 있게. tesseract.js(영어)로 먼저 읽는다.
- 올린 뒤 '글자 확인' 화면: 왼쪽에 원본, 오른쪽에 꺼낸 글자. 쪽마다 'AI로 다시 읽기' 버튼(서버 /api/ocr, Claude Haiku 5.5 이미지 읽기, 사진은 긴 변 1600px로 줄여서 보내기).
- 원본 파일도 같이 저장하고, 책은 IndexedDB에 저장한다.
samples 폴더의 PDF와 사진으로 시험해 보고 결과를 보여 줘.

3. 내 화면에 맞게 쪽 나누기

종이책은 쪽이 정해져 있지만, 이 앱은 노트북, 아이패드, 폰마다 화면 크기가 다르고 글씨 크기도 바꿀 수 있습니다. 그래서 쪽을 미리 정하지 않고, 지금 화면에 실제로 글자를 그려 보면서 넘치는 곳에서 다음 쪽으로 넘깁니다. 시제품을 만들 때 '한 쪽에 문단 두 개'처럼 개수로 나눴더니 긴 문단이 쪽 아래로 잘려 나갔습니다.

Sonnet 5.5 권장쪽 나누기
책 글자를 지금 화면 크기에 맞는 쪽으로 나눠 줘.
- 쪽은 실제로 그려 보고 넘치면 다음 쪽으로. 문단 중간에서도 나눌 수 있게.
- 화면 크기나 글씨 크기를 바꾸면 다시 나누고, 읽던 문장이 있는 쪽을 그대로 보여 준다.
- 나중에 단어를 누를 수 있게 단어와 문장을 각각 표시해 둔다. 따옴표, 아포스트로피 같은 특수문자가 깨지지 않게 조심한다.
- 넓은 화면은 두 쪽 펼침, 좁은 화면은 한 쪽.

4. 종이책처럼 넘기기

넘김 라이브러리를 고른 이유

쪽 넘김은 처음부터 만들지 않고, 이미 만들어진 부품(라이브러리)을 씁니다. 여러 후보를 챕터 1의 기준으로 비교한 결과입니다.

후보상태고른 이유와 빼 둔 이유
page-flip (StPageFlip)별 900여 개, 한 주 내려받기 약 20만 번, 마지막 새 버전 2021년가장 많이 쓰여서 문제와 해결법이 많이 알려져 있습니다. 대신 관리가 멈췄으니 부족한 점(글자 선택 막힘)을 우리가 메웁니다
react-pageflipStPageFlip의 React 포장화면을 다시 그릴 때 설정이 굳는 문제가 알려져 있어 쓰지 않고, 작은 포장을 직접 만듭니다
turn.js오래된 인기 라이브러리원래 라이선스가 비상업용이라 수업에서 권하지 않습니다
2026년에 나온 새 후보들별 1~14개, 몇 주 된 프로젝트글자 선택, 손가락 따라 접히기 같은 좋은 기능이 있지만 아직 검증이 부족합니다. 집에서 지켜볼 목록에 둡니다
3D 책 (three.js)WebGL로 그리는 진짜 같은 책글자가 그림이 되어 단어를 고를 수 없습니다. 표지 연출에만 어울립니다

넘김 품질을 말로 주문하기

애니메이션은 "멋지게 넘겨 줘"라고만 하면 AI가 평범하게 만듭니다. 종이책이 넘어갈 때 눈에 들어오는 것을 하나씩 말로 정해 주면 결과가 확 달라집니다.

확인할 것주문하는 말
손을 따라오는가바깥쪽 모서리를 잡으면 쪽이 손가락을 그대로 따라온다
놓았을 때책 가운데를 넘었거나 빠르게 튕겼으면 넘어가고, 아니면 제자리로 돌아온다
속도와 느낌0.35~0.6초, 끝에서 부드럽게 멈추는(ease-out) 움직임. 일정한 속도(linear) 금지
그림자접히는 선을 따라 부드러운 그림자, 아래 쪽에 드리운 그림자, 책 가운데의 옅은 그림자. 넘기는 정도에 따라 진해지고 옅어진다
책 두께쪽 가장자리가 얇게 겹쳐 보이고, 읽은 만큼 왼쪽이 두꺼워진다
부드러움아이패드에서도 1초에 60장. 움직이는 동안 글자가 번지지 않는다
배려기기에서 '동작 줄이기'를 켠 사람에게는 0.15초 겹쳐 바뀌기로
소리종이 소리는 기본으로 끄고, 설정에서 켤 수 있게
Opus 5.5 권장넘기는 책 만들기
쪽 넘김을 page-flip(StPageFlip 2.0.7) HTML 모드로 만들어 줘. react-pageflip은 쓰지 말고 작은 훅을 직접 만든다.
- 품질: 바깥쪽 가장자리 15%를 잡으면 쪽이 손가락을 1:1로 따라오고, 가운데를 넘었거나 빠르게 튕겼으면 넘어가고 아니면 돌아온다. 0.35~0.6초 ease-out. 접히는 선·아래 쪽·책 가운데 그림자가 넘기는 정도에 따라 변하고 가장 진할 때 불투명도 0.35. 쪽 가장자리가 얇게 겹쳐 보이고 읽은 만큼 왼쪽이 두꺼워진다.
- 성능과 배려: transform과 opacity만 움직이고 will-change는 넘기는 동안에만, 펼친 쪽 앞뒤 2장만 올려 아이패드에서도 60fps. prefers-reduced-motion이면 0.15초 겹쳐 바뀌기, 종이 소리는 기본 끔.
- 글자 선택과 함께: disableFlipByClick: true. 글자 문단에서 시작한 mousedown·touchstart·pointerdown은 stopPropagation()으로 라이브러리에 전달하지 않는다. 넘기기는 모서리 끌기, 양옆 화살표 버튼, 키보드 ←/→.
- 주의: 쪽 내용은 React 컴포넌트가 아니라 일반 HTML로 넘긴다(한 쪽 보기에서 쪽을 복제한다). PageFlip은 한 번만 만들고, 개발 모드에서 두 번 실행돼도 두 개가 생기지 않게 정리한다.
다 만들면 Playwright로 데스크톱·아이패드·폰 크기에서 넘기는 도중 화면을 찍어 품질 항목을 하나씩 확인해 줘.

5. 넘김을 눈으로 검사받기

애니메이션은 코드만 읽어서는 잘 됐는지 알 수 없습니다. Claude가 직접 화면을 찍어 보고 고치게 하면, 내가 매번 설명하지 않아도 품질이 올라갑니다.

Sonnet 5.5 권장넘김 품질 검사
넘기는 책을 Playwright로 검사해 줘. 데스크톱 1280×800, 아이패드 820×1180, 폰 390×844에서 각각 (1) 펼친 화면 (2) 반쯤 넘긴 순간 (3) 넘긴 뒤를 찍어 shots 폴더에 저장하고, 넘김 품질표(그림자, 속도, 두께, 글자 번짐, 한 쪽 보기)를 기준으로 부족한 점 세 가지를 고쳐 줘. 고친 전후 스크린샷을 나란히 보여 줘.

집에서 이어 하기

  • '원본 보기' 버튼: 지금 쪽의 원래 사진이나 PDF 쪽을 옆에 띄우기
  • 표지 연출: 서재에서 책을 열 때만 3D로 표지가 열리는 효과 (본문은 지금 방식 그대로)
  • 긴 책: 장(chapter) 단위로 나눠 불러오기. 수백 쪽을 한꺼번에 올리지 않습니다
  • 새 넘김 라이브러리 지켜보기: 2026년에 나온 후보들이 별과 사용자를 얻는지 몇 달 뒤 챕터 1의 기준으로 다시 비교