패키지 문서가 미디어 오버레이 스타일링 클래스 이름을 선언했지만, 콘텐츠 문서에서 해당 CSS를 찾을 수 없습니다.

The package document declares media overlays styling class names but no CSS was found in the content document.

 

EPUB의 종합 설명서인 .opf 파일에는 특정 CSS 파일을 '미디어 오버레이(소리 내어 읽기)' 전용이라고 지정(properties="media-overlay-style")했는데, 정작 그 CSS 파일을 열어보니 오디오 재생 중에 텍스트를 강조하는 데 필요한 핵심 CSS 클래스(예: .epub-media-overlay-active)가 없다는 의미입니다.

무대 감독(.opf 파일)에게 '조명 지시서'라고 알려준 종이를 확인해 보니, 정작 중요한 특수 조명에 대한 내용이 빠져있는 것과 같습니다. 📝

---

## 해결 방법

이 문제는 두 가지 경우 중 하나에 해당하며, 원인에 따라 해결 방법이 다릅니다.

### 경우 1: .opf 파일의 선언이 잘못된 경우

실수나 혼동으로 미디어 오버레이와 관련 없는 일반 스타일시트에 properties="media-overlay-style" 속성을 잘못 추가했을 수 있습니다.

• 해결책: .opf 파일을 열어 <manifest> 안을 확인하고, 잘못 지정된 <item> 태그에서 properties="media-overlay-style" 속성을 삭제합니다.
• 수정 예시 (.opf 파일):▼
• XML

   

  <item id="main-css" href="css/main-style.css" media-type="text/css" />
  

• XML

   

  <item id="main-css" href="css/main-style.css" media-type="text/css" properties="media-overlay-style" />
  

---

### 경우 2: CSS 파일에 스타일이 누락된 경우

.opf 파일의 선언은 올바르지만, 해당 CSS 파일에 미디어 오버레이용 클래스 스타일을 추가하는 것을 잊었을 수 있습니다.

• 해결책: .opf 파일에 지정된 CSS 파일을 열고, 미디어 오버레이 활성 클래스에 대한 스타일 규칙을 추가합니다. (기본 클래스 이름: epub-media-overlay-active)
• 수정 예시 (CSS 파일):▼
• CSS

   

  /* 하이라이트 스타일을 추가하여 수정 */
  .epub-media-overlay-active {
    background-color: yellow;
  }
  

• CSS

   

  /* 파일이 비어있거나 관련 스타일이 없는 경우 */
  

자신의 EPUB 파일이 위 두 경우 중 어디에 해당하는지 확인하고, 그에 맞는 방법으로 수정하면 오류를 해결할 수 있습니다.