EPUB 제작의 기초/EPUBCheck 오류
href에서 등록되지 않은 URI 스킴(scheme) 유형이 발견되었습니다.
내.맘.대.로
2025. 9. 29. 07:48
Non-registered URI scheme type found in href.
이 오류는 문서에 포함된 링크(href 속성)가 인식할 수 없거나 허용되지 않는 프로토콜, 즉 **'스킴(scheme)'**으로 시작하고 있음을 의미합니다.
링크(URI)에서 '스킴'은 맨 앞에 위치하여 해당 링크의 종류를 알려주는 부분입니다(예: http:, mailto:, ftp:). 우편 주소의 '우편 서비스 종류(예: FedEx, 우체국 택배)'와 같습니다. 📬 전자책 뷰어는 정해진 종류의 '우편 서비스(스킴)'만 이해할 수 있는데, 알 수 없는 종류의 링크를 발견했을 때 이 오류를 보고합니다.
## 유효한 스킴과 잘못된 스킴
- 일반적으로 허용되는 스킴:
- http://, https://: 웹사이트 주소
- mailto:: 이메일 주소
- 상대 경로 (../images/pic.jpg): EPUB 내부 파일을 연결하는 가장 좋은 방법
- 오류를 유발하는 흔한 스킴:
- 오타: htp:// (→ http://로 수정해야 함)
- file:///: 사용자의 컴퓨터에 있는 로컬 파일을 직접 연결하는 방식으로, 보안상의 이유로 EPUB에서 엄격히 금지됩니다.
- 사용자 정의 스킴: myapp://, spotify:// 등 특정 애플리케이션을 실행하기 위한 스킴은 표준이 아니므로 허용되지 않습니다.
## 해결 방법
- 오류가 발생한 파일에서 href="..." 속성을 찾습니다.
- 링크 주소의 가장 앞부분, 즉 : 앞의 스킴을 확인합니다.
- 아래의 경우에 따라 수정합니다.
- 단순 오타인 경우, 올바른 스킴(예: http://)으로 수정합니다.
- file:///과 같이 허용되지 않는 스킴인 경우, 해당 링크를 완전히 삭제하거나, 웹에서 접근 가능한 주소가 있다면 안전한 https:// 링크로 교체해야 합니다.
### 수정 예시
- 수정 전 (오류 예시):
-
HTML
<a href="htp://google.com">링크</a> <a href="file:///C:/Users/User/Documents/report.pdf">보고서 보기</a>
- 수정 후 (올바른 코드): ✅
-
HTML
<a href="http://google.com">링크</a> <p>보고서 보기 (로컬 파일 링크는 제거해야 합니다)</p>
반응형