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 값은 반드시 자신의 고정 레이-아웃 페이지 실제 크기에 맞는 숫자로 수정해야 합니다.

반응형