EPUB 제작의 기초/EPUBCheck 오류

뷰포트 메타데이터에 "%1$s" 폭, 높이 속성이 없습니다 ("width"와 "height" 속성 모두 필요합니다).

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

Viewport metadata has no "%1$s" dimension (both "width" and "height" properties are required)

 

이 오류는 고정 레이-아웃 EPUB의 <meta name="viewport"> 태그에 너비(width)와 높이(height) 중 하나가 빠져있다는 의미입니다.

고정 레이-아웃 페이지의 정확한 크기를 정의하려면, 가로와 세로 크기 정보가 모두 반드시 필요합니다.

액자 프레임을 주문하는데, "가로 10인치짜리 프레임을 만들어주세요" 라고만 하고 세로 길이를 알려주지 않는 것과 같습니다. 🖼️ 정보가 절반만 있어서는 정확한 크기의 프레임(전자책 페이지)을 만들 수 없습니다.


## 해결 방법

해결책은 간단합니다. viewport 메타 태그의 content 속성 안에 빠져있는 속성(width 또는 height)을 추가하여 두 가지 정보를 모두 제공하면 됩니다.

  • 규칙: content 속성에는 width=[숫자]와 height=[숫자]가 **쉼표(,)**로 구분되어 모두 포함되어야 합니다.

## 수정 예시

  • 수정 전 (오류 예시):
  • HTML
     
    <meta name="viewport" content="width=1024" />
    
    <meta name="viewport" content="height=768" />
    
  • 수정 후 (올바른 코드):
  • HTML
     
    <meta name="viewport" content="width=1024, height=768" />
    

중요: 위 예시의 1024와 768 값은 반드시 자신의 고정 레이-아웃 페이지 실제 크기에 맞는 숫자로 수정해야 합니다.

반응형