내맘대로의 EPUB 제작 가이드

Rule %1$s is under review and its severity may change in a future release. See the discussion at %2$s

오류 의미

이 메시지는 사용자의 전자책 파일에 오류가 있다는 뜻이 아닙니다.

이것은 EPUBCheck라는 검사 프로그램 개발자들이 사용자에게 보내는 **'정보성 안내 메시지'**입니다.

쉽게 말해, "당신의 파일에서 발견된 특정 규칙(%1$s 부분)은 저희 개발자들이 현재 재검토하고 있습니다. 그래서 다음 버전의 EPUBCheck 프로그램에서는 이 규칙의 심각도(단순 경고인지, 심각한 오류인지)가 변경될 수 있습니다. 더 자세한 논의 내용이 궁금하시면 여기 주소(%2$s 부분)를 방문해주세요." 라는 의미입니다.

보통 이 메시지는 실제 오류나 경고 메시지 바로 아래에 함께 표시됩니다.

핵심 요약:

• 이 줄 자체는 오류가 아닙니다.
• 함께 표시된 다른 오류/경고 규칙이 현재 개발자들 사이에서 논의 중이라는 것을 알려주는 공지사항입니다.

해결 방법

이 메시지에 대해서는 아무것도 수정할 필요가 없습니다.

이 메시지는 무시하시고, 이 메시지와 함께 나온 실제 오류 또는 경고 메시지에 집중하여 그 문제를 해결해야 합니다.

예시:

만약 EPUBCheck 검사 결과가 아래와 같이 나왔다고 가정해 보겠습니다.

1. 경고(CSS-008): style.css 파일에서 접두사가 없는 CSS 속성을 사용해야 합니다.
2. 정보(INFO_001): 'CSS-008' 규칙은 현재 검토 중이며...

이 경우, 우리가 신경 써야 할 것은 2번 정보 메시지가 아니라 1번 경고 메시지입니다. style.css 파일의 문제를 해결하면, 1번 경고 메시지가 사라지면서 2번 정보 메시지도 자연스럽게 함께 사라지게 됩니다.

따라서 이 메시지가 보이면, '아, 내가 해결해야 할 저 오류가 나중에 기준이 바뀔 수도 있구나' 정도로만 이해하고, 함께 나온 실제 오류를 해결하는 데에만 집중하시면 됩니다.

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 꼬리표를 붙여주면 오류 메시지가 사라지고, 훨씬 더 품질 좋은 전자책이 됩니다.