내맘대로의 EPUB 제작 가이드

기초부터 전자책 제작 실습까지

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 프로그램의 한계를 알려주는 것이므로, 사용자는 직접 파일들을 확인하여 규칙을 준수했는지 검토해야 합니다.

EPUB에 포함된 모든 XML 기반 파일들(XHTML, OPF, NCX 등)을 엽니다.
각 파일의 가장 첫 번째 줄에 XML 선언이 올바르게 작성되어 있는지 확인합니다.
아래와 같이 version="1.0"으로 명시되어 있는지 다시 한번 점검합니다. 만약 다른 버전으로 되어 있다면 1.0으로 수정합니다.
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년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

EPUBGUIDE.NET의 핵심만 모았다. 전자책 편집자를 위한 필독서!

클릭 편집 탬플릿 제공,

기초부터 전자책 제작 실습까지

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으로 수정하면 됩니다.

EPUBCheck 보고서에서 오류가 발생한 파일의 이름을 확인합니다.
해당 파일을 텍스트 편집기나 EPUB 편집기에서 엽니다.
파일의 가장 첫 번째 줄을 확인합니다.
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

패키지 문서가 미디어 오버레이 스타일링 클래스 이름을 선언했지만, 콘텐츠 문서에서 해당 CSS를 찾을 수 없습니다.

EPUB 제작의 기초/EPUBCheck 오류

posted by 내.맘.대.로 2025. 9. 25. 09:00

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

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

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

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

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

EPUBGUIDE.NET의 핵심만 모았다. 전자책 편집자를 위한 필독서!

클릭 편집 탬플릿 제공,

기초부터 전자책 제작 실습까지

The package document declares media overlays styling class names but no CSS was found in the content document.

EPUB의 종합 설명서인 .opf 파일에는 특정 CSS 파일을 '미디어 오버레이(소리 내어 읽기)' 전용이라고 지정(properties="media-overlay-style")했는데, 정작 그 CSS 파일을 열어보니 오디오 재생 중에 텍스트를 강조하는 데 필요한 핵심 CSS 클래스(예: .epub-media-overlay-active)가 없다는 의미입니다.

무대 감독(.opf 파일)에게 '조명 지시서'라고 알려준 종이를 확인해 보니, 정작 중요한 특수 조명에 대한 내용이 빠져있는 것과 같습니다. 📝

## 해결 방법

이 문제는 두 가지 경우 중 하나에 해당하며, 원인에 따라 해결 방법이 다릅니다.

### 경우 1: .opf 파일의 선언이 잘못된 경우

실수나 혼동으로 미디어 오버레이와 관련 없는 일반 스타일시트에 properties="media-overlay-style" 속성을 잘못 추가했을 수 있습니다.

해결책: .opf 파일을 열어 <manifest> 안을 확인하고, 잘못 지정된 <item> 태그에서 properties="media-overlay-style" 속성을 삭제합니다.
수정 예시 (.opf 파일):▼

XML

<item id="main-css" href="css/main-style.css" media-type="text/css" />

XML

<item id="main-css" href="css/main-style.css" media-type="text/css" properties="media-overlay-style" />

### 경우 2: CSS 파일에 스타일이 누락된 경우

.opf 파일의 선언은 올바르지만, 해당 CSS 파일에 미디어 오버레이용 클래스 스타일을 추가하는 것을 잊었을 수 있습니다.

해결책: .opf 파일에 지정된 CSS 파일을 열고, 미디어 오버레이 활성 클래스에 대한 스타일 규칙을 추가합니다. (기본 클래스 이름: epub-media-overlay-active)
수정 예시 (CSS 파일):▼

CSS

/* 하이라이트 스타일을 추가하여 수정 */
.epub-media-overlay-active {
  background-color: yellow;
}

CSS

/* 파일이 비어있거나 관련 스타일이 없는 경우 */

자신의 EPUB 파일이 위 두 경우 중 어디에 해당하는지 확인하고, 그에 맞는 방법으로 수정하면 오류를 해결할 수 있습니다.

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

설치된 XML 파서가 XML 버전 확인을 지원하지 않습니다. XML 파일은 유효한 XML 1.0 문서여야 합니다. (0)	2025.09.29
XML 기반 미디어 유형인 모든 출판 리소스는 유효한 XML 1.0 문서여야 합니다. 발견된 XML 버전: %1$s. (0)	2025.09.25
CSS 클래스 이름 "%1$s"을(를) 찾았지만, 패키지 문서에 "%2$s" 속성이 선언되지 않았습니다. (0)	2025.09.25
@font-face 선언 사용. (0)	2025.09.25
CSS @font-face 선언에 속성이 없습니다. (0)	2025.09.25

CSS 클래스 이름 "%1$s"을(를) 찾았지만, 패키지 문서에 "%2$s" 속성이 선언되지 않았습니다.

EPUB 제작의 기초/EPUBCheck 오류

posted by 내.맘.대.로 2025. 9. 25. 08:59

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

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

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

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

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

EPUBGUIDE.NET의 핵심만 모았다. 전자책 편집자를 위한 필독서!

클릭 편집 탬플릿 제공,

기초부터 전자책 제작 실습까지

Found CSS class name "%1$s" but no "%2$s" property was declared in the package document.

이 오류는 미디어 오버레이(Media Overlays), 즉 '소리 내어 읽기' 기능과 관련된 문제입니다.

오류의 의미는, 오디오 재생에 맞춰 텍스트를 강조하는 등 특별한 스타일을 담은 CSS 파일이 있지만, 이 CSS 파일이 미디어 오버레이 전용이라는 사실을 EPUB의 종합 설명서인 .opf 파일에 등록하지 않았다는 것입니다.

## 해결 방법

이 문제는 CSS 파일이 아닌 .opf 파일을 수정해야 해결됩니다.

EPUB 프로젝트의 .opf 파일을 엽니다. (보통 content.opf 또는 package.opf 라는 이름입니다.)
파일 안에서 <manifest> 부분을 찾습니다.
<manifest> 안에서 미디어 오버레이용 스타일이 포함된 CSS 파일에 해당하는 <item> 태그를 찾습니다.
해당 <item> 태그에 properties="media-overlay-style" 속성을 추가합니다.

### 수정 예시

수정 전 .opf 파일:

XML

<manifest>
  ...
  <item id="mo-styles" href="css/readaloud.css" media-type="text/css" />
  ...
</manifest>

수정 후 .opf 파일: ✅

XML

<manifest>
  ...
  <item id="mo-styles" href="css/readaloud.css" media-type="text/css" properties="media-overlay-style" />
  ...
</manifest>

이렇게 properties 속성을 추가하면, 전자책 시스템은 해당 CSS 파일을 미디어 오버레이 기능의 일부로 올바르게 인식하게 됩니다.