내맘대로의 EPUB 제작 가이드

기초부터 전자책 제작 실습까지

Use of Font-face declaration.

이것은 수정이 필요한 오류나 경고가 아니라, 단순히 정보를 알려주는 안내 메시지입니다. 📢

이 메시지는 EPUBCheck가 당신의 CSS 파일에서 @font-face 규칙을 발견했음을 알려주는 것입니다. @font-face는 EPUB에 사용자 정의 글꼴을 포함시키는 올바르고 표준적인 방법이므로, 코드가 정상적으로 인식되었다는 의미입니다.

## 조치 방법

아무것도 할 필요가 없습니다. 다른 글꼴 관련 오류가 없다면 이 안내 메시지는 안심하고 무시하셔도 됩니다.

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

패키지 문서가 미디어 오버레이 스타일링 클래스 이름을 선언했지만, 콘텐츠 문서에서 해당 CSS를 찾을 수 없습니다. (0)	2025.09.25
CSS 클래스 이름 "%1$s"을(를) 찾았지만, 패키지 문서에 "%2$s" 속성이 선언되지 않았습니다. (0)	2025.09.25
CSS @font-face 선언에 속성이 없습니다. (0)	2025.09.25
대체 스타일시트에는 title(제목)이 있어야 합니다. (0)	2025.09.25
CSS를 파싱하는 중 오류가 발생했습니다: %1$s. CSS 파일의 어딘가에 오타나 문법 오류가 있습니다. (0)	2025.09.25

CSS @font-face 선언에 속성이 없습니다.

EPUB 제작의 기초/EPUBCheck 오류

posted by 내.맘.대.로 2025. 9. 25. 08:52

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

EPUBGUIDE.NET의 핵심만 모았다. 전자책 편집자를 위한 필독서!

클릭 편집 탬플릿 제공,

기초부터 전자책 제작 실습까지

CSS font-face declaration has no attributes.

이 오류는 CSS 파일에 글꼴(폰트)을 포함시키기 위한 @font-face 규칙이 선언되었지만, 그 내용이 비어있다는 의미입니다.

@font-face는 EPUB에 사용자 정의 글꼴을 포함시킬 때 사용하는 필수적인 코드 블록입니다. 하지만 내용이 비어있으면, 어떤 글꼴을 어떻게 불러와야 할지 알 수 없어 오류가 발생합니다.

이는 내용물이 무엇인지, 이름이 무엇인지 적혀있지 않은 텅 빈 라벨과 같습니다. 🏷️

## @font-face의 필수 속성

유효한 @font-face 규칙이 되려면 최소한 다음 두 가지 정보(속성)가 반드시 포함되어야 합니다.

font-family: 포함시킬 글꼴에 붙여줄 이름입니다. 나중에 CSS의 다른 부분에서 이 이름을 사용하여 글꼴을 적용합니다.
src: 불러올 실제 글꼴 파일의 경로와 파일명입니다.

## 해결 방법

두 가지 방법 중 하나를 선택하여 해결할 수 있습니다.

1. 규칙 완성하기 만약 사용자 정의 글꼴을 포함시키려던 것이 맞다면, 비어있는 @font-face 블록 안에 필수 속성인 font-family와 src를 추가하여 규칙을 완성해야 합니다.

오류가 발생하는 코드:
CSS
```
@font-face {
}
```
올바르게 수정한 코드: ✅

CSS

@font-face {
  font-family: "NanumMyeongjo";
  src: url("../fonts/NanumMyeongjo.woff2");
}

2. 불필요한 코드 삭제하기 만약 @font-face 규칙이 필요 없다면 (예: 이전에 사용했다가 지운 흔적이거나, 템플릿에 포함된 불필요한 코드), @font-face { } 코드 블록 전체를 삭제하는 것이 가장 좋습니다.

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

CSS 클래스 이름 "%1$s"을(를) 찾았지만, 패키지 문서에 "%2$s" 속성이 선언되지 않았습니다. (0)	2025.09.25
@font-face 선언 사용. (0)	2025.09.25
대체 스타일시트에는 title(제목)이 있어야 합니다. (0)	2025.09.25
CSS를 파싱하는 중 오류가 발생했습니다: %1$s. CSS 파일의 어딘가에 오타나 문법 오류가 있습니다. (0)	2025.09.25
@font-face 참조 "%1$s"이(가) 비표준 글꼴 유형 "%2$s"을(를) 참조합니다. (0)	2025.09.25

대체 스타일시트에는 title(제목)이 있어야 합니다.

EPUB 제작의 기초/EPUBCheck 오류

posted by 내.맘.대.로 2025. 9. 25. 08:51

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

EPUBGUIDE.NET의 핵심만 모았다. 전자책 편집자를 위한 필독서!

클릭 편집 탬플릿 제공,

기초부터 전자책 제작 실습까지

Alternative style sheets must have a title.

이 오류는 CSS 파일을 독자가 선택할 수 있는 '대체 테마'로 지정(rel="alternate stylesheet")했지만, 그 테마의 이름을 정하는 title 속성을 빠뜨렸을 때 발생합니다.

메뉴판에 '오늘의 특별요리'라고만 적고 정작 요리 이름은 적지 않은 것과 같습니다. 🍽️ 사용자는 선택지가 있다는 것은 알지만, 그것이 무엇인지 알 수 없습니다.

