EPUB 제작의 기초/EPUBCheck 오류

뷰포트 "%1$s" 값은 양수 또는 키워드 "device-%1$s"이어야 합니다.

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

Viewport "" value must be a positive number or the keyword "device-"

 

이 오류는 고정 레이아웃 EPUB의 <meta name="viewport"> 태그에 있는 width(너비) 또는 height(높이) 속성의 값이 잘못되었음을 의미합니다.

페이지의 너비나 높이 값은 반드시 0보다 큰 양수이거나, 특수한 경우에만 사용되는 특정 키워드여야 한다는 규칙이 있습니다.


## 값에 대한 규칙

width와 height 속성에 사용할 수 있는 값은 두 종류입니다.

  1. 양수 (Positive Number) 가장 일반적인 방법으로, 1024나 768처럼 0보다 큰 정수를 사용해야 합니다. 페이지의 크기가 0이거나 음수일 수는 없으므로, width=0이나 height=-100과 같은 값은 오류를 발생시킵니다.
  2. 특수 키워드 (Special Keywords) device-width와 device-height라는 키워드를 사용할 수 있습니다. 이는 뷰포트의 크기를 기기의 화면 크기에 맞추라는 의미이지만, 이 방식은 주로 화면 크기에 따라 내용이 변하는 반응형 웹사이트에서 사용됩니다. 모든 페이지의 크기가 동일해야 하는 고정 레이아웃 EPUB에서는 일반적으로 사용하지 않습니다.

따라서, 고정 레이아웃 EPUB을 제작할 때는 항상 양수 값을 사용하는 것이 올바른 방법입니다.


## 해결 방법

viewport 메타 태그의 width와 height 값을 페이지 크기에 맞는 양수로 수정하면 됩니다.

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

중요: 너비와 높이 값은 반드시 자신의 고정 레이아웃 페이지 실제 크기에 맞는 양수로 지정해야 합니다.

반응형