내맘대로의 EPUBGUIDE.NET에서 편집자의 의도를 그대로 살려 전자책을 제작해 드립니다.
종이책의 편집 스타일을 최대한 유지하며, 팝업 주석 처리, 이미지 확대 축소 등 전자책의 장점을 반영하여 전자책을 제작합니다. 탬플릿을 사용하지 않고, 책 한권 한권 고유 스타일을 살리기 때문에 전자책에서도 종이책 디자인을 느낄 수 있습니다.
한국출판문화진흥원의 [텍스트형 전자책 제작 지원 사업] 선정 도서는 ‘제작 난이도별 제작비 산정 기준에 근거하여’ 제작 단가를 산정하고, 일정에 맞춰 제작을 해 드리니 많은 문의 바랍니다. 자세한 내용은 여기로: https://www.epubguide.net/notice/309오래 전 작성된 글은 현재의 Sigil 버전과 차이가 날 수 있습니다. 등록 일자를 확인 하고 1년 이상 지난 글은 변경된 내용이 있는지 확인하시기 바랍니다.
Entity is undeclared.
이 오류는 HTML/XHTML 문서에서 **정의(선언)되지 않은 '엔티티(entity)'**를 사용했음을 의미합니다.
'엔티티'는 <(<)나 >(>)처럼 코드에서 특별한 의미를 갖는 문자, 또는 키보드로 입력하기 어려운 특수문자를 표현하기 위한 일종의 약속된 코드(예: , ©)입니다.
비밀 암호를 사용하기 전에 친구에게 그 암호의 의미를 미리 알려줘야 하는 것과 같습니다. 🤫 이 오류는 문서 상단에 '이 암호는 이런 뜻이야'라고 정의하지 않은 채, 본문에서 암호(이름 기반 엔티티)를 사용했다는 의미입니다. 특히 엄격한 규칙을 따르는 EPUB 2 (XHTML 1.1)에서 매우 흔하게 발생합니다.
## 해결 방법
두 가지 해결 방법이 있으며, 첫 번째 방법을 강력히 추천합니다.
### 해결 방법 1: 숫자 코드로 대체하기 (권장)
이름으로 된 엔티티 대신, 모든 시스템에서 항상 작동하는 숫자 코드로 바꿔주는 것이 가장 안전하고 확실한 방법입니다. 숫자 코드는 미리 선언할 필요가 없습니다.
- 오류가 발생한 이름 기반 엔티티를 찾습니다.
- 해당 엔티티를 아래 표와 같이 해당하는 숫자 코드로 교체합니다.
| 이름 기반 엔티티 (오류 발생 가능) | 숫자 코드 (안전) | 설명 |
| |   | 줄바꿈 없는 공백 |
| © | © | 저작권(Copyright) 기호 © |
| — | — | 긴 대시(em-dash) — |
| ® | ® | 등록 상표(Registered) 기호 ® |
| • | • | 글머리기호 • |
### 해결 방법 2: 엔티티 직접 선언하기 (고급)
파일 상단의 DOCTYPE 선언부에 사용할 엔티티를 직접 정의하는 방법입니다. 구조가 복잡해질 수 있어 권장하지는 않습니다.
- 수정 예시 ( 를 직접 선언하는 경우):
-
XML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" [ <!ENTITY nbsp " "> ]> <html> ... </html>
'EPUB 제작의 기초 > EPUBCheck 오류' 카테고리의 다른 글
| href에서 등록되지 않은 URI 스킴(scheme) 유형이 발견되었습니다. (0) | 2025.09.29 |
|---|---|
| 엔티티를 정의하거나 대신 번호로 된 엔티티를 사용하십시오. (0) | 2025.09.29 |
| "epub" 접두사에 네임스페이스 "%1$s"은(는) 일반적이지 않습니다. (0) | 2025.09.29 |
| 제공된 DOCTYPE은 구식이거나 비정상적이므로 삭제할 수 있습니다. (0) | 2025.09.29 |
| ssml:ph 속성의 값이 비어 있거나 공백만으로 이루어져 있습니다. (0) | 2025.09.29 |