콘텐츠 문서가 시맨틱(의미론적) 특성을 부여하기 위해 "epub:type" 속성을 사용하지 않았습니다.

 

Content Documents do not use "epub:type" attributes for semantic inflection.

 

오류 의미

이 메시지는 전자책의 HTML 문서 본문에 epub:type이라는 속성이 사용되지 않았다는 뜻입니다.

쉽게 비유하자면, 책의 내용은 잘 들어가 있지만, 어떤 부분이 **'표지'**인지, 어떤 부분이 **'목차'**인지, 그리고 어디서부터가 진짜 **'본문'**의 시작인지 컴퓨터(전자책 리더기, 스크린 리더 등)에게 정확히 알려주는 **'꼬리표'**가 붙어있지 않다는 의미입니다.

epub:type은 바로 이 '꼬리표' 역할을 하는 속성입니다. 이 꼬리표를 붙여주면 전자책을 읽어주는 프로그램이 책의 구조를 더 잘 이해하게 되어, 시각장애인을 위한 스크린 리더 기능이 향상되고 검색 기능이 정확해지는 등 전자책의 접근성과 기능성이 전반적으로 좋아집니다.

---

해결 방법

책의 각 구성 요소에 맞는 epub:type 꼬리표(속성)를 해당 HTML 태그에 추가해주면 됩니다. HTML을 전혀 모르시더라도, 전자책 편집 프로그램(예: Sigil)의 코드 보기 기능을 이용해 간단히 수정할 수 있습니다.

1. 책의 주요 구성 요소 파악하기

먼저 내 책이 어떤 부분들로 이루어져 있는지 파악합니다. (예: 표지, 제목 페이지, 목차, 서문, 본문 챕터들, 참고 문헌 등)

2. 올바른 epub:type 꼬리표 찾기

각 구성 요소에 맞는 표준 epub:type 꼬리표(값)들이 정해져 있습니다. 자주 사용하는 것들은 다음과 같습니다.

• cover: 표지 이미지
• titlepage: 제목, 저자, 출판사 정보가 담긴 페이지
• toc: 목차
• preface: 서문, 머리말
• bodymatter: 본문 전체를 감싸는 영역
•  
• chapter: 각 장 (챕터)
• acknowledgments: 감사의 말
• bibliography: 참고 문헌
• footnote: 각주 내용
• page-list: 종이책 페이지 번호 목록

3. HTML 코드에 epub:type 속성 추가하기

각 구성 요소를 감싸고 있는 HTML 태그(주로 <section>이나 <div> 태그)에 epub:type 속성을 추가합니다.

수정 예시 1: 챕터(Chapter) 표시하기

챕터 하나를 감싸고 있는 <section> 태그를 찾아서 다음과 같이 수정합니다.

• 수정 전:
• HTML

  <section>
    <h2>제1장 새로운 시작</h2>
    <p>이야기는 이렇게 시작됩니다...</p>
  </section>
  

• 수정 후:
• HTML

  <section epub:type="chapter">
    <h2>제1장 새로운 시작</h2>
    <p>이야기는 이렇게 시작됩니다...</p>
  </section>
  

수정 예시 2: 목차(Table of Contents) 표시하기

목차를 감싸고 있는 <nav> 태그에 다음과 같이 epub:type 속성을 추가합니다.

• 수정 전:
• HTML

  <nav>
    <h1>목차</h1>
    <ol>
      <li><a href="chapter1.xhtml">제1장</a></li>
      <li><a href="chapter2.xhtml">제2장</a></li>
    </ol>
  </nav>
  

• 수정 후:
• HTML

  <nav epub:type="toc">
    <h1>목차</h1>
    <ol>
      <li><a href="chapter1.xhtml">제1장</a></li>
      <li><a href="chapter2.xhtml">제2장</a></li>
    </ol>
  </nav>
  

이처럼 책의 모든 구조적 요소(서문, 각 챕터, 감사의 말 등)에 해당하는 태그를 찾아 알맞은 epub:type 꼬리표를 붙여주면 오류 메시지가 사라지고, 훨씬 더 품질 좋은 전자책이 됩니다.