EPUB 읽기 시스템은 리플로우어블 문서의 뷰포트 메타 요소를 무시해야 합니다; 뷰포트 선언 "%1$s"은(는) 무시됩니다.

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

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

이 메시지는 일반적인 텍스트 위주의 '리플로우어블(reflowable, 텍스트 흐름)' 전자책 문서에, '고정 레이아웃(fixed-layout)' 전용인 <meta name="viewport"> 태그가 잘못 포함되었다는 경고입니다.

## 메시지의 의미

리플로우어블 문서는 독자가 글자 크기나 화면 크기를 바꿔도 텍스트가 액체처럼 그에 맞게 자동으로 재배치되는 책을 말합니다. 이 방식에서는 독자가 레이아웃의 최종적인 크기를 결정합니다.

반면, <meta name="viewport"> 태그는 제작자가 페이지의 크기를 1024x768처럼 특정 값으로 고정하기 위해 사용하는 도구입니다.

이 둘은 서로의 목적이 완전히 반대됩니다. 따라서 EPUB 표준은 "리플로우어블 문서에서는 독자의 설정이 우선이므로, 제작자가 지정한 viewport 태그는 완전히 무시한다"고 규정하고 있습니다.

이 경고는 "불필요하고 아무 기능도 하지 않는 코드가 있으니 정리하는 것이 좋습니다"라는 의미의 친절한 안내입니다.

## 해결 방법

해결 방법은 간단합니다. 리플로우어블 문서에 포함된 불필요한 <meta name="viewport"> 태그를 완전히 삭제하면 됩니다.

### 수정 예시

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

HTML

<head>
  <meta charset="UTF-8" />
  <title>제1장</title>
  <link rel="stylesheet" href="../css/style.css" />

  <meta name="viewport" content="width=1024, height=768" />
</head>

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

HTML

<head>
  <meta charset="UTF-8" />
  <title>제1장</title>
  <link rel="stylesheet" href="../css/style.css" />
</head>

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