"%1$s" 요소는 사용해서는 안 됩니다 (사용이 권장되지 않는 구문).

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 10. 2. 09:27

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

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

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

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

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

The "" element should not be used (discouraged construct)

 

이 메시지는 HTML 코드에 현재는 사용이 권장되지 않는 **'구식(deprecated)' HTML 태그(%1$s)**가 포함되어 있다는 경고입니다.

오래된 스마트폰 모델을 생각하면 쉽습니다. 📱 제조사에서 더 좋은 성능의 새 모델을 출시하면서 이전 모델을 단종시키고 더 이상 지원하지 않기로 하는 것과 같습니다. 이전 모델이 당장 작동은 하지만, 앞으로 호환성이나 기능 면에서 문제가 생길 수 있으므로 새 모델을 사용하는 것이 권장됩니다.

HTML 태그도 마찬가지입니다. 웹 표준이 발전하면서 일부 오래된 태그들은 더 좋고 효율적인 CSS 스타일링 방식으로 대체되었습니다.

## 왜 일부 태그의 사용이 권장되지 않나요?

현대적인 웹 표준의 핵심 원칙은 **'구조와 표현의 분리'**입니다.

  • HTML: 문서의 구조를 나타냅니다. (예: 이것은 '제목'이다 <h1>, 이것은 '문단'이다 <p>)
  • CSS: 문서의 표현을 담당합니다. (예: 글자는 '빨간색'이고 '가운데 정렬'이다)

사용이 권장되지 않는 태그들(예: <center>, <font>)은 이러한 원칙을 어기고, 구조를 나타내는 HTML 코드 안에서 직접적으로 표현(디자인)을 제어하기 때문에 더 이상 사용하지 않는 것이 좋습니다.

## 해결 방법: CSS로 대체하기

해결책은 구식 태그를 제거하고, 그 기능을 CSS 클래스로 대체하는 것입니다.

  1. 경고 메시지에 나온 구식 태그(%1$s)를 HTML 문서에서 찾습니다.
  2. 해당 태그를 제거하고, 대신 일반적인 태그(예: <p>, <div>)에 식별 가능한 class 이름을 붙여줍니다.
  3. CSS 파일에서 해당 class에 원하는 스타일을 지정합니다.

### 수정 예시 (<center> 태그)

  • 수정 전 (경고 발생 예시):
  • HTML
     
    <center>이 텍스트를 가운데로 정렬합니다.</center>
  • 수정 후 (올바른 코드): ✅
    1. HTML 파일 수정:
    2. HTML
       
      <p class="center-align">이 텍스트를 가운데로 정렬합니다.</p>
    3. CSS 파일에 스타일 추가:
    4. CSS
       
      .center-align {
  text-align: center;
}

### 자주 사용되는 구식 태그와 CSS 대체 속성

구식 태그 (Deprecated) 현대적인 CSS 대체 방법
<center> text-align: center;
<font color="..." size="..."> color: ...; , font-size: ...;
<u> text-decoration: underline;
<b> font-weight: bold; (또는 의미상 <strong> 태그 사용)
<i> font-style: italic; (또는 의미상 <em> 태그 사용)
반응형
저작자표시 비영리 변경금지 (새창열림)

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

뷰포트 "%1$s" 값은 양수 또는 키워드 "device-%1$s"이어야 합니다.  (0) 2025.10.02
뷰포트 메타데이터에 "%1$s" 폭, 높이 속성이 없습니다 ("width"와 "height" 속성 모두 필요합니다).  (0) 2025.10.02
사용자 정의 속성 네임스페이스("%1$s")는 도메인에 문자열 "%2$s"를 포함해서는 안 됩니다.  (0) 2025.10.02
"region-based" 속성은 데이터 내비게이션 문서의 nav 요소에서만 허용됩니다.  (0) 2025.10.02
Microdata 시맨틱 강화(enrichments)는 발견했지만 RDFa는 없습니다. EDUPUB은 RDFa Lite 사용을 권장합니다.  (0) 2025.10.02

사용자 정의 속성 네임스페이스("%1$s")는 도메인에 문자열 "%2$s"를 포함해서는 안 됩니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 10. 2. 09:25

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

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

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

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

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

Custom attribute namespace ("%1$s") must not include the string "%2$s" in its domain.

 

