클로드 코드로 e-pub파일 수정하기

소개

전자책 발행을 위하여 워드파일을 e-pub파일로 변환했으나 자동 목차 생성과정에서 오류가 났다. 수동으로 몇 번 하다가 안돼서 클로드코드에게 '해줘'했더니 깔끔하게 정리해 주었다.

진행 방법

클로드코드로 e-pub파일 만들고 vs code와 옵시디언에 자동 저장

***************

1. 전자책 발행을 위하여 워드파일을 자동목차로 만들음

2. 워드파일을 Online Converter에서 e-pub파일로 만들음

3. e-pub파일을 확인하기 위하여 Neat Reader에서 읽음.

오류 발생: 목차에 'untitled'라는 표시가 3곳이 발생. 이는 페이지 넘기는 것을 e-pub파일이 목차로 잘못 해독을 한 것임. 교보문고에서 이러한 오류내용이 toc.ncx 에 떠서 자동 발행이 되지 않은 경험이 있었음.

4. 워드파일에서 'untitled'에 해당되는 페이지의 공백을 전부 삭제하고 다시 e-pub파일로 변환했으나, 여전히 'untitled' 오류가 발생함

5. 클로드 코드에 하소연함

   사본

   워드파일을 e-pub파일로 전환했어요. e-pub파일을 열어보니 목차에 'untitled'가 있어요. 일전에 교보문고에서 이러한 내용과 함께 돌아온 적이 있었어요. "'(Untitled)' 목차명이 본문 내용과 적절하지 않은 목차명으로 확인됩니다. 뷰어 열람시 목차 이동이 용이하도록 toc.ncx 파일에서 본문 내용에 맞게 목차명 수정 후 재 업로드 부탁드립니다." 그 때 어떻게 수정하였는지 기억이 안 나요. 어떻게 하면 될까요? 그리고 이러한 기록을 다시 찾아 보느라고 한참 헤맸어요. 이러한 대화 내용을 어떻게 어디에 기록을 남겨두면 좋을까요?

ALT

한국어 페이지 스크린샷

해결 방법 (Sigil 사용 - 가장 쉬움)

1. Sigil 설치 (무료 ePub 편집기)

   • https://sigil-ebook.com 에서 다운로드

2. ePub 파일 열기

   • Sigil에서 파일 → 열기 → epub 파일 선택

3. 목차 수정

   • 왼쪽 패널에서 toc.ncx 파일 더블클릭

   • <text>Untitled</text> 찾기

   • 적절한 목차명으로 수정 (예: <text>에필로그</text>)

클로드코드가 Sigil 설치 (무료 ePub 편집기)하고 교정하는 방법이 가장 쉽다고 하였으나 설치가 너무 복잡하여 실패. (슬슬 짜증이 나기 시작함)

여러번 티키타카 하다가 드디어 왕짜증, 클로드코드에게 네가 다해줘. e-pub파일을 수정하고 저장해줘!!!

window64 에서 https://sigil-ebook.com 이 위험하다고 다운이 안돼요. 워드에서 '제목 없이 스타일만 적용된 빈 단락 찾아서 삭제' 찾을 수가 없어요. 워드파일에서 직접 페이지와 페이지 사이를 삭제하고 다시 e-pub파일로 바꾸고 neatreader로 읽어보았는데 'untiltled'가 안 없어졌어요. 너가 직접 수정해줄 수 있나요? 너가 직접 수정하기 위하여 내가 너에게 무엇을 해야 되나요? 워드파일을 업로드하면 되나요?

클로드코드가 잔꾀를 부리며 가장 쉬운 방법이라며 Calibre를 설지 수정하라고 함

가장 쉬운 방법: Calibre 사용
Calibre는 전 세계에서 가장 많이 쓰는 무료 전자책 프로그램이에요. 안전합니다.
설치

1. https://calibre-ebook.com/download_windows64 클릭

2. 다운로드된 파일 실행 → 설치

ePub 목차 수정 (클릭 몇 번이면 끝)

1. Calibre 실행

2. ePub 파일을 Calibre 창에 드래그

3. 책 선택 → 상단 "책 편집" 클릭

4. 왼쪽에서 "목차" 클릭

5. "Untitled" 항목 선택 → 삭제 또는 이름 변경

6. 저장 (Ctrl+S)

   Calibre에서 목차는 정리되었으나 read only파일을 다운받을 수 없었음.

왕짜증 다시 한 번 네가 '해줘!'

ePub 파일 위치를 알려주시면, 제가 직접 toc.ncx 파일을 찾아서 수정해드릴게요. ePub 파일이 어디에 저장되어 있나요?

탐색기에 있는 e-pub파일 위치를 알려주니, 클로드 코드가 한참을 뒤지고 파일들을 하나 하나 열어보고 마침내 수정본을 저장해 줌.

찾았어요! 제가 직접 수정해드릴게요.

파일을 찾았어요. 이제 압축을 풀어서 toc.ncx를 수정할게요.

Bash ePub을 ZIP으로 복사 후 압축 해제

toc.ncx 파일을 찾았어요. 내용을 확인할게요.

toc.ncx 파일에는 "Untitled"가 없네요! 다른 파일에 있을 수 있어요. HTML 파일들을 확인해볼게요.

여러 문제를 발견했어요. 수정하겠습니다:
책 제목이 "Unknown"으로 되어있음
페이지 나누기 요소들이 있음 (calibre_pb_0, 1, 2...)
수정을 시작할게요.

이제 HTML 파일들의 title 태그도 수정할게요.

모든 파일 수정 완료! 이제 ePub 파일로 다시 압축할게요.

수정된 ePub 파일이 생성되었습니다.
생성된 파일: 새로_피는_꽃_3권_수정.epub
위치: 문서 > 1 전자책 > 사추기 > 사추기 최종 워드 파일 및 e pub파일 표지
수정한 내용
책 제목: "Unknown" → "새로 피는 꽃 3권"
저자명: "python-docx" → "정윤영"
언어: "en" → "ko" (한국어)
모든 HTML 파일의 title 태그: "Unknown" → 각 챕터 제목

다음 단계:
새로_피는_꽃_3권_수정.epub 파일을 Neat Reader로 열어보세요
목차에서 "(Untitled)"가 사라졌는지 확인해주세요
만약 아직 "(Untitled)"가 보이면 알려주세요. 추가 수정이 필요할 수 있어요.

우와!!!! 클로드 코드가 내 탐색기에 있는 전자책 e-pub파일을 깔끔하게 수정해줌.

Thank you, Claude Code!!

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

혼자 노가다로 끌탕을 하다가 마지막으로 클로드코드에 '해줘' 했더니, 내 탐색기를 한참 뒤지고 모든 파일들을 전부 검색해보고 마침내 문제를 찾아서 교정해주고 다시 수정본을 탐색기, 클로드코드, 옵시디언에 저장해 줌.

과정 중에 어떤 시행착오를 겪었나요?

neat reader가 e-pub파일을 무료로 읽는데 몇 회만 가능함. 다음 시간을 기다려야 함.

클로드 코드가 해보라고 가르쳐 주는 툴들, Sigil, Calibre 시도하다가 시간만 허비함.

앞으로는 먼저 클로드코드에게 모든 일을 맡겨보고 안되면 수동으로 전환하기로 함.