내 EPUB 고치기

고장 난 EPUB 고치는 방법

건강 검사가 살펴보는 것들

EPUB은 제 몸의 배관에 엄격한 규칙이 따르는 ZIP 아카이브이고, '열리지 않는' 사례는 대부분 텍스트가 손상된 것이 아니라 이 배관의 문제입니다. 진단은 이 배관을 층층이 검사합니다. 아카이브 자체에서 시작해, 이어서 META-INF/container.xml — 패키지 문서가 어디에 있는지 리더에게 알려 주는 운송장 역할을 하는 파일 — 를 살핍니다. 그다음 mimetype 항목을 검증합니다. 이 항목은 아카이브의 맨 첫 레코드여야 하고, 압축되지 않은 상태로 저장되어야 하며, 내용 문자열도 정확해야 합니다. 재포장 도구 상당수가 이 부분에서 틀리고, 몇몇 리더는 이 이유만으로 책을 곧바로 거부합니다.

더 깊이 들어가서는 매니페스트를 아카이브의 실제 파일과 대조합니다. 참조된 모든 문서와 이미지가 존재해야 하고, 모든 spine 항목은 선언된 매니페스트 항목을 가리켜야 하며, 내비게이션 문서(EPUB 3 nav와 EPUB 2 NCX)는 자리를 지키고 제대로 해석될 수 있어야 합니다. 마지막으로 리더가 서재에 표시하는 두 가지 — 표지 이미지 선언과 제목·저자 메타데이터 — 를 살핍니다. 각 결과는 정상, 자동 복구 가능, 또는 직접 채워 넣어야 할 항목으로 보고됩니다.

EPUB 파일이 애초에 깨지는 이유

깨진 책 대부분은 제작 도구에서 이미 깨진 상태로 태어납니다. ZIP 기록기에 버그가 있는 내보내기 도구는 mimetype 항목을 잘못된 위치에 두거나 압축해 버리고, 스크래퍼와 자작 변환기는 애초에 포함하지 않은 파일을 참조하며, 일부 집필 앱이 내보낸 매니페스트는 대소문자를 구분하는 리더에서 어긋나는 경로를 가리키기도 합니다.

나머지는 이동 중이나 보관 중에 깨집니다. 중간에 끊긴 다운로드, 아카이브 사본 두 개를 하나로 합쳐 버린 클라우드 동기화 충돌, 다른 압축 방식으로 책을 '도움' 삼아 다시 포장한 zip 도구, 컨테이너를 헷갈리게 만든 수동 이름 바꾸기가 그렇습니다. 어느 쪽도 실제 텍스트에는 손을 대지 않습니다 — 그래서 제대로 된 구조 복구는 단 한 장도 다시 인코딩하지 않고 책을 되살립니다.

진단 → 복구 → 재검사의 순환

검증할 수 없는 복구는 추측에 불과합니다. 데스크톱 도구는 고쳐진 파일을 건네고 직접 열어 보기를 맡기고, 업로드 기반 변환기는 책이 여전히 검증을 통과하지 못해도 성공 페이지를 보여줍니다. 이 도구는 이 고리를 닫습니다. 구조 복구가 적용된 뒤, 다운로드가 나타나기 전에, 똑같은 건강 검사가 브라우저 안에서 그 결과에 대해 다시 실행됩니다. 뭔가 여전히 빠져 있다면 — 이를테면 선택 사항인 표지를 건너뛰었다면 — 리포트는 성공을 선언하는 대신 그 사실을 분명히 밝힙니다.

재검사는 도구가 자기 한계에 정직하게 만드는 장치이기도 합니다. 브라우저에서 어떤 복구로도 손 쓸 수 없는 손상이 책에 있으면, 진단은 가짜 진행률 표시줄 끝에서 실패하는 대신, 시간을 들이기도 전에 '복구 불가'라고 먼저 알려 줍니다.

고칠 수 있는 것, 없는 것 — 솔직하게

