내맘대로의 EPUB 제작 가이드

CSS에 (오류: ...)에 해당하는 오류가 있을 때 표시됩니다.

(오류: ...) 내용은 CSS의 오류 종류에 따라 달라집니다.

이 오류가 표시되는 이유의 90%는 오타입니다.

수업이나 블로그 통해 이 오류 문의를 가끔 받는데, 지금까지 모두 오타 때문에 생긴 오류였습니다.

이런 오류가 보인다면 해당 부분 또는 앞뒤에 오타가 있는지 확인하시기 바랍니다.

이 오류는 EPUB에서 사용할 수 없는 HTML 태그를 사용했을 때 표시됩니다.

Col: 10: ERROR(RSC-005): "ruby" 요소는 어디에도 사용할 수 없습니다.; 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") 요소이(가) 예상됨 파일을 분석하는 동안 "오류"가 발견되었습니다.

ruby, aside, mark, header, footer, section 같은 태그를 EPUB2.0 버전에서 사용했을 때 이런 오류가 표시됩니다.

HTML5.0 이후 버전에서 추가된 태그를 EPUB2에서 사용할 때 이런 오류가 표시될 가능성이 높습니다.

u 태그는 구 버전에서 밑줄(underline)을 표시하기 위해 사용하였으나 HTML5.0 이후 버전에서 비텍스트 주석(non-textual annotation) 처리를 위한 태그로 변경되었고, 더 이상 밑줄을 긋기 위한 태그로 사용하지 않습니다. 그래서 EPUB2에서는 u 태그를 사용하면 이 오류가 표시됩니다.

이 오류를 해결하려면 EPUB에서 사용할 수 없는 html 태그를 파악하고 사용을 피해야합니다.

EPUB2에서 이런 오류가 자주 발생을 하기 때문에 아래와 같은 태그는 EPUB2 편집을 할 때 사용을 하지 않아야 합니다.

● ruby: 루비 문자를 표현하는 데 사용됩니다. (예: 한자 위에 발음을 표기)
● mark: 텍스트의 특정 부분을 강조하는 데 사용됩니다.
● section, footer, header: 문서의 구조를 나타내는 데 사용됩니다.
● aside: 본문 내용과 관련된 추가 정보를 제공하는 데 사용됩니다.
● figure: 이미지, 다이어그램 등을 포함하는 데 사용됩니다.

EPUBCheck는 오류 내용에 이 태그 대산 사용할 수 있는 태그 목록을 보여줍니다.

"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"

이 태그는 모두 EPUB3에서 사용 할 수 있습니다.

따라서 이 태그를 반드시 사용해야 한다면 EPUB3로 제작을 해야합니다.

이 중 몇몇 태그는 국내 주요 유통사(교보문고, 예스24, 알라딘, 리디북스)에서 EPUB2에 사용할 수 있도록 하고 있습니다.

EPUBCheck에서 오류가 나면 유통사에 등록을 할 수 없으나 ruby, aside 등 일부 태그에 한해서 등록을 허용합니다.

유통사 별로 이용 가능한 태그 목록은 유통사 담당자에게 확인하시기 바랍니다.

이 오류는 링크 또는 링크 기능을 이용한 주석/팝업 주석을 편집할 때 종종 볼 수 있습니다.

이 오류가 생기는 이유는 ID와 관련되어 있습니다.

ID 오류와 함께 생기는 경우가 많으니 이 글도 참고하세요.

https://www.epubguide.net/574

이 오류를 제대로 해결하려면 프래그먼트 식별자가 무엇인지 알아야합니다.

EPUB에서 말하는 프래그먼트 식별자는 웹주소 또는 링크에서 사용하는 식별자를 의미합니다.

웹 주소(URL)에서 # 기호 뒤에 오는 부분을 프래그먼트 식별자라고 합니다. 마치 책의 목차에서 특정 페이지를 가리키는 쪽번호처럼, 웹 페이지 내의 특정 위치를 가리키는 역할을 합니다.

https://example.com/page#FragmentID

EPUB에서 주석 링크를 연결하거나 특정 페이지를 참조하도록 링크를 연결할 때 Fragment 식별자를 이용하지요.

오류 메시지를 잘 읽어보면 왜 오류가 생겼는지 알 수 있습니다.

Col: 26: ERROR(RSC-012): Fragment 식별자가 정의되지 않았습니다.

식별자가 정의되지 않았다는 것은, 식별자에 사용한 ID를 찾을 수 없다는 의미입니다. 식별자는 사용했는데 ID가 없으니 정의되지 않았다고 오류메시지를 표시하는것이지요.

Fragment 식별자를 사용하려면 본문의 특정 위치를 가리키는 ID가 있어야합니다. 본문 내 주석 번호라면 이 번호가 가리키는 주석 설명에 ID가 반드시 있어야합니다. 그래야 링크를 클릭할 때 그 위치로 넘어가겠지요?

ID가 없으면 EPUBCheck는 Fragment 식별자가 정의되지 않았다는 오류메시지를 표시합니다.

