EPUB 읽기 시스템은 고정 레이아웃 문서의 보조 뷰포트 메타 요소를 무시해야 합니다; 뷰포트 선언 "%1$s"은(는) 무시됩니다.

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

EPUB reading systems must ignore secondary viewport meta elements in fixed-layout documents; viewport declaration "%1$s" will be ignored.

이 메시지는 고정 레이아웃(Fixed Layout) 문서의 HTML 파일 하나에 <meta name="viewport"> 태그가 두 개 이상 포함되어 있다는 경고입니다.

하나의 그림 액자 뒷면에 크기를 적은 라벨이 두 개 붙어있는 것과 같습니다. 🖼️ 하나는 '크기: 1024x768'이라고 되어 있고, 다른 하나는 '크기: 800x600'이라고 되어 있다면 혼란이 생깁니다.

이런 혼란을 방지하기 위해 EPUB 표준에는 명확한 규칙이 있습니다. 전자책 뷰어는 반드시 문서에서 가장 먼저 발견되는 viewport 메타 태그 하나만을 사용하고, 그 뒤에 나오는 모든 보조(두 번째, 세 번째...) viewport 태그는 무시해야 합니다.

이 메시지는 오류는 아니지만, "두 번째 viewport 태그(%1$s)를 발견했지만, 규칙에 따라 무시했습니다. 의도한 것이 맞나요?" 라고 알려주는 중요한 경고입니다. 불필요하고 혼란을 유발하는 코드가 있다는 뜻입니다.

## 해결 방법

해결책은 간단합니다. 각 HTML 파일에 단 하나의 올바른 viewport 메타 태그만 남기고 나머지는 모두 삭제하는 것입니다.

경고가 발생한 HTML 파일을 텍스트 편집기에서 엽니다.
<head> ... </head> 섹션 안에서 <meta name="viewport" ... > 태그를 모두 찾습니다.
페이지에 맞는 올바른 크기를 가진 태그 하나만 남겨두고, 나머지 중복되거나 잘못된 viewport 태그는 모두 삭제합니다.

### 수정 예시

수정 전 (경고 발생 예시):

HTML

<head>
  <title>My Page</title>
  <meta name="viewport" content="width=1024, height=768" />
  <link rel="stylesheet" href="../css/style.css" />
  <meta name="viewport" content="width=800, height=600" />
</head>

수정 후 (올바른 코드): ✅

HTML

<head>
  <title>My Page</title>
  <meta name="viewport" content="width=1024, height=768" />
  <link rel="stylesheet" href="../css/style.css" />
</head>

저작자표시 비영리 변경금지 (새창열림)