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

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

반응형