이 오류는 EPUB에서 사용자 정의 속성을 만들기 위해 선언한 네임스페이스(namespace) URI에 문제가 있음을 의미하는 고급 오류입니다.

쉽게 말해, 자신만의 특별한 속성을 만들기 위해 '신분증'과 같은 고유 주소(네임스페이스 URI)를 만들었는데, 그 주소의 도메인 이름에 EPUB이나 웹 표준을 관장하는 공식 기관의 이름(예: idpf.org, w3.org)을 무단으로 사용했다는 뜻입니다.

자신만의 회사를 설립하면서 '삼성전자 공식 파트너'나 '구글 버거 가게'처럼 다른 공식 기관의 이름을 회사 이름에 넣어 사람들을 혼란스럽게 해서는 안 되는 것과 같은 이치입니다. 🏢

## 규칙

사용자가 직접 만드는 네임스페이스 URI의 도메인 이름에는 EPUB이나 관련 표준 기관의 소유로 오해받을 수 있는 다음과 같은 예약된 문자열을 포함할 수 없습니다.

  • idpf.org
  • w3.org
  • daisy.org
  • 등 기타 공식 기관의 도메인

## 해결 방법

해결책은 자신이 만든 네임스페이스 URI를 공식 기관의 이름이 포함되지 않은, 자신이 제어할 수 있는 고유한 주소로 변경하는 것입니다.

  1. 오류가 발생한 XHTML 파일을 엽니다.
  2. 파일 상단의 <html> 태그에서 사용자가 직접 추가한 네임스페이스 선언(예: xmlns:myprefix="...")을 찾습니다.
  3. 따옴표 안의 잘못된 URI 주소(%1$s)를 자신이 소유한 도메인 주소나, 오해의 소지가 없는 다른 고유한 주소로 변경합니다. (주소가 실제로 인터넷에 존재할 필요는 없으며, 고유 식별자로만 사용됩니다.)

### 수정 예시

  • 수정 전 (오류 예시 - idpf라는 예약어를 사용):
  • XML
     
    <html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:mycorp="http://www.my-idpf-vocab.com/terms/">
  • 수정 후 (올바른 코드): ✅
  • XML
     
    <html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:mycorp="http://www.my-ebook-corp.com/terms/">
반응형
저작자표시 비영리 변경금지 (새창열림)

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

뷰포트 메타데이터에 "%1$s" 폭, 높이 속성이 없습니다 ("width"와 "height" 속성 모두 필요합니다).  (0) 2025.10.02
"%1$s" 요소는 사용해서는 안 됩니다 (사용이 권장되지 않는 구문).  (0) 2025.10.02
"region-based" 속성은 데이터 내비게이션 문서의 nav 요소에서만 허용됩니다.  (0) 2025.10.02
Microdata 시맨틱 강화(enrichments)는 발견했지만 RDFa는 없습니다. EDUPUB은 RDFa Lite 사용을 권장합니다.  (0) 2025.10.02
SVG 고정 레이아웃 문서에는 "viewBox" 속성이 있어야 합니다 (가장 바깥쪽 "svg" 요소에).  (0) 2025.10.02

"region-based" 속성은 데이터 내비게이션 문서의 nav 요소에서만 허용됩니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 10. 2. 09:24

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

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

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

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

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

The property "region-based" is only allowed on nav elements in Data Navigation Documents.

 

이 오류는 만화책, 복잡한 다이어그램 등 한 페이지 내의 특정 **'영역(region)'**을 순서대로 보여주는 특수한 내비게이션 기능과 관련된 고급 문제입니다.

epub:type="region-based" 속성은 바로 이 '영역 기반 내비게이션'을 정의할 때 사용하며, EPUB 표준은 이 속성을 두 가지 조건 하에서만 사용하도록 엄격히 제한합니다.

  1. 반드시 <nav> 요소 안에서만 사용해야 합니다.
  2. 반드시 **'데이터 내비게이션 문서'**라는 특별한 종류의 파일 안에서만 사용해야 합니다.

이 오류는 위 두 가지 규칙 중 하나 또는 둘 다를 어겼을 때 발생합니다.

## 해결 방법

이 문제를 해결하는 방법은 이 기능을 의도적으로 사용했는지 여부에 따라 달라집니다.

### 경우 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의 고급 제작 기술에 해당합니다.

반응형
저작자표시 비영리 변경금지 (새창열림)

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

