"epub" 접두사에 네임스페이스 "%1$s"은(는) 일반적이지 않습니다.

내.맘.대.로 2025. 9. 29. 07:42

Namespace "%1$s" is unusual for the prefix "epub".

이 오류는 XHTML 파일 상단에 선언된 네임스페이스(namespace) 정보가 잘못되었음을 의미합니다.

네임스페이스는 EPUB의 특정 기능(예: epub:type)을 사용할 때, epub:이라는 접두사가 어떤 규칙 사전을 따라야 하는지 알려주는 '신분증'과 같습니다. epub:이라는 접두사는 EPUB 표준에서 사용하는 특별 예약어이므로, 반드시 공식적으로 지정된 '신분증' 주소와 연결되어야 합니다.

논문에서 저자를 인용하는 것과 비슷합니다. 📚 'Kim(2020)'이라고 짧게 인용(접두사)할 때, 이 'Kim'이 '서울에 사는 김민준'이라는 완전한 정보(네임스페이스)와 일치해야 합니다. 이 오류는 'Kim(2020)'이라고 인용해놓고, 신분증 정보에는 '부산에 사는 박서준'이라고 잘못 연결한 것과 같은 상황입니다.

## 해결 방법

해결 방법은 간단합니다. 잘못된 네임스페이스 주소를 올바른 공식 주소로 바꿔주면 됩니다.

오류가 발생한 XHTML 파일을 텍스트 편집기에서 엽니다.
파일의 가장 윗부분에 있는 <html> 태그를 찾습니다.
<html> 태그 안에서 xmlns:epub="..." 속성을 찾습니다.
따옴표 안의 잘못된 주소(%1$s)를 아래의 올바른 공식 주소로 교체합니다.

epub 접두사의 올바른 네임스페이스 주소:

http://www.idpf.org/2007/ops

## 수정 예시

수정 전 (오류 예시):

XML

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:epub="http://www.example.com/wrong-epub-namespace">

수정 후 (올바른 코드): ✅

XML

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:epub="http://www.idpf.org/2007/ops">

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