ssml:ph 속성의 값이 비어 있거나 공백만으로 이루어져 있습니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 29. 07:38

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

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

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

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

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

Empty or whitespace-only value of attribute ssml:ph.

 

이 오류는 텍스트를 소리 내어 읽어주는 TTS(Text-to-Speech) 기능의 발음을 제어하는 고급 속성인 **ssml:ph**가 비어있다는 의미입니다.

ssml:ph 속성은 **음소(phoneme)**의 약자로, 컴퓨터가 단어를 잘못 읽을 경우를 대비해 정확한 발음 기호를 직접 제공하는 역할을 합니다.

배우의 대본에 어려운 이름 'Aoife' 옆에 '(발음: '이-파')'라고 적어주는 것과 같습니다. 🗣️ 이 오류는 발음 지시를 위한 메모를 붙여놓고, 정작 그 안에 아무 내용도 적지 않은 것과 같은 상황입니다. 속성의 목적 자체가 '발음 정보 제공'인데 그 정보가 비어있으므로 오류가 발생합니다.

## 해결 방법

두 가지 방법 중 하나를 선택할 수 있습니다.

### 해결 방법 1: 올바른 발음 기호 제공 (고급)

만약 단어의 발음을 직접 지정하려는 의도가 있었다면, 비어있는 ssml:ph 속성 안에 국제 음성 기호(IPA)나 X-SAMPA 같은 표준 발음 기호를 정확하게 입력해야 합니다. 이는 음성학에 대한 전문 지식이 필요한 고급 작업입니다.

  • 수정 전:
  • XML
     
    <p>Please read <span ssml:ph="">EPUB</span>.</p>
  • 수정 후: ✅
  • XML
     
    <p>Please read <span ssml:ph="ˈiːpʌb">EPUB</span>.</p>

### 해결 방법 2: 불필요한 속성 삭제 (대부분의 경우 권장)

만약 발음을 직접 제어할 의도가 없었거나 실수로 속성을 추가한 경우, 해당 ssml:ph="..." 속성 자체를 완전히 삭제하는 것이 가장 간단하고 확실한 해결책입니다.

  • 수정 전:
  • XML
     
    <p>단어의 <span ssml:ph="">발음</span>을 지정합니다.</p>
  • 수정 후: ✅
  • XML
     
    <p>단어의 발음을 지정합니다.</p>

특별히 TTS의 발음을 세밀하게 제어해야 하는 경우가 아니라면, 해결 방법 2를 사용해 불필요한 속성을 삭제하는 것을 권장합니다.

반응형
저작자표시 비영리 변경금지 (새창열림)

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

"epub" 접두사에 네임스페이스 "%1$s"은(는) 일반적이지 않습니다.  (1) 2025.09.29
제공된 DOCTYPE은 구식이거나 비정상적이므로 삭제할 수 있습니다.  (0) 2025.09.29
외부 참조가 발견되었습니다.  (0) 2025.09.29
비정상적인 DOCTYPE: 발견된 값은 "%1$s", 필요한 값은 "%2$s"입니다.  (0) 2025.09.29
EPUB v3 문서에서는 외부 엔티티가 허용되지 않습니다. 외부 엔티티 선언이 발견되었습니다: %1$s.  (0) 2025.09.29

외부 참조가 발견되었습니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 29. 07:37

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

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

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

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

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

An external reference was found.

 

이 오류는 EPUB 파일 내부의 코드(주로 XHTML 또는 CSS)가 책 바깥에 있는 외부 파일이나 인터넷상의 리소스를 참조(링크)하고 있음을 의미합니다.

EPUB은 인터넷 연결 없이도 모든 내용이 완벽하게 작동해야 하는 '자체 완결형(self-contained)' 패키지여야 합니다. 필요한 모든 이미지, 스타일, 글꼴 등은 반드시 .epub 파일 안에 포함되어야 합니다.