## title 속성이 필수인 이유

독자가 전자책 뷰어의 설정 메뉴에서 '낮 모드'나 '밤 모드' 같은 테마를 선택할 때, 메뉴에 표시되는 이름이 바로 title 속성에 적힌 텍스트입니다.

title이 없으면 뷰어는 사용자에게 테마 선택지를 보여줄 수 없으므로, rel="alternate stylesheet"로 지정된 스타일시트에는 title 속성이 반드시 필요합니다.

## 해결 방법

해결 방법은 간단합니다. 문제가 되는 <link> 태그에 title 속성을 추가하여 테마의 이름을 명확하게 적어주면 됩니다.

오류가 발생하는 코드:➡️ rel이 'alternate stylesheet'인데 title이 없어 오류가 발생합니다.

HTML

<head>
  ...
  <link href="night.css" rel="alternate stylesheet" type="text/css" />
  ...
</head>

올바르게 수정한 코드: ✅➡️ 이제 뷰어는 '어두운 테마'라는 이름으로 이 스타일을 독자에게 제공할 수 있습니다.

HTML

<head>
  ...
  <link href="night.css" rel="alternate stylesheet" type="text/css" title="어두운 테마" />
  ...
</head>

'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글

@font-face 선언 사용. (0)	2025.09.25
CSS @font-face 선언에 속성이 없습니다. (0)	2025.09.25
CSS를 파싱하는 중 오류가 발생했습니다: %1$s. CSS 파일의 어딘가에 오타나 문법 오류가 있습니다. (0)	2025.09.25
@font-face 참조 "%1$s"이(가) 비표준 글꼴 유형 "%2$s"을(를) 참조합니다. (0)	2025.09.25
CSS 선택자가 고정된 위치(fixed position)를 지정합니다. (0)	2025.09.25

CSS를 파싱하는 중 오류가 발생했습니다: %1$s. CSS 파일의 어딘가에 오타나 문법 오류가 있습니다.

EPUB 제작의 기초/EPUBCheck 오류

posted by 내.맘.대.로 2025. 9. 25. 08:50

내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.

종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.

한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다.

자세한 내용은 여기로: https://www.epubguide.net/notice/309

오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.

EPUBGUIDE.NET의 핵심만 모았다. 전자책 편집자를 위한 필독서!

클릭 편집 탬플릿 제공,

기초부터 전자책 제작 실습까지

An error occurred while parsing the CSS: %1$s.

이 오류는 CSS 파일의 코드 어딘가에 문법적인 실수나 오타가 있음을 알려주는 메시지입니다.

컴퓨터는 정해진 문법 규칙을 매우 엄격하게 따르기 때문에, 세미콜론(;) 하나가 빠지거나 괄호({})의 짝이 맞지 않는 등 사소한 실수만 있어도 코드를 이해하지 못하고 오류를 보고합니다. 📝

오류 메시지의 %1$s 부분에는 컴퓨터가 발견한 구체적인 문제에 대한 힌트가 들어있으니, 이 부분을 잘 살펴보는 것이 중요합니다.

## 흔하게 발생하는 오류 원인

다음은 CSS에서 자주 발생하는 문법 오류의 유형입니다.

세미콜론(;) 누락
- p { color: blue } (→ blue 뒤에 ;가 빠짐)
괄호({ })의 짝이 맞지 않음
- p { color: blue; (→ 닫는 괄호 }가 없음)
속성이나 값의 오타
- p { colour: blue; } (→ color를 잘못 씀)
- p { font-weight: blod; } (→ bold를 잘못 씀)
주석(/* */)을 제대로 닫지 않음
- /* 주석 시작 (→ */로 닫지 않아 뒤따르는 모든 코드가 주석으로 처리됨)

## 오류를 찾고 해결하는 방법

오류 메시지(%1$s) 확인하기 가장 먼저 %1$s에 표시된 내용을 확인하세요. "line 25에서 예기치 않은 문자 '}' 발견"과 같이 오류가 발생한 줄 번호와 문제의 원인에 대한 단서가 포함되어 있는 경우가 많습니다.
코드 편집기의 '구문 검사(Linting)' 기능 활용 (가장 추천) Visual Studio Code, Sigil, Calibre Editor 등 대부분의 최신 코드 편집기는 잘못된 코드를 자동으로 감지하여 빨간 밑줄 등으로 표시해 줍니다. 워드프로세서의 맞춤법 검사 기능과 같아서, 오류를 매우 쉽고 빠르게 찾을 수 있습니다.
온라인 CSS 검사기(Validator) 사용하기 W3C CSS Validation Service와 같은 웹사이트에 자신의 CSS 코드를 전부 복사하여 붙여넣으면, 문법적으로 잘못된 부분을 찾아 목록으로 알려줍니다.

직접 확인하기 위에서 언급한 '흔하게 발생하는 오류 원인'을 참고하여, 오류가 발생했다고 표시된 줄 번호와 그 바로 윗줄을 중심으로 코드를 꼼꼼히 살펴보세요. (세미콜론 누락은 다음 줄에서 오류로 잡히는 경우가 많습니다.)