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

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

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

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

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

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

Fixed layout document has no "viewport" meta element.

 

이 오류는 잡지나 그림책과 같은 고정 레이아웃(Fixed Layout) EPUB에서 발생하는 중대한 문제입니다.

오류의 의미는, 각 페이지의 정확한 크기(가로, 세로 픽셀)가 얼마인지 전자책 뷰어에게 알려주는 필수 정보인 <meta name="viewport"> 태그가 누락되었다는 뜻입니다.

800x600 픽셀 크기의 그림을 벽에 걸어야 하는 상황을 생각해보세요. 🖼️ viewport 메타 태그는 그림 뒷면에 "이 그림의 너비는 800, 높이는 600입니다"라고 붙여두는 라벨과 같습니다. 이 라벨이 없으면, 전시 담당자(전자책 뷰어)는 그림을 얼마나 크게 표시해야 할지 알 수 없어 너무 작게 보여주거나 그림의 일부를 잘라버리는 등 엉뚱하게 표시할 수 있습니다.


## 해결 방법

해결책은 고정 레이아웃 EPUB에 포함된 모든 HTML/XHTML 파일의 <head> 섹션 안에 viewport 메타 태그를 추가하는 것입니다.

  1. 페이지 크기 확인: 먼저, 제작하려는 고정 레이아웃 페이지의 정확한 가로(width)와 세로(height) 크기를 픽셀 단위로 확인해야 합니다. (예: 1024 x 768)
  2. 메타 태그 추가: 아래 형식에 맞게 width와 height 값을 자신의 프로젝트에 맞게 수정한 뒤, 모든 HTML 파일의 <head> ... </head> 안쪽에 추가합니다.

### 수정 예시

  • 수정 전 (오류가 발생하는 <head>):
  • HTML
     
    <head>
      <meta charset="UTF-8" />
      <title>1 페이지</title>
      <link rel="stylesheet" href="../css/style.css" />
    </head>
    
  • 수정 후 (올바른 코드):
  • 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>
    

중요: 위 예시의 width=1024, height=768 부분은 반드시 자신의 고정 레이아웃 페이지 실제 크기에 맞게 수정해야 합니다.

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

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

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

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

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

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

Empty hrefs are valid self-references. These should be validated to ensure that this is the desired intent.

 

네, 맞습니다. 이 메시지는 EPUBCheck가 코드에서 href="" 와 같이 비어있는 링크를 발견했을 때 보여주는 경고입니다.

오류가 아니라고 하는 이유는, href=""가 문법적으로는 '현재 페이지를 다시 불러오는' 유효한 링크이기 때문입니다. 하지만 EPUBCheck는 "문법적으로는 맞지만, 사용자를 혼란스럽게 할 수 있는 의심스러운 코드이니 정말 의도한 것이 맞는지 확인해보세요"라고 알려주는 것입니다.

복도에 있는 문을 열었더니 바로 그 복도로 다시 나오는 것과 같습니다. 🚪 문 자체는 멀쩡하지만(유효함), 그 기능은 대부분의 경우 쓸모없고 혼란스럽습니다.


## 확인이 필요한 이유

비어있는 링크는 보통 다음과 같은 경우에 발생하며, 사용자 경험에 좋지 않은 영향을 줍니다.

  • 실수 또는 누락: 링크 주소를 나중에 넣으려고 비워뒀다가 잊어버린 경우.
  • 혼란스러운 동작: 독자가 링크를 클릭했는데 아무 데로도 이동하지 않고 페이지가 새로고침되면, 링크가 고장났다고 생각하게 됩니다.
  • 접근성 문제: 화면 낭독기 사용자는 '링크'라고 안내를 받지만, 링크를 실행해도 아무런 변화가 없어 혼란을 겪을 수 있습니다.

## 해결 방법

코드에서 href=""를 찾은 뒤, 원래 의도가 무엇이었는지에 따라 아래와 같이 수정합니다.

### 경우 1: 실제 링크 주소를 넣으려다 빠뜨린 경우

가장 흔한 경우입니다. 비어있는 href 속성 안에 정확한 목적지 주소(다른 파일 경로, 웹사이트 주소 등)를 입력합니다.

  • 수정 전:
  • HTML
     
    <p>자세한 내용은 <a href="">부록</a>을 참고하세요.</p>
    
  • 수정 후:
  • HTML
     
    <p>자세한 내용은 <a href="appendix.xhtml">부록</a>을 참고하세요.</p>
    