도시락을 쌀 때, 모든 반찬을 도시락 통 안에 넣어야 하는 것과 같습니다. 🍱 이 오류는 도시락 안에 '음료수는 길 건너 편의점에서 사 드세요'라는 메모를 넣어둔 것과 같은 상황입니다.

## 외부 참조가 문제가 되는 이유

  • 오프라인 사용 불가: 인터넷에 연결되어 있지 않으면 외부 이미지가 보이지 않거나 링크가 작동하지 않습니다.
  • 링크 깨짐 (Link Rot): 시간이 지나 참조하던 외부 웹사이트 주소가 바뀌거나 사라지면, 책에 깨진 이미지나 작동하지 않는 링크가 남게 됩니다.
  • 보안 및 개인정보: 외부 서버는 독자가 언제 어디서 책을 읽는지 접속 기록을 통해 알 수 있으며, 악성 코드를 유포하는 경로가 될 수도 있습니다.

## 해결 방법

외부 참조의 종류에 따라 해결 방법이 다릅니다.

### 경우 1: 이미지, CSS, 스크립트 등 필수 파일을 외부에서 가져올 때

이 경우는 반드시 수정해야 합니다.

  1. 파일 다운로드: 웹브라우저를 이용해 코드에 링크된 외부 파일(예: photo.jpg)을 자신의 컴퓨터로 다운로드합니다.
  2. EPUB에 파일 추가: 다운로드한 파일을 EPUB 프로젝트의 적절한 폴더(예: images 폴더)에 추가합니다.
  3. .opf 파일 수정: .opf 파일의 <manifest>에 새로 추가한 파일을 등록합니다.
  4. 경로 수정: HTML 또는 CSS 파일에서 외부 인터넷 주소(절대 경로)를 EPUB 내부의 파일 위치(상대 경로)로 변경합니다.
  • 수정 전:
  • HTML
     
    <img src="https://example.com/images/photo.jpg" alt="예시 사진" />
  • 수정 후: ✅
  • HTML
     
    <img src="../images/photo.jpg" alt="예시 사진" />

### 경우 2: 본문의 참고용 하이퍼링크 (<a> 태그)

본문 내용에 참고 자료로 외부 웹사이트 링크를 거는 것은 대부분의 경우 허용됩니다. 이 경우 EPUBCheck는 '오류'가 아닌 '경고'나 '알림' 수준으로 외부 링크가 존재함을 알려주는 것일 수 있습니다. 링크가 의도된 것이고 주소가 정확하다면 특별히 수정하지 않아도 괜찮습니다.

반응형
저작자표시 비영리 변경금지 (새창열림)

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

제공된 DOCTYPE은 구식이거나 비정상적이므로 삭제할 수 있습니다.  (0) 2025.09.29
ssml:ph 속성의 값이 비어 있거나 공백만으로 이루어져 있습니다.  (0) 2025.09.29
비정상적인 DOCTYPE: 발견된 값은 "%1$s", 필요한 값은 "%2$s"입니다.  (0) 2025.09.29
EPUB v3 문서에서는 외부 엔티티가 허용되지 않습니다. 외부 엔티티 선언이 발견되었습니다: %1$s.  (0) 2025.09.29
설치된 XML 파서가 XML 버전 확인을 지원하지 않습니다. XML 파일은 유효한 XML 1.0 문서여야 합니다.  (0) 2025.09.29

비정상적인 DOCTYPE: 발견된 값은 "%1$s", 필요한 값은 "%2$s"입니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 29. 07:36

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

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

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

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

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

Irregular DOCTYPE: found "%1$s", expected "%2$s".

 

이 오류는 HTML/XHTML 파일의 가장 첫 부분에 있는 **DOCTYPE(문서 형식 선언)**이 EPUB 버전에 맞지 않게 잘못 작성되었음을 의미합니다.

