EPUB 제작의 기초/EPUBCheck 오류

"img" 요소는 코어 미디어 타입 리소스를 참조해야 하지만, 타입 "%1$s"의 리소스 "%2$s"이(가) 발견되었습니다.

내.맘.대.로 2025. 10. 2. 09:53

Picture "img" elements must reference core media type resources, but found resource "%1$" of type "%2$s".

 

이 오류는 <img> 태그를 사용해 이미지를 표시하려고 했지만, 그 이미지 파일의 형식이 EPUB 표준에서 공식적으로 지원하지 않는 형식일 때 발생합니다.

EPUB은 모든 전자책 단말기에서 책이 동일하게 보이도록 하기 위해, 모든 뷰어가 반드시 지원해야 하는 '코어 미디어 타입(Core Media Type)' 즉, '공식 이미지 형식'을 지정해 두었습니다. 🖼️


## EPUB 공식 지원 이미지 형식

EPUB 3 표준에서 공식적으로 지원하는 이미지 형식은 다음과 같습니다. 이 네 가지 형식 중 하나를 사용해야 합니다.

  • JPEG (.jpg, .jpeg) - 사진에 적합
  • PNG (.png) - 투명 배경이나 선명한 그래픽에 적합
  • GIF (.gif) - 간단한 애니메이션이나 색상이 적은 이미지에 적합
  • SVG (.svg) - 확대/축소해도 깨지지 않는 벡터 그래픽에 적합

오류 메시지에 나온 %1$s는 위 목록에 없는 형식(예: image/bmp, image/tiff, image/webp)일 가능성이 높습니다.


## 해결 방법

해결책은 지원되지 않는 형식의 이미지 파일을 지원되는 공식 형식(주로 JPEG 또는 PNG)으로 변환하는 것입니다.

  1. 이미지 변환: 포토샵, GIMP, 미리보기(macOS), 그림판(Windows) 등 이미지 편집 프로그램을 사용하여 오류가 발생한 이미지 파일(%2$s)을 엽니다.
  2. 다른 이름으로 저장/내보내기: '다른 이름으로 저장' 또는 '내보내기(Export)' 기능을 사용하여 파일 형식을 PNGJPEG로 선택하여 새로 저장합니다.
  3. EPUB 파일 교체: EPUB 프로젝트 폴더에 있는 기존의 비표준 이미지 파일을 새로 변환한 파일로 교체합니다.
  4. 코드 수정 (필요시): 만약 파일의 확장자가 변경되었다면(예: .bmp → .png), 이미지를 사용한 HTML 파일의 <img> 태그와 .opf 파일의 <manifest> 목록에 있는 파일 이름과 media-type도 그에 맞게 수정해야 합니다.
  • 수정 예시:
    • chart.bmp 파일을 chart.png로 변환했다면,
    • HTML 코드의 <img src="../images/chart.bmp" ... />를 <img src="../images/chart.png" ... />로 수정해야 합니다.
반응형