"%1$s" 요소는 사용해서는 안 됩니다 (사용이 권장되지 않는 구문).  (0) 2025.10.02
사용자 정의 속성 네임스페이스("%1$s")는 도메인에 문자열 "%2$s"를 포함해서는 안 됩니다.  (0) 2025.10.02
Microdata 시맨틱 강화(enrichments)는 발견했지만 RDFa는 없습니다. EDUPUB은 RDFa Lite 사용을 권장합니다.  (0) 2025.10.02
SVG 고정 레이아웃 문서에는 "viewBox" 속성이 있어야 합니다 (가장 바깥쪽 "svg" 요소에).  (0) 2025.10.02
뷰포트 메타데이터 "%1$s"에 구문 오류가 있습니다.  (0) 2025.10.02

Microdata 시맨틱 강화(enrichments)는 발견했지만 RDFa는 없습니다. EDUPUB은 RDFa Lite 사용을 권장합니다.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 10. 2. 09:23

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

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

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

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

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

Found Microdata semantic enrichments but no RDFa. EDUPUB recommends using RDFa Lite.

 

이 메시지는 수정이 필요한 오류가 아니라, EDUPUB이라는 교육용 전자책 표준에 특화된 고급 권장 사항입니다.

쉽게 말해, 문서의 의미를 기계가 더 잘 이해하도록 돕는 '시맨틱 강화' 주석을 추가했는데, EDUPUB 표준이 권장하는 RDFa Lite 방식이 아닌 Microdata 방식을 사용했다는 뜻입니다.

특정 학술지에 논문을 제출하는데, 그 학술지(EDUPUB)는 논문 인용 방식을 'APA 스타일(RDFa Lite)'로 통일하기로 약속했습니다. 📝 이 메시지는 편집자가 "당신은 'MLA 스타일(Microdata)'로 인용했는데, 우리 학술지는 'APA 스타일'을 권장합니다"라고 알려주는 것과 같습니다. MLA 스타일 자체는 유효하지만, 해당 학술지의 규칙과는 다른 것입니다.

## 어떻게 해야 하나요?

이 메시지에 대한 조치는 만들고 있는 책의 목적에 따라 달라집니다.

### 경우 1: 일반적인 전자책(소설, 에세이 등)을 만드는 경우

이 메시지를 안전하게 무시하셔도 됩니다.

Microdata는 웹에서 널리 사용되는 유효한 시맨틱 마크업 방식입니다. 만들고 있는 책이 EDUPUB 표준을 반드시 따라야 하는 교육용 교재가 아니라면, 이 권장 사항을 따를 필요가 없습니다.

### 경우 2: EDUPUB 표준의 교육용 교재를 만드는 경우

권장 사항에 따라 Microdata를 RDFa Lite로 수정해야 합니다.

EDUPUB 표준을 완벽하게 준수해야 한다면, Microdata 구문을 RDFa Lite 구문으로 변경해야 합니다. 두 방식은 사용하는 속성의 이름이 조금 다릅니다.

## Microdata와 RDFa Lite 구문 비교 예시

  • Microdata 사용 예시:
  • HTML
     
    <div itemscope itemtype="http://schema.org/Book">
  <span itemprop="name">EPUB 3 Best Practices</span>
  by <span itemprop="author">Matt Garrish</span>.
</div>
  • RDFa Lite 사용 예시: ✅
  • HTML
     
    <div vocab="http://schema.org/" typeof="Book">
  <span property="name">EPUB 3 Best Practices</span>
  by <span property="author">Matt Garrish</span>.
</div>
반응형
저작자표시 비영리 변경금지 (새창열림)

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

사용자 정의 속성 네임스페이스("%1$s")는 도메인에 문자열 "%2$s"를 포함해서는 안 됩니다.  (0) 2025.10.02
"region-based" 속성은 데이터 내비게이션 문서의 nav 요소에서만 허용됩니다.  (0) 2025.10.02
SVG 고정 레이아웃 문서에는 "viewBox" 속성이 있어야 합니다 (가장 바깥쪽 "svg" 요소에).  (0) 2025.10.02
뷰포트 메타데이터 "%1$s"에 구문 오류가 있습니다.  (0) 2025.10.02
고정 레이아웃 문서에 'viewport' 메타 요소가 없습니다.  (0) 2025.10.02

티스토리툴바