DOCTYPE은 해당 문서가 어떤 버전의 HTML 규칙을 따라 만들어졌는지 전자책 뷰어에게 알려주는 '설명서'와 같습니다. 보드게임 상자에 "이 게임은 체스 3판 규칙을 따릅니다"라고 적어두는 것과 같죠. ♟️ 만약 규칙 설명서가 잘못되어 있으면, 게임(전자책)이 올바르게 보이지 않을 수 있습니다.

이 오류 메시지는 매우 친절하게도, 잘못된 부분(%1$s)과 올바른 값(%2$s)을 모두 알려줍니다.

## 해결 방법

해결 방법은 간단합니다. 오류 메시지가 알려준 대로 잘못된 DOCTYPE을 올바른 DOCTYPE으로 교체하면 됩니다.

  1. 오류가 발생한 HTML 또는 XHTML 파일을 텍스트 편집기에서 엽니다.
  2. 파일의 가장 윗부분에서 <!DOCTYPE ... > 으로 시작하는 줄을 찾습니다.
  3. 해당 줄 전체를 삭제하고, 오류 메시지의 '필요한 값(%2$s)'에 나온 내용으로 그대로 붙여넣습니다.

### 수정 예시

만약 EPUB 3 파일을 만들면서 실수로 오래된 EPUB 2 형식의 DOCTYPE을 사용했다면 오류가 발생합니다.

  • 수정 전 (오류 예시 - %1$s):
  • XML
     
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
  • 수정 후 (올바른 코드 - %2$s): ✅
  • XML
     
    <!DOCTYPE html>

참고: EPUB 버전별 올바른 DOCTYPE

  • EPUB 3 (XHTML5): <!DOCTYPE html>
  • EPUB 2 (XHTML 1.1): http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
반응형
저작자표시 비영리 변경금지 (새창열림)

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

ssml:ph 속성의 값이 비어 있거나 공백만으로 이루어져 있습니다.  (0) 2025.09.29
외부 참조가 발견되었습니다.  (0) 2025.09.29
EPUB v3 문서에서는 외부 엔티티가 허용되지 않습니다. 외부 엔티티 선언이 발견되었습니다: %1$s.  (0) 2025.09.29
설치된 XML 파서가 XML 버전 확인을 지원하지 않습니다. XML 파일은 유효한 XML 1.0 문서여야 합니다.  (0) 2025.09.29
XML 기반 미디어 유형인 모든 출판 리소스는 유효한 XML 1.0 문서여야 합니다. 발견된 XML 버전: %1$s.  (0) 2025.09.25

EPUB v3 문서에서는 외부 엔티티가 허용되지 않습니다. 외부 엔티티 선언이 발견되었습니다: %1$s.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 29. 07:34

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

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

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

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

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

External entities are not allowed in EPUB v3 documents. External entity declaration found: %1$s.

 

이 오류는 EPUB 파일 내부의 문서(주로 XHTML 파일)가 책 바깥의 다른 파일이나 인터넷 주소에서 내용을 가져오도록 설정되어 있음을 의미합니다. EPUB 3 표준에서는 보안과 안정성 문제로 이러한 '외부 참조'를 엄격히 금지합니다.

책의 특정 페이지에 "3장을 읽으려면, 도서관에 가서 XYZ 책을 빌려오세요"라고 적어두는 것과 같습니다. 📚 EPUB은 모든 내용이 하나의 파일 안에 완전히 포함되어 있어야 하며, 독자나 전자책 뷰어에게 외부에서 무언가를 가져오도록 요구할 수 없습니다.

## 외부 엔티티가 금지되는 이유

  • 보안 위험 🔐: 외부 파일이나 인터넷 주소에서 악성 코드를 불러오는 통로로 악용될 수 있습니다.
  • 독립성 원칙: EPUB 파일은 인터넷 연결 없이도 모든 기능이 완벽하게 작동해야 하는 '자체 완결형' 패키지입니다.
  • 안정성: 만약 참조하는 외부 웹사이트가 사라지거나 인터넷에 연결되어 있지 않으면, 책의 내용이 깨져 보이게 됩니다.

