내맘대로의 EPUB 제작 가이드

EPUB을 편집하다 보면 EPUB에 포함되지 않은 리소스를 사용했다는 오류를 자주 볼 수 있습니다.

Col: 64: ERROR(RSC-007): EPUB 파일에 포함되지 않은 "OEBPS/Images/bullet_check.PNG" 리소스를 사용하였습니다.

이 오류는 EPUB 파일에 없는 이미지, 폰트, CSS 파일 등을 사용했을 때 표시되는 오류입니다.

이 오류의 원인은 EPUB안에 지정한 경로의 파일이 없을 때 생깁니다.

제일 먼저 저 파일이 있는지 확인을 해야돼요.

저 파일이 있는데 오류가 나타나기도 합니다.

** 이미지 파일을 예로 들었지만, 글꼴, html, css 등 EPUB에 포함할 수 있는 파일은 모두 동일하게 해결할 수 있습니다.

파일이 있는데 오류가 생기는 가장 많은 이유는 오타예요.

예를 들어 이미지 파일명이 "sample.jpg" 인데 이미지를 삽입 할 때 "smaple.jpg"처럼 오타를 쳐서 넣는 것이지요.

실제 파일명은 sample.jpg 인데, smaple.jpg라고 입력하면, smaple.jpg라는 이미지(리소스)가 없다고 오류가 표시됩니다.

이 오류가 표시되면 우선 오타가 있는지 확인해 보세요.

뭐, 이정도 몰라서 인터넷 검색해 여기까지 찾아온 분은 없을거예요.

파일도 있고 오타도 없는데 이 오류가 나타날 때 문제가 되지요.

두 번째로 많은 원인은 대소문자입니다.

EPUB은 대소문자를 구분해요.

sample.jpg와 sample.JPG는 같은 파일이라 생각을 하지만,

EPUB은 이 두 파일을 서로 다른 파일로 인식을 합니다.

윈도우 같은 대소문자를 구분하지 않는 운영체제에서는 대소문자 구분 안해도 이미지가 표시됩니다.

이미지 파일의 실제 이름과 상관 없이

<img alt=" sample " src="../Images/ sample.jpg "/>

이렇게 넣으나,

<img alt="sample" src="../Images/ sample.JPG "/>

이렇게 넣으나 

모두 이미지가 제대로 표시돼요.

그런데 EPUBCheck는 이미지가 제대로 표시되는 것과 상관 없이 파일명의 대소문자가 정확히 일치해야 같은 파일로 인식합니다.

EPUB의 규칙 상 sample.jpg는 sample.JPG와 다른 파일이에요.

sample.jpg를 EPUB에 넣고, sample.JPG를 다시 추가하려고 하면 "같은 파일이 있습니다."라고 Sigil이 오류메시지를 보내도

EPUBCheck는 sample.jpg와 sample.JPG를 다른 파일로 인식합니다. 

그러니 이미지 파일도 EPUB에 있고, 미리보기에서 이미지도 잘 보이는데 이런 오류가 나온다면 이미지 파일명의 대소문자를 확인해 보세요.

그 다음 원인은 파일의 정확한 위치가 잘못 되었을 때 입니다.

EPUB root 폴더에 Images 폴더를 만들고 이 폴더 안에 이미지 파일을 넣었다면 이미지 파일 위치는 아래와 같습니다.

../Images/sample.jpg

이건 Sigil의 기본 폴더 경로이기도 해요.

그런데 인디자인 같은 프로그램에서 EPUB으로 저장하면 어떨까요?

인디자인에서 EPUB으로 저장을 하면 이미지 파일의 폴더 경로가 달라져요.

image/sample.jpg

이런 식으로 EPUB을 편집한 프로그램 마다 고유의 파일 경로가 있지요.

이럴 때는 실제 파일 경로를 찾아서 넣어 줘야 합니다.

파일 경로도 대소문자를 구분하니 정확히 대소문자를 구분해 넣어줘야 합니다.

Sigil에는 실제 파일 경로를 확인할 수 있는 옵션이 있으니 이를 활용하면 됩니다.

아니면 [Sigil 표준 양식으로 재구성] 하고 편집을 해도 되지요.

이것 외에도 다른 이유가 있을지 몰라요.

어떤 이유든 이 오류가 생기는 이유는 항상 같습니다.

EPUB에 제대로 된 파일이 있가, 파일명은 실제 파일 명과 대소문자를 포함 해서 완전히 똑같은가, 그리고 그 경로가 정확한가.

이 기준만 정확히 알고 있다면 어떤 원인으로 생긴 문제든 쉽게 해결 할 수 있는 오류입니다.

EPUBCheck 오류 내용

