EPUB 제작의 기초/EPUBCheck 오류

제공된 DOCTYPE은 구식이거나 비정상적이므로 삭제할 수 있습니다.

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

The DOCTYPE provided is obsolete or irregular and can be removed.

 

 

이 메시지는 수정이 시급한 오류라기보다는, 코드 품질 개선을 위한 제안 또는 경고입니다.

의미는 파일 상단에 선언된 DOCTYPE이 오래된 구식 버전이거나 비표준 형식이어서, 현대적인 EPUB 3(HTML5) 환경에서는 더 이상 필요 없거나 의미가 없으므로 삭제해도 좋다는 뜻입니다.


## "삭제할 수 있다"는 말의 정확한 의미

여기서 '삭제할 수 있다'는 말은 DOCTYPE 선언 자체를 아예 없애라는 뜻이 아닙니다. 📜 이는 매우 중요한 점입니다. EPUB 3 문서는 반드시 <!DOCTYPE html> 선언을 가져야 합니다.

이 메시지의 정확한 의도는 "지금 사용하고 계신 구식의 복잡한 DOCTYPE은 불필요하니 삭제하고, 올바른 최신 DOCTYPE으로 교체하거나 그것만 남겨두라"는 의미입니다.


## 해결 방법

  1. 경고가 발생한 HTML/XHTML 파일을 엽니다.
  2. 파일의 가장 윗부분에서 <!DOCTYPE ...>으로 시작하는 줄을 찾습니다.
  3. 발견된 구식의 길고 복잡한 DOCTYPE 선언을 삭제합니다.
  4. 파일이 EPUB 3 표준을 따른다면, 그 자리에 아래의 간단한 DOCTYPE이 있는지 확인하고, 없다면 추가합니다.

### 수정 예시

  • 수정 전 (경고 발생 예시 - HTML 4.01의 구식 DOCTYPE):
  • XML
     
    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    <html>
      ...
    </html>
    
  • 수정 후 (올바른 EPUB 3 DOCTYPE):
  • XML
     
    <!DOCTYPE html>
    <html>
      ...
    </html>
    

결론적으로, EPUB 3 파일에서는 복잡한 구식 DOCTYPE을 제거하고, 오직 <!DOCTYPE html> 선언 하나만 남겨두는 것이 올바른 방법입니다.

반응형