자동으로 고칠 수 있는 것: 누락되었거나 잘못된 container.xml, 잘못된 위치에 있거나 압축된 mimetype 항목, 존재하지 않는 파일을 가리키는 매니페스트 항목, 선언되지 않은 항목을 참조하는 spine 항목, 누락된 EPUB 3 nav 문서 또는 EPUB 2 NCX, 그리고 이전 편집이 남긴 죽은 링크. 각각에는 정해진 복구 절차가 있고, 이 도구는 그것을 적용한 뒤 검증합니다.

여러분이 고치고 기록은 도구가 맡는 것: 누락된 표지(JPG, PNG, WebP, GIF 아무거나 업로드)와 누락된 제목·저자 메타데이터(직접 입력하면 도구가 올바른 Dublin Core 요소로 기록합니다).

여기서는 고칠 수 없고 도구도 그렇게 말하는 것: 애초에 유효한 ZIP이 아닌 아카이브, 읽을 수 있는 장이 하나도 없는 책, DRM으로 잠긴 파일. DRM으로 보호된 책은 처리할 수 없습니다 — DRM 제거는 브라우저에서 불가능할 뿐 아니라 대부분의 지역에서 불법이며, 정직한 도구라면 다르게 주장하지 않습니다.

서재에 파일 이름이나 빈 표지가 뜨는 이유

독서 앱이 서재를 꾸릴 때 읽는 것은 정확히 두 가지입니다. 패키지 메타데이터의 표지 선언과 dc:title / dc:creator 요소입니다. 하나라도 없으면 리더는 즉석에서 때웁니다 — 제목 대신 파일 이름을, 표지 대신 밋밋한 회색 타일을 보여 주죠. 그러면 사람들은 당연히 책 파일이 손상된 것으로 생각합니다. 하지만 보통은 그저 불완전한 채로 출간된 것이거나, 이전 변환기가 메타데이터를 벗겨 간 것일 뿐입니다.

그래서 표지와 메타데이터는 별도의 잡일이 아니라 이 도구 진단의 일부입니다. 건강 검사가 빈틈을 짚고, 여러분이 빠진 조각을 채워 넣으면, 재검사가 서재가 이제 책을 제대로 표시하리라고 확인해 줍니다.

로컬 복구가 중요한 이유

소중히 여기는 EPUB은 개인의 유물입니다. 주석 위치 참조, 독서 진행 표시, 구매 식별자가 담겨 있고, 메타데이터에는 앞선 소유자나 도구가 적어 둔 무엇이든 들어 있을 수 있습니다. 업로드 기반 복구 서비스는 파일 전체를 감사할 수도 없는 서버로 가져가고, 그 개인정보 처리방침이 기술하는 것은 '불가능'이 아니라 보관 기간입니다.

이 페이지에는 업로드 경로가 아예 없습니다 — 압축된 대체 경로도, 대기열도, 임시 사본도 없습니다. 파일은 리더가 쓰는 것과 같은 브라우저 API로 열리고, 메모리에서 수정되어, 여러분에게 돌아옵니다. 작동하는 동안 네트워크 탭을 지켜봐도 좋습니다. 요청이라곤 페이지 자체뿐입니다.

내 EPUB 고치기과 단일 기능 도구의 차이

이 사이트는 각 복구를 따로 하는 도구도 제공합니다 — Repair EPUB, Fix EPUB TOC, Metadata Editor, Change Cover — 그리고 그 도구들은 계속 사용할 수 있습니다. 다른 점은 의도입니다. 그 페이지들은 무엇이 잘못됐는지 이미 안다고 전제합니다. 내 EPUB 고치기은 정반대를 전제합니다. 깨진 책 한 권은 있지만 진단은 없다는 상황이죠. 모든 것을 검사하고, 자동 수정을 한 번에 적용하고, 사람의 입력이 필요한 두 가지를 요청하고, 검증을 마친 서재 준비 완료 파일로 마무리합니다.

최대 120MB 책까지 지원하며, 복구가 메모리에서 이루어지기 때문에 100MB를 넘으면 주의 안내가 표시됩니다. 출력물은 Calibre, Thorium, Kobo, Kindle(Send to Kindle 경유), 그리고 원본을 받아들인 모든 리더에서 열리는 표준 EPUB입니다.

자주 묻는 질문

관련 도구