서로 충돌하는 대체 스타일 태그가 발견되었습니다: %1$s.

EPUB 제작의 기초/EPUBCheck 오류
posted by 내.맘.대.로 2025. 9. 25. 08:45

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

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

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

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

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

Conflicting alternate style tags found: %1$s.

 

이 오류는 HTML 문서의 <head> 섹션에서 대체 스타일시트를 설정하는 방식에 논리적인 충돌이 있음을 의미합니다.

## 대체 스타일시트란?

대체 스타일시트는 독자에게 여러 가지 디자인 테마(예: '낮 모드', '밤 모드', '세피아 모드')를 선택할 수 있도록 제공하는 고급 기능입니다. 🎨 독자는 뷰어의 설정을 통해 선호하는 스타일을 고를 수 있습니다.

이 오류는 이 '테마 선택지'를 제공하는 규칙에 문제가 생겼다는 뜻입니다.

## 충돌이 발생하는 원인

가장 흔한 원인은 '기본 테마'로 설정된 스타일시트가 두 개 이상이기 때문입니다.

  • rel="stylesheet"와 title="테마이름"을 모두 가진 <link> 태그는 '기본 테마(Preferred Style)'로 간주됩니다.
  • 규칙상 '기본 테마'는 단 하나만 존재해야 합니다.

책의 기본 표지가 두 종류일 수 없는 것처럼, 기본 테마가 여러 개이면 뷰어는 어떤 것을 먼저 보여줘야 할지 혼란에 빠집니다.

## 해결 방법

  1. 오류가 발생한 HTML/XHTML 파일을 엽니다.
  2. <head> 섹션 안에서 CSS 파일을 연결하는 모든 <link> 태그를 찾습니다.
  3. rel="stylesheet"와 title="..." 속성을 동시에 가지고 있는 <link> 태그가 여러 개 있는지 확인합니다.
  4. 그 중 하나만 남기고, 나머지는 rel="stylesheet"를 rel="alternate stylesheet"로 변경하여 '대체 테마'로 지정합니다.

### 수정 예시

  • 오류가 발생하는 코드:➡️ title이 있는 rel="stylesheet"가 두 개이므로 어떤 것이 기본값인지 알 수 없어 충돌이 발생합니다.
  • HTML
     
    <head>
  ...
  <link rel="stylesheet" href="day.css" title="밝은 테마">
  <link rel="stylesheet" href="night.css" title="어두운 테마">
  ...
</head>
  • 올바르게 수정한 코드: ✅➡️ '밝은 테마'를 기본값으로 두고, '어두운 테마'는 선택 가능한 '대체' 스타일로 변경하여 충돌을 해결했습니다.
  • HTML
     
    <head>
  ...
  <link rel="stylesheet" href="day.css" title="밝은 테마">
  <link rel="alternate stylesheet" href="night.css" title="어두운 테마">
  ...
</head>
반응형
저작자표시 비영리 변경금지 (새창열림)

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

@font-face 참조 "%1$s"이(가) 비표준 글꼴 유형 "%2$s"을(를) 참조합니다.  (0) 2025.09.25
CSS 선택자가 고정된 위치(fixed position)를 지정합니다.  (0) 2025.09.25
CSS 문서는 UTF-8로 인코딩해야 합니다, %1$s 인코딩이 감지되었습니다;  (0) 2025.09.24
CSS 문서가 UTF-16으로 인코딩되었습니다. 반드시 UTF-8으로 인코딩해야 합니다.  (0) 2025.09.24
비어 있거나 NULL인 참조가 발견되었습니다.  (0) 2025.09.24

티스토리툴바