외부 참조가 발견되었습니다.

An external reference was found.

 

이 오류는 EPUB 파일 내부의 코드(주로 XHTML 또는 CSS)가 책 바깥에 있는 외부 파일이나 인터넷상의 리소스를 참조(링크)하고 있음을 의미합니다.

EPUB은 인터넷 연결 없이도 모든 내용이 완벽하게 작동해야 하는 '자체 완결형(self-contained)' 패키지여야 합니다. 필요한 모든 이미지, 스타일, 글꼴 등은 반드시 .epub 파일 안에 포함되어야 합니다.

도시락을 쌀 때, 모든 반찬을 도시락 통 안에 넣어야 하는 것과 같습니다. 🍱 이 오류는 도시락 안에 '음료수는 길 건너 편의점에서 사 드세요'라는 메모를 넣어둔 것과 같은 상황입니다.

---

## 외부 참조가 문제가 되는 이유

• 오프라인 사용 불가: 인터넷에 연결되어 있지 않으면 외부 이미지가 보이지 않거나 링크가 작동하지 않습니다.
• 링크 깨짐 (Link Rot): 시간이 지나 참조하던 외부 웹사이트 주소가 바뀌거나 사라지면, 책에 깨진 이미지나 작동하지 않는 링크가 남게 됩니다.
• 보안 및 개인정보: 외부 서버는 독자가 언제 어디서 책을 읽는지 접속 기록을 통해 알 수 있으며, 악성 코드를 유포하는 경로가 될 수도 있습니다.

---

## 해결 방법

외부 참조의 종류에 따라 해결 방법이 다릅니다.

### 경우 1: 이미지, CSS, 스크립트 등 필수 파일을 외부에서 가져올 때

이 경우는 반드시 수정해야 합니다.

1. 파일 다운로드: 웹브라우저를 이용해 코드에 링크된 외부 파일(예: photo.jpg)을 자신의 컴퓨터로 다운로드합니다.
2. EPUB에 파일 추가: 다운로드한 파일을 EPUB 프로젝트의 적절한 폴더(예: images 폴더)에 추가합니다.
3. .opf 파일 수정: .opf 파일의 <manifest>에 새로 추가한 파일을 등록합니다.
4. 경로 수정: HTML 또는 CSS 파일에서 외부 인터넷 주소(절대 경로)를 EPUB 내부의 파일 위치(상대 경로)로 변경합니다.

• 수정 전:
• HTML

   

  <img src="https://example.com/images/photo.jpg" alt="예시 사진" />
  

• 수정 후: ✅
• HTML

   

  <img src="../images/photo.jpg" alt="예시 사진" />
  

### 경우 2: 본문의 참고용 하이퍼링크 (<a> 태그)

본문 내용에 참고 자료로 외부 웹사이트 링크를 거는 것은 대부분의 경우 허용됩니다. 이 경우 EPUBCheck는 '오류'가 아닌 '경고'나 '알림' 수준으로 외부 링크가 존재함을 알려주는 것일 수 있습니다. 링크가 의도된 것이고 주소가 정확하다면 특별히 수정하지 않아도 괜찮습니다.