오류가 생겼다면 ID가 없거나, ID 이름에 오타가 있거나 둘 중 하나입니다.

ID도 대소문자를 구분하기 때문에 footnoteID01과 footnoteid01은 서로 다른 식별자입니다.

<p>...<a href="#footnoteid01">1)</a>...</p>

...

<p class="footnoteID01">...</p>

이렇게 대소문자를 틀리게 입력해도 EPUBCheck는 식별자가 정의됮 않았다고 메시지를 보냅니다.

링크 파일 경로를 잘못 지정해도 이런 오류가 생길 수 있으니 파일 경로, ID 이름이 정확한지 확인해 보시기 바랍니다.

이 오류는 추가 설명이 필요 없습니다.

오류 메시지만 읽어 봐도 문제의 원인과 해결 방법을 쉽게 알 수 있습니다.

Col: -1: WARNING(PKG-010): 파일명 "***"에 공백이 포함되어 있습니다. 구형 판독 시스템과 상호 운용성 문제가 발생할 수 있습니다.

EPUB에 포함된 파일 명에 공백이 포함되어 있을 때 표시되는 오류입니다.

file name.jpg

file name.xhtml

file name.otf

이렇게 파일 명 중간에 공백이 있으면 오류가 표시됩니다.

EPUB은 파일 명 사이에 공백을 허용하지 않습니다.

해결 방법은 설명 안해도 되겠지요?

링크(팝업) 주석, 또는 내부 링크를 연결한 책에서 이런 오류가 생길 수 있습니다.

인디자인 같은 조판 프로그램에서 EPUB으로 추출한 후 파일을 합치거나 해도 이런 오류가 생길 수 있지요.

Col: 18: ERROR(RSC-005): Duplicate "IDname" 파일을 분석하는 동안 "오류"가 발견되었습니다.

이 오류는 HTML의 ID 생성 규칙을 알아야 해결 할 수 있습니다.

ID는 프래그먼트 식별자를 이용해 다른 위치를 가리키기 위한 고유 식별자입니다.

말이 어렵지요?

프래그먼트 식별자는 URL 또는 소스의 경로(파일 위치 표시할 때 src="../path/file.xhtml"로 쓰는)를 지정할 때 사용하는 규칙이에요. html 파일은 수백 줄 이상 내용이 들어갈 때가 많습니다. 링크를 걸면서 특정 위치, 예를 들어 특정 소제목이나 본문 중간 어디쯤에 있는 단어나 이미지를 가리키고 싶을 때 쓰는 것이지요.

홈페이지 주소라면 이렇게 표시합니다.

https://example.com/content.html#fragmentID

EPUB에서 내부 링크를 걸었다면 이렇게 되지요.

<a href="../Content/Conteht.xhtml#fragmentID">

경로 뒤에 붙은 #fragmentID를 프래그먼트 식별자라고 합니다.

그리고 프래그먼트 식별자가 가리키는 곳에 고유 식별자, ID가 있습니다.

'고유'란 단어의 뜻을 아시지요? 국어시간이 아니니 설명은 넘어가고...

고유식별자는 HTML 태그에 id="fragmentID" 처럼 붙입니다.

<p id="fragmentID ">.....</p>

만약 content.xhtml 파일에 fragmentID가 두개라면 어떻게 될까요?

<p id="fragmentID">여기에 링크를 걸어야 합니다.</p>

....

<p>id="fragmentID">여기에도 링크를 걸어야 합니다.</p>

이렇게 되어 있다면 <a href="../Content/Conteht.xhtml#fragmentID">이 링크는 어디로 이동할까요?

같은 파일 안에 동일한 ID가 두개 이상 있을 경우 링크로 연결을 할 수 없습니다. 둘 중 어디를 가리키는지 확인할 수 없으니까요.

그래서 같은 파일 안에 ID 이름은 반드시 하나만 존재해야 합니다.

fragmentID01, fragmentID02, fragmentID03...이렇게요.

그런데 편집을 하다 몇 번까지 만들었는지 잊고 같은 ID를 썼다면

fragmentID01, fragmentID02, fragmentID03, fragmentID03, fragmentID04

EPUBCheck가

Duplicate "fragmentID03" 파일을 분석하는 동안 "오류"가 발견되었습니다.

Duplicate "fragmentID03" 파일을 분석하는 동안 "오류"가 발견되었습니다.

라는 오류를 표시합니다.

이 오류는 항상 2개 이상 표시가 됩니다. fragmentID03이 최소 2개가 있는데 둘 중 어느 ID가 제대로 된 값인지 EPUBCheck는 알 수 없거든요. 그래서 두개(혹은 그 이상) 위치를 모두 오류메시지에 표시를 합니다. 

수정 방법은 간단합니다. ID 이름을 바꾸면 돼요.

단, ID 이름을 바꾼 후 프래그먼트 식별자의 ID도 함께 수정을 해 줘야돼요.

그렇지 않으면 Col: 37: ERROR(RSC-012): Fragment 식별자가 정의되지 않았습니다.라는 오류가 표시되거든요.이 오류는 다음 글에서 설명하겠습니다.

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

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