## 해결 방법

해결책은 외부 엔티티 선언을 삭제하고, 만약 해당 콘텐츠가 필요하다면 그 내용을 직접 파일 안에 포함시키는 것입니다.

  1. 오류가 발생한 XHTML 파일을 텍스트 편집기에서 엽니다.
  2. 파일의 상단에 있는 <!DOCTYPE ...> 선언 부분을 찾습니다.
  3. <!ENTITY ... SYSTEM "..." > 형식으로 작성된 외부 엔티티 선언 줄 전체를 삭제합니다.
  4. 만약 본문에서 해당 엔티티(예: &my-entity;)를 사용했다면, 그 부분을 외부 파일의 실제 내용으로 복사하여 붙여넣어야 합니다.

### 수정 예시

  • 수정 전 (오류 예시):
  • XML
     
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html [
  <!ENTITY external_chapter SYSTEM "http://example.com/chapter3.html">
]>
<html ... >
  <body>
    ...
    &external_chapter;
    ...
  </body>
</html>
  • 수정 후 (올바른 코드): ✅
  • XML
     
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html ... >
  <body>
    ...
    <h1>3장</h1>
    <p>이것은 3장의 내용입니다...</p>
    ...
  </body>
</html>
반응형
저작자표시 비영리 변경금지 (새창열림)

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

외부 참조가 발견되었습니다.  (0) 2025.09.29
비정상적인 DOCTYPE: 발견된 값은 "%1$s", 필요한 값은 "%2$s"입니다.  (0) 2025.09.29
설치된 XML 파서가 XML 버전 확인을 지원하지 않습니다. XML 파일은 유효한 XML 1.0 문서여야 합니다.  (0) 2025.09.29
XML 기반 미디어 유형인 모든 출판 리소스는 유효한 XML 1.0 문서여야 합니다. 발견된 XML 버전: %1$s.  (0) 2025.09.25
패키지 문서가 미디어 오버레이 스타일링 클래스 이름을 선언했지만, 콘텐츠 문서에서 해당 CSS를 찾을 수 없습니다.  (0) 2025.09.25

설치된 XML 파서가 XML 버전 확인을 지원하지 않습니다. XML 파일은 유효한 XML 1.0 문서여야 합니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 29. 07:31

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

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

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

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

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

The installed xml parser doesn’t support xml version verification. Xml files must be a valid XML 1.0 document.

 

 

이것은 EPUB 파일 자체의 오류라기보다는, EPUBCheck 프로그램을 실행하는 사용자의 PC 환경(주로 Java)에 대한 경고 메시지입니다.

쉽게 말해, EPUBCheck가 "제가 사용하는 XML 분석 도구가 구형이라 파일의 XML 버전을 자동으로 확인하는 기능이 작동하지 않습니다. 그러니 제작자께서 직접 모든 XML 파일이 버전 1.0 규칙을 지켰는지 확인해주셔야 합니다." 라고 알려주는 것입니다.

집을 점검하러 온 검사관의 특정 장비가 고장나서, "제 장비 문제로 이 부분은 검사할 수 없으니, 집주인께서 직접 규정에 맞는지 확인해주세요"라고 말하는 것과 같습니다. 🛠️

## 해결 방법

이 메시지는 EPUBCheck 프로그램의 한계를 알려주는 것이므로, 사용자는 직접 파일들을 확인하여 규칙을 준수했는지 검토해야 합니다.

  1. EPUB에 포함된 모든 XML 기반 파일들(XHTML, OPF, NCX 등)을 엽니다.
  2. 각 파일의 가장 첫 번째 줄에 XML 선언이 올바르게 작성되어 있는지 확인합니다.
  3. 아래와 같이 version="1.0"으로 명시되어 있는지 다시 한번 점검합니다. 만약 다른 버전으로 되어 있다면 1.0으로 수정합니다.
  4. XML
     
    <?xml version="1.0" encoding="UTF-8"?>

