뷰포트 메타데이터 "%1$s"에 구문 오류가 있습니다.

Viewport metadata "%1$s" has a syntax error

 

이 오류는 고정 레이아웃 EPUB에 필수적인 <meta name="viewport"> 태그를 추가했지만, 그 내용(content)의 작성 형식, 즉 구문(syntax)이 잘못되었다는 의미입니다.

주소를 적을 때 '도로명 주소, 도시' 형식으로 적기로 약속했다고 상상해보세요. 📬 이 오류는 '도로명 주소: 도시' 처럼 콜론을 쓰거나, '도로명 주소; 도시' 처럼 세미콜론을 쓰는 등 약속된 형식을 따르지 않았다는 뜻입니다. 정보는 있지만 형식이 잘못되어 우체부(전자책 뷰어)가 주소를 제대로 인식할 수 없는 상황입니다.

---

## Viewport의 올바른 구문

content 속성 안의 내용은 반드시 다음 규칙을 따라야 합니다.

• width와 height 값은 **쉼표(,)**로 구분합니다.
• 각 값은 이름=숫자 형식이어야 합니다 (예: width=1024).
• 숫자 뒤에 px와 같은 단위를 붙이지 않습니다.
• 쉼표(,)와 등호(=) 외에 다른 기호(예: :, ;)를 사용하지 않습니다.

---

## 해결 방법

meta 태그의 content 속성 값을 올바른 구문에 맞게 수정하면 됩니다.

### 잘못된 구문 예시 (오류 발생)

HTML

 

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

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

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

### 올바른 구문 예시 (수정 후) ✅

HTML

 

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