"i" 요소는 여기에 사용할 수 없습니다 ; end-tag 요소 또는 "address", "blockquote", "del", "div", "dl", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "ins", "noscript", "ns:svg", "ol", "p", "pre", "script", "table" 또는 "ul" (with xmlns:ns="http://www.w3.org/2000/svg") 요소이(가) 예상됨 파일을 분석하는 동안 "오류"가 발견되었습니다.

Col: 10: ERROR(RSC-005): "p" 요소는 여기에 사용할 수 없습니다 ; end-tag 요소, text 또는 "a", "abbr", "acronym", "applet", "b", "bdo", "big", "br", "cite", "code", "del", "dfn", "em", "i", "iframe", "img", "ins", "kbd", "map", "noscript", "ns:svg", "object", "q", "samp", "script", "small", "span", "strong", "sub", "sup", "tt" 또는 "var" (with xmlns:ns="http://www.w3.org/2000/svg") 요소이(가) 예상됨 파일을 분석하는 동안 "오류"가 발견되었습니다.

EPUB 전자책을 편집하면서 가장 많이 보는 오류 메시지 중 하나일거예요.이 오류는 특정 태그 또는 요소를 잘못된 위치에 사용했을 때 표시됩니다.

이 오류를 이해하려면 태그의 기본 속성 중 하나인 "인라인 태그"와 "블럭 태그"에 대해 공부해야 합니다.더 정확히 이해를 하려면 HTML 구조를 이해하고, 섹션 루트, 콘텐츠 섹션, 텍스트 콘텐츠, 인라인 텍스트 등의 태그 별 구성과 역할을 알아야 하지만 간단히 "인라인 태그"와 "블럭 태그" 정도의 개념만 알아도 됩니다.

인라인과 블럭 요소는 CSS에서 콘텐츠(텍스트)를 어떻게 배치하는지를 정의하는 display 속성이지만 HTML 태그는 기본 값으로 인라인과 블럭 속성을 부여받습니다.

전자책 편집 할 때 가장 많이 쓰는 태그인 p, div, 제목 태그(h1 ~ h6) 등은 블럭 태그입니다. 블럭 태그는 새로운 행으로 시작하며 태그 하나 당 하나 씩 세로로 배치가 됩니다. 

문단 내에서 특정 글자를 꾸밀 때 사용하는 태그인 i, b, sup, sub, span 같은 태그는 인라인 태그입니다. 블럭 태그처럼 행갈이를 하지 않고 한 줄에 표시됩니다.

여기부터 중요!!!

블럭 태그는 인라인 태그를 대신해 사용 할 수 없습니다.div 같은 예외적인 태그가 있긴 하지만 p, h1 ~ h6 같은 블럭 태그는 다른 블럭 태그를 포함할 수 없고, 블럭 태그 안에 사용할 수도 없습니다.

<h1> 블럭 태그 안에 <p>다른 블럭 태그를</p> 사용할 수 없습니다.</h1>

이렇게 h1태그 안에 p태그를 쓸 수 없다는 의미입니다. 이렇게 쓰면 h1 태그 안에 p 태그가 올수 없기 때문에 아래 같은 오류가 표시됩니다.

Col: 10: ERROR(RSC-005): "p" 요소는 여기에 사용할 수 없습니다 ;

 해결 방법은 간단합니다. 

p 태그를 h1 태그 바깥으로 빼거나 p 태그를 span 같은 인라인 태그인로 수정하면 되지요.

반대로 인라인 태그는 반드시 블럭 태그 안에 포함되어야 합니다.

<i>블럭 태그 없이 인라인 태그를 사용할 수 없습니다.</i>

이렇게 블럭 태그 없이 인라인 태그를 쓰면 아래와 같은 오류가 표시됩니다.

"i" 요소는 여기에 사용할 수 없습니다

b, sup, sub 같은 인라인 태그는 모두 블럭 태그 안쪽에 사용해야 합니다.

이 오류를 수정하려면 인라인 태그 바깥쪽에 블럭태그를 감싸주면 됩니다.

<p> <i>블럭 태그 없이 인라인 태그를 사용할 수 없습니다.</i> </p>

오류 메시지 뒤에 나오는 설명은 이 오류를 수정하는 방법을 알려줍니다.

"address", "blockquote", "del", "div", "dl", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "ins", "noscript", "ns:svg", "ol", "p", "pre", "script", "table" 또는 "ul" (with xmlns:ns="http://www.w3.org/2000/svg") 요소이(가) 예상됨

<i> 태그를 감쌀 수 있는 블럭 태그 목록이에요.

p 뿐 아니라 address, blockquote, div, h1 ~ h6 등의 요소가 i 태그를 사용할 때 필요하다는 의미지요.