이 규칙만 잘 지켜졌다면, 이 경고 메시지는 무시해도 괜찮습니다. 또는, 최신 버전의 Java를 설치하면 이 경고가 사라질 수도 있습니다.

반응형
저작자표시 비영리 변경금지 (새창열림)

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

비정상적인 DOCTYPE: 발견된 값은 "%1$s", 필요한 값은 "%2$s"입니다.  (0) 2025.09.29
EPUB v3 문서에서는 외부 엔티티가 허용되지 않습니다. 외부 엔티티 선언이 발견되었습니다: %1$s.  (0) 2025.09.29
XML 기반 미디어 유형인 모든 출판 리소스는 유효한 XML 1.0 문서여야 합니다. 발견된 XML 버전: %1$s.  (0) 2025.09.25
패키지 문서가 미디어 오버레이 스타일링 클래스 이름을 선언했지만, 콘텐츠 문서에서 해당 CSS를 찾을 수 없습니다.  (0) 2025.09.25
CSS 클래스 이름 "%1$s"을(를) 찾았지만, 패키지 문서에 "%2$s" 속성이 선언되지 않았습니다.  (0) 2025.09.25

XML 기반 미디어 유형인 모든 출판 리소스는 유효한 XML 1.0 문서여야 합니다. 발견된 XML 버전: %1$s.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 25. 09:01

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

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

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

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

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

Any publication resource that is an XML-based media type must be a valid XML 1.0 document. XML version found: %1$s.

 

이 오류는 EPUB을 구성하는 핵심 파일(XHTML, OPF, NCX 파일 등)의 가장 첫 줄에 있는 XML 선언의 버전 번호가 잘못되었음을 의미합니다.

EPUB 표준은 XML 버전 1.0의 규칙을 기반으로 만들어졌습니다. 이는 모든 관련 파일이 자신을 "XML 1.0" 문서라고 명시해야 함을 의미하는 엄격한 규칙입니다.

법률 계약서의 첫 줄에 '이 문서는 2010년의 법률을 따른다'고 명시하는 것과 같습니다. 📜 이 오류는 문서가 EPUB이 따르기로 약속한 '2010년의 법'이 아닌, 다른 버전의 법(예: %1$s)을 따르겠다고 잘못 선언한 것과 같은 상황입니다.

## 해결 방법

해결 방법은 매우 간단합니다. 문제가 발생한 파일의 첫 줄에서 버전 번호를 1.0으로 수정하면 됩니다.

  1. EPUBCheck 보고서에서 오류가 발생한 파일의 이름을 확인합니다.
  2. 해당 파일을 텍스트 편집기나 EPUB 편집기에서 엽니다.
  3. 파일의 가장 첫 번째 줄을 확인합니다.
  4. version="..." 부분의 값을 1.0으로 변경합니다.

### 수정 예시

  • 수정 전 (오류 예시):
  • XML
     
    <?xml version="1.1" encoding="UTF-8"?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
...
</html>
  • 수정 후 (올바른 코드): ✅
  • XML
     
    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
...
</html>
반응형
저작자표시 비영리 변경금지 (새창열림)

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

EPUB v3 문서에서는 외부 엔티티가 허용되지 않습니다. 외부 엔티티 선언이 발견되었습니다: %1$s.  (0) 2025.09.29
설치된 XML 파서가 XML 버전 확인을 지원하지 않습니다. XML 파일은 유효한 XML 1.0 문서여야 합니다.  (0) 2025.09.29
패키지 문서가 미디어 오버레이 스타일링 클래스 이름을 선언했지만, 콘텐츠 문서에서 해당 CSS를 찾을 수 없습니다.  (0) 2025.09.25
CSS 클래스 이름 "%1$s"을(를) 찾았지만, 패키지 문서에 "%2$s" 속성이 선언되지 않았습니다.  (0) 2025.09.25
@font-face 선언 사용.  (0) 2025.09.25

티스토리툴바