EPUB 제작의 기초/EPUBCheck 오류
"region-based" 속성은 데이터 내비게이션 문서의 nav 요소에서만 허용됩니다.
내.맘.대.로
2025. 10. 2. 09:24
The property "region-based" is only allowed on nav elements in Data Navigation Documents.
이 오류는 만화책, 복잡한 다이어그램 등 한 페이지 내의 특정 **'영역(region)'**을 순서대로 보여주는 특수한 내비게이션 기능과 관련된 고급 문제입니다.
epub:type="region-based" 속성은 바로 이 '영역 기반 내비게이션'을 정의할 때 사용하며, EPUB 표준은 이 속성을 두 가지 조건 하에서만 사용하도록 엄격히 제한합니다.
- 반드시 <nav> 요소 안에서만 사용해야 합니다.
- 반드시 **'데이터 내비게이션 문서'**라는 특별한 종류의 파일 안에서만 사용해야 합니다.
이 오류는 위 두 가지 규칙 중 하나 또는 둘 다를 어겼을 때 발생합니다.
## 해결 방법
이 문제를 해결하는 방법은 이 기능을 의도적으로 사용했는지 여부에 따라 달라집니다.
### 경우 1: 만화책과 같은 특수 내비게이션을 만들지 않는 경우 (대부분 여기에 해당)
일반적인 소설이나 에세이 등 텍스트 위주의 책을 만들고 있다면, 이 속성은 필요 없습니다. 아마도 템플릿이나 예제 코드를 복사하는 과정에서 실수로 포함되었을 가능성이 높습니다.
- 해결책: HTML/XHTML 파일을 열어 epub:type="region-based" 속성을 찾아서 그 속성 자체를 완전히 삭제하세요.
- 수정 예시:▼
-
HTML
<ol> ... </ol>
-
HTML
<ol epub:type="region-based"> ... </ol>
### 경우 2: 의도적으로 영역 기반 내비게이션을 만드는 경우 (고급)
만화책의 컷(panel)을 순서대로 보여주는 등의 기능을 구현하려는 의도가 있었다면, epub:type="region-based" 속성이 <nav> 요소에 올바르게 적용되었는지, 그리고 해당 코드가 일반 본문 파일이 아닌 별도의 '데이터 내비게이션 문서'에 작성되었는지 확인해야 합니다. 이는 EPUB의 고급 제작 기술에 해당합니다.
반응형