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

내.맘.대.로 2025. 9. 25. 09:01

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

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>