### 경우 2: 링크 기능이 필요 없는 경우

링크처럼 보이게 스타일만 주려 했거나, 스크립트 등을 위해 임시로 사용한 경우입니다. 이럴 때는 링크 태그인 <a>를 사용하는 것 자체가 잘못된 것이므로, <a> 태그를 아예 삭제하는 것이 가장 좋습니다.

  • 수정 전:
  • HTML
     
    <p>중요한 단어: <a href="">강조</a></p>
    
  • 수정 후: ✅(그 후 CSS에서 .emphasis 클래스에 원하는 스타일을 적용합니다.)
  • HTML
     
    <p>중요한 단어: <span class="emphasis">강조</span></p>
    
반응형
posted by 내.맘.대.로 2025. 10. 2. 09:15

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

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

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

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

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

Remove unused Namespace URIs.

 

이 지침은 '사용되지 않은 네임스페이스' 경고를 해결하기 위해 필요 없는 네임스페이스를 삭제하라는 안내입니다.

## 제거 방법

  1. 경고가 발생한 XHTML 파일을 텍스트 편집기에서 엽니다.
  2. 파일 최상단의 <html> 태그를 찾습니다.
  3. <html> 태그 안에서, 경고 메시지에 언급된 URI를 가진 xmlns:... 속성을 찾아 그 부분 전체를 삭제합니다.

## 수정 예시

예를 들어, xmlns:dc="..." 가 사용되지 않았다면 다음과 같이 수정합니다.

  • 수정 전:
  • XML
     
    <html xmlns="http://www.w3.org/1999/xhtml"
          xmlns:epub="http://www.idpf.org/2007/ops"
          xmlns:dc="http://purl.org/dc/elements/1.1/">
    
  • 수정 후:
  • XML
     
    <html xmlns="http://www.w3.org/1999/xhtml"
          xmlns:epub="http://www.idpf.org/2007/ops">
반응형
posted by 내.맘.대.로 2025. 10. 2. 09:13

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

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

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

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

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

Namespace uri "%1$s" was included but not used.

 

이 메시지는 수정이 필요한 오류라기보다는, 코드 정리를 권장하는 경고입니다.

의미는 XHTML 파일의 상단(<html> 태그)에 특정 기능(네임스페이스)을 사용하겠다고 선언해두었지만, 정작 문서 본문에서는 그 기능을 한 번도 사용하지 않았다는 뜻입니다.

보고서를 작성할 때 참고문헌 목록에는 넣어두었지만, 본문에서는 한 번도 인용하지 않은 책이 있는 것과 같습니다. 📚 치명적인 문제는 아니지만, 불필요한 정보이므로 깔끔하게 정리하는 것이 좋습니다.


## 해결 방법

해결 방법은 간단합니다. 사용하지 않은 네임스페이스 선언을 <html> 태그에서 삭제하면 됩니다.

  1. 경고가 발생한 XHTML 파일을 텍스트 편집기에서 엽니다.
  2. 파일의 가장 윗부분에 있는 <html> 태그를 찾습니다.
  3. 경고 메시지에 나온 URI(%1$s)에 해당하는 xmlns:... 속성 전체를 찾아서 삭제합니다.

### 수정 예시

만약 오류 메시지에 http://purl.org/dc/elements/1.1/ URI가 사용되지 않았다고 나왔다면:

  • 수정 전 (경고 발생 예시):
  • XML
     
    <html xmlns="http://www.w3.org/1999/xhtml"
          xmlns:epub="http://www.idpf.org/2007/ops"
          xmlns:dc="http://purl.org/dc/elements/1.1/">
    
  • 수정 후 (올바른 코드):
  • XML
     
    <html xmlns="http://www.w3.org/1999/xhtml"
          xmlns:epub="http://www.idpf.org/2007/ops">
    

참고: 이 경고에 대한 EPUBCheck의 공식 수정 제안(HTM_044_SUG)은 다음과 같습니다.

사용하지 않은 네임스페이스 URI를 삭제하십시오.

반응형