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

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

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>
반응형
posted by 내.맘.대.로 2025. 10. 2. 09:48

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

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 메타 태그만 남기고 나머지는 모두 삭제하는 것입니다.

  1. 경고가 발생한 HTML 파일을 텍스트 편집기에서 엽니다.
  2. <head> ... </head> 섹션 안에서 <meta name="viewport" ... > 태그를 모두 찾습니다.
  3. 페이지에 맞는 올바른 크기를 가진 태그 하나만 남겨두고, 나머지 중복되거나 잘못된 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>
반응형
posted by 내.맘.대.로 2025. 10. 2. 09:31

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

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 속성 내에서 반드시 한 번만 정의되어야 합니다.


## 해결 방법

해결책은 간단합니다. 중복으로 정의된 속성을 하나만 남기고 모두 삭제하면 됩니다.

  1. 오류가 발생한 HTML 파일을 엽니다.
  2. <head> 섹션에서 <meta name="viewport" ... > 태그를 찾습니다.
  3. content="..." 속성 안의 내용을 자세히 살펴봅니다.
  4. 두 번 이상 반복되는 속성(예: width=...)을 찾아서, 올바른 값 하나만 남기고 나머지는 삭제합니다.

### 수정 예시

  • 수정 전 (오류 예시 - width가 두 번 정의됨):
  • HTML
     
    <meta name="viewport" content="width=1024, height=768, width=800" />
    
  • 수정 후 (올바른 코드):
  • HTML
     
    <meta name="viewport" content="width=1024, height=768" />
반응형
posted by 내.맘.대.로 2025. 10. 2. 09:30

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

HTML documents must be encoded in UTF-8, but UTF-16 was detected.

 

이 오류는 이전에 다루었던 CSS 인코딩 문제와 동일하며, 이번에는 EPUB의 **본문 파일(HTML/XHTML)**이 잘못된 '언어(인코딩)' 방식으로 저장되었다는 의미입니다.

EPUB 표준은 전 세계 모든 기기에서 글자나 특수 기호가 깨지는 현상 없이 완벽하게 호환되도록, 모든 텍스트 기반 파일을 UTF-8이라는 단일 방식으로 저장하도록 엄격하게 요구합니다. 🌏

UTF-16으로 저장된 HTML 파일은 일부 전자책 뷰어에서 내용을 전혀 표시하지 못하거나 글자가 깨져 보일 수 있습니다.


## 해결 방법: 인코딩을 UTF-8로 변경하기

해결 방법은 간단합니다. 문제가 된 HTML 파일을 텍스트 편집기에서 열어 인코딩 방식을 UTF-8로 변경한 후 다시 저장하면 됩니다.

### Visual Studio Code, Notepad++ 등 전문 편집기 사용 시

  1. 오류가 발생한 HTML 파일을 편집기에서 엽니다.
  2. 편집기 창의 오른쪽 아래에 있는 상태 표시줄에서 현재 인코딩(예: UTF-16 LE)이 표시된 부분을 클릭합니다.
  3. 나타나는 메뉴에서 '인코딩하여 저장(Save with Encoding)' 또는 유사한 옵션을 선택합니다.
  4. 목록에서 **'UTF-8'**을 선택하고 파일을 덮어써 저장합니다.

### 윈도우 메모장 사용 시

  1. HTML 파일을 메모장으로 엽니다.
  2. 상단 메뉴에서 **'파일 > 다른 이름으로 저장'**을 클릭합니다.
  3. 저장 대화상자 하단에 있는 '인코딩' 드롭다운 메뉴에서 **'UTF-8'**을 선택합니다.
  4. '저장' 버튼을 눌러 기존 파일을 덮어씁니다.
반응형
posted by 내.맘.대.로 2025. 10. 2. 09:29

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

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" />
    

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

반응형
posted by 내.맘.대.로 2025. 10. 2. 09:28

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

Viewport metadata has no "%1$s" dimension (both "width" and "height" properties are required)

 

이 오류는 고정 레이-아웃 EPUB의 <meta name="viewport"> 태그에 너비(width)와 높이(height) 중 하나가 빠져있다는 의미입니다.

고정 레이-아웃 페이지의 정확한 크기를 정의하려면, 가로와 세로 크기 정보가 모두 반드시 필요합니다.

액자 프레임을 주문하는데, "가로 10인치짜리 프레임을 만들어주세요" 라고만 하고 세로 길이를 알려주지 않는 것과 같습니다. 🖼️ 정보가 절반만 있어서는 정확한 크기의 프레임(전자책 페이지)을 만들 수 없습니다.


## 해결 방법

해결책은 간단합니다. viewport 메타 태그의 content 속성 안에 빠져있는 속성(width 또는 height)을 추가하여 두 가지 정보를 모두 제공하면 됩니다.

  • 규칙: content 속성에는 width=[숫자]와 height=[숫자]가 **쉼표(,)**로 구분되어 모두 포함되어야 합니다.

## 수정 예시

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

중요: 위 예시의 1024와 768 값은 반드시 자신의 고정 레이-아웃 페이지 실제 크기에 맞는 숫자로 수정해야 합니다.

반응형