EPUB 제작의 기초/EPUBCheck 오류
뷰포트 "%1$s" 속성은 한 번 넘게 정의해서는 안 되지만, [%2$s] 값이 발견되었습니다.
내.맘.대.로
2025. 10. 2. 09:31
Viewport "%1$s" property must not be defined more than once, but found values [%2$s].
이 오류는 고정 레이아웃 EPUB의 <meta name="viewport"> 태그 안에서 특정 속성(주로 width 또는 height)이 두 번 이상 중복으로 정의되었다는 의미입니다.
창문 시공업자에게 "창문 너비는 100cm로 해주세요. 그리고 창문 너비는 80cm로 해주세요." 와 같이 서로 충돌하는 지시를 내리는 것과 같습니다. 📋 전자책 뷰어는 어떤 크기를 따라야 할지 알 수 없으므로, 이를 오류로 보고합니다.
viewport의 각 속성(width, height 등)은 content 속성 내에서 반드시 한 번만 정의되어야 합니다.
## 해결 방법
해결책은 간단합니다. 중복으로 정의된 속성을 하나만 남기고 모두 삭제하면 됩니다.
- 오류가 발생한 HTML 파일을 엽니다.
- <head> 섹션에서 <meta name="viewport" ... > 태그를 찾습니다.
- content="..." 속성 안의 내용을 자세히 살펴봅니다.
- 두 번 이상 반복되는 속성(예: width=...)을 찾아서, 올바른 값 하나만 남기고 나머지는 삭제합니다.
### 수정 예시
- 수정 전 (오류 예시 - width가 두 번 정의됨):
-
HTML
<meta name="viewport" content="width=1024, height=768, width=800" /> - 수정 후 (올바른 코드): ✅
-
HTML
<meta name="viewport" content="width=1024, height=768" />
반응형