@font-face 참조 "%1$s"이(가) 비표준 글꼴 유형 "%2$s"을(를) 참조합니다.

Font-face reference "%1$s" refers to non-standard font type "%2$s".

 

이 오류는 CSS의 @font-face 규칙을 통해 EPUB에 글꼴(폰트)을 포함시켰지만, 그 글꼴 파일의 형식이 EPUB 표준에서 공식적으로 지원하지 않는 비표준 형식이라는 의미입니다. 🔤

---

## 왜 글꼴 형식이 중요한가요?

EPUB은 호환성을 매우 중요하게 생각합니다. 어떤 전자책 뷰어에서든 책이 동일하게 보이도록 하기 위해, 모든 뷰어가 반드시 지원해야 하는 '공식 글꼴 형식'을 지정해 두었습니다. 이 목록에 없는 형식을 사용하면 일부 기기에서는 글꼴이 적용되지 않고 기본 글꼴로 보이게 됩니다.

### EPUB 공식 지원 글꼴 형식

EPUB 3 표준에서 안정적으로 지원되는 글꼴 형식은 다음과 같습니다.

• WOFF2 (.woff2)
• WOFF (.woff)
• OpenType (.otf)
• TrueType (.ttf)

오류 메시지에 나온 %2$s는 위 목록에 없는 형식(예: .svg, .eot)일 가능성이 높습니다.

---

## 해결 방법

해결책은 비표준 형식의 글꼴 파일을 표준 형식(가급적 WOFF2 또는 WOFF)으로 변환하는 것입니다.

1. 글꼴 변환하기 Font Squirrel Webfont Generator나 CloudConvert와 같은 무료 온라인 글꼴 변환 서비스를 이용하세요. 가지고 있는 비표준 글꼴 파일(예: myfont.svg)을 업로드하여 표준 형식(예: myfont.woff2)으로 변환합니다.
2. EPUB 파일 교체하기 기존의 비표준 글꼴 파일을 EPUB에서 삭제하고, 새로 변환한 표준 글꼴 파일을 추가합니다.
3. CSS 파일 수정하기 @font-face 규칙에서 참조하는 파일 이름을 새 파일 이름으로 변경합니다.
   • 수정 전:
   • CSS

      

     @font-face {
       font-family: 'MyWebFont';
       src: url('../fonts/myfont.svg');
     }
     

   • 수정 후: ✅
   • CSS

      

     @font-face {
       font-family: 'MyWebFont';
       src: url('../fonts/myfont.woff2');
     }
     

4. OPF 파일 확인하기 (중요) EPUB의 .opf 파일 안에 있는 <manifest> 목록에서 해당 글꼴 항목의 href (파일 경로)와 media-type (파일 종류)이 올바르게 수정되었는지 확인해야 합니다.
   • .woff 파일의 media-type은 font/woff 입니다.
   • .woff2 파일의 media-type은 font/woff2 입니다.
   • .otf 파일의 media-type은 font/otf 입니다.
   • .ttf 파일의 media-type은 font